feat: migrate to OpenAI Responses API

Replace Chat Completions API with Responses API across all adapters:
- Update endpoint paths to use `/responses` instead of `/chat/completions`
- Simplify request/response handling with new API format
- Update model defaults to GPT-5 series (`gpt-5-mini`, `gpt-5-nano`)
- Add formatting instructions to prevent quotation marks in translations
- Improve error handling and stream processing
- Update documentation for Azure OpenAI and OpenAI Compatible endpoints

Author: liby

docs/configuration_manual_CN.md

@@ -31,17 +31,27 @@
     https://api.openai.com
     ```
 
-  - OpenAI Compatible：必填，需填入完整的 API URL，例如使用 Cloudflare AI Gateway 时，填入：
+  - OpenAI Compatible：必填，需填入完整的 API URL。目前仅支持 Responses API 端点（以 `/responses` 结尾）：
 
     ```
-    https://gateway.ai.cloudflare.com/v1/CLOUDFLARE_ACCOUNT_ID/GATEWAY_ID/openai/chat/completions
+    https://gateway.ai.cloudflare.com/v1/CLOUDFLARE_ACCOUNT_ID/GATEWAY_ID/openai/responses
     ```
 
-  - Azure OpenAI：必填，需填入完整的 API URL，格式为：
+    注：本插件目前仅支持使用 Responses API 的 OpenAI 兼容服务
 
+  - Azure OpenAI：必填，需填入完整的 API URL。目前仅支持 Responses API，支持以下两种格式：
+
+    带部署名称：
+    ```
+    https://RESOURCE_NAME.openai.azure.com/openai/deployments/DEPLOYMENT_NAME/responses?api-version=preview
     ```
-    https://RESOURCE_NAME.openai.azure.com/openai/deployments/DEPLOYMENT_NAME/chat/completions?api-version=API_VERSION
+
+    基础端点（模型在请求体中指定）：
     ```
+    https://RESOURCE_NAME.openai.azure.com/openai/v1/responses?api-version=preview
+    ```
+
+    注：本插件目前仅支持 Azure OpenAI 的 Responses API，需使用 preview API 版本
 
   - Google Gemini：可选，默认为：
 

docs/configuration_manual_EN.md

@@ -30,17 +30,27 @@
     https://api.openai.com
     ```
 
-  - OpenAI Compatible: Required, complete API URL, for example when using Cloudflare AI Gateway:
+  - OpenAI Compatible: Required, complete API URL. Currently only supports Responses API endpoint (ending with `/responses`):
 
     ```
-    https://gateway.ai.cloudflare.com/v1/CLOUDFLARE_ACCOUNT_ID/GATEWAY_ID/openai/chat/completions
+    https://gateway.ai.cloudflare.com/v1/CLOUDFLARE_ACCOUNT_ID/GATEWAY_ID/openai/responses
     ```
 
-  - Azure OpenAI: Required, complete API URL in format:
+    Note: This plugin currently only supports OpenAI compatible services that use the Responses API
 
+  - Azure OpenAI: Required, complete API URL. Currently only supports Responses API with the following two formats:
+
+    With deployment name:
+    ```
+    https://RESOURCE_NAME.openai.azure.com/openai/deployments/DEPLOYMENT_NAME/responses?api-version=preview
     ```
-    https://RESOURCE_NAME.openai.azure.com/openai/deployments/DEPLOYMENT_NAME/chat/completions?api-version=API_VERSION
+
+    Base endpoint (model specified in request body):
     ```
+    https://RESOURCE_NAME.openai.azure.com/openai/v1/responses?api-version=preview
+    ```
+
+    Note: This plugin currently only supports Azure OpenAI's Responses API with preview API version
 
   - Google Gemini: Optional, default value:
 

package.json

@@ -12,7 +12,8 @@
   ],
   "homepage": "https://github.com/openai-translator/bob-plugin-openai-translator",
   "scripts": {
-    "build": "rollup --config rollup.config.ts --configPlugin typescript"
+    "build": "rollup --config rollup.config.ts --configPlugin typescript",
+    "build:test": "node scripts/build-test.mjs"
   },
   "devDependencies": {
     "@bob-translate/types": "1.1.0",

public/info.json

@@ -33,7 +33,7 @@
       "type": "menu"
     },
     {
-      "desc": "OpenAI: https://api.openai.com\n\nOpenAI Compatible: 完整的 API 地址，例如：https://gateway.ai.cloudflare.com/v1/CF_ACCOUNT_ID/GATEWAY_ID/openai/chat/completions\n\nAzure OpenAI: https://RESOURCE_NAME.openai.azure.com/openai/deployments/DEPLOYMENT_NAME/chat/completions?api-version=API_VERSION\n\nGoogle Gemini: https://generativelanguage.googleapis.com/v1beta/models",
+      "desc": "OpenAI: https://api.openai.com\n\nOpenAI Compatible: 完整的 API 地址，例如：https://gateway.ai.cloudflare.com/v1/CF_ACCOUNT_ID/GATEWAY_ID/openai/responses\n\nAzure OpenAI: https://RESOURCE_NAME.openai.azure.com/openai/deployments/DEPLOYMENT_NAME/responses?api-version=preview\n\nGoogle Gemini: https://generativelanguage.googleapis.com/v1beta/models",
       "identifier": "apiUrl",
       "textConfig": {
         "height": "55",
@@ -55,40 +55,32 @@
       "type": "text"
     },
     {
-      "defaultValue": "gpt-4.1-nano",
+      "defaultValue": "gpt-5-mini",
       "identifier": "model",
       "menuValues": [
         {
           "title": "Custom",
           "value": "custom"
         },
         {
-          "title": "GPT-4.1",
-          "value": "gpt-4.1"
+          "title": "GPT-5 mini",
+          "value": "gpt-5-mini"
         },
         {
-          "title": "GPT-4.1 mini",
-          "value": "gpt-4.1-mini"
-        },
-        {
-          "title": "GPT-4.1 nano",
-          "value": "gpt-4.1-nano"
+          "title": "GPT-5 nano",
+          "value": "gpt-5-nano"
         },
         {
-          "title": "GPT-4o",
-          "value": "gpt-4o"
-        },
-        {
-          "title": "o4-mini",
-          "value": "o4-mini"
+          "title": "GPT-4.1 mini",
+          "value": "gpt-4.1-mini"
         },
         {
-          "title": "Gemini 2.5 Pro Preview 03-25",
-          "value": "gemini-2.5-pro-preview-03-25"
+          "title": "Gemini 2.5 Flash",
+          "value": "gemini-2.5-flash"
         },
         {
-          "title": "Gemini 2.5 Flash Preview 04-17",
-          "value": "gemini-2.5-flash-preview-04-17"
+          "title": "Gemini 2.5 Flash-Lite",
+          "value": "gemini-2.5-flash-lite"
         }
       ],
       "title": "模型",
@@ -98,7 +90,7 @@
       "desc": "可选项。当 Model 选择 Custom 时，此项为必填项。请填写有效的模型名称",
       "identifier": "customModel",
       "textConfig": {
-        "placeholderText": "gpt-4.1-nano",
+        "placeholderText": "gpt-5-nano",
         "type": "visible"
       },
       "title": "自定义模型",
@@ -156,7 +148,7 @@
     },
     {
       "defaultValue": "0.2",
-      "desc": "可选项。温度值越高，生成的文本越随机。默认值为 0.2",
+      "desc": "可选项。温度值越高，生成的文本越随机。默认值为 0.2。GPT-5 系列模型必须设置为 1",
       "identifier": "temperature",
       "textConfig": {
         "placeholderText": "0.2",
@@ -168,4 +160,4 @@
   ],
   "summary": "AI powered translator",
   "version": "3.3.2"
-}
+}

scripts/build-test.mjs

@@ -0,0 +1,47 @@
+#!/usr/bin/env node
+
+import fs from 'fs';
+import path from 'path';
+import { execSync } from 'child_process';
+import { fileURLToPath } from 'url';
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const infoPath = path.join(__dirname, '..', 'public', 'info.json');
+const distPath = path.join(__dirname, '..', 'dist');
+
+// Read and save original version
+const originalInfo = JSON.parse(fs.readFileSync(infoPath, 'utf8'));
+const originalVersion = originalInfo.version;
+
+console.log(`Original version: ${originalVersion}`);
+
+try {
+  // Update version to 9.9.9
+  const testInfo = { ...originalInfo, version: '9.9.9' };
+  fs.writeFileSync(infoPath, JSON.stringify(testInfo, null, 2) + '\n');
+  console.log('Version updated to 9.9.9 for testing');
+
+  // Build the plugin
+  console.log('Building plugin...');
+  execSync('pnpm build', { stdio: 'inherit', cwd: path.join(__dirname, '..') });
+
+  // Create test package
+  console.log('Creating test package...');
+  execSync('zip -j -r openai-translator-test.bobplugin ./*', {
+    stdio: 'inherit',
+    cwd: distPath
+  });
+
+  console.log('Test build complete!');
+  
+  // Open dist folder
+  console.log('Opening dist folder...');
+  execSync(`open ${distPath}`);
+
+} finally {
+  // Always restore original version
+  const currentInfo = JSON.parse(fs.readFileSync(infoPath, 'utf8'));
+  currentInfo.version = originalVersion;
+  fs.writeFileSync(infoPath, JSON.stringify(currentInfo, null, 2) + '\n');
+  console.log(`Version restored to ${originalVersion}`);
+}

src/adapter/azure-openai.ts

@@ -1,6 +1,5 @@
 import { ServiceError, ValidationCompletion } from "@bob-translate/types";
 import { handleValidateError } from "../utils";
-import { OpenAiChatCompletion } from "../types";
 import { OpenAiAdapter } from "./openai";
 
 export class AzureOpenAiAdapter extends OpenAiAdapter {
@@ -22,25 +21,13 @@ export class AzureOpenAiAdapter extends OpenAiAdapter {
   }
 
   protected override extractErrorFromResponse(response: any): ServiceError {
-    const errorData = response.data?.error;
-    if (errorData) {
-      const isAuthError = errorData.code === "401" ||
-        errorData.code === "403" ||
-        errorData.message?.toLowerCase().includes("key") ||
-        errorData.message?.toLowerCase().includes("auth");
-
-      return {
-        type: isAuthError ? "secretKey" : "api",
-        message: errorData.message || "Unknown Azure OpenAI API error",
-        addition: errorData.code,
-        troubleshootingLink: this.config.troubleshootingLink
-      };
+    const result = super.extractErrorFromResponse(response);
+    // Azure uses 403 for auth errors too
+    if (response.response?.statusCode === 403) {
+      result.type = "secretKey";
     }
-
     return {
-      type: "api",
-      message: "Azure OpenAI API error",
-      addition: JSON.stringify(response.data),
+      ...result,
       troubleshootingLink: this.config.troubleshootingLink
     };
   }
@@ -53,29 +40,28 @@ export class AzureOpenAiAdapter extends OpenAiAdapter {
     const header = this.buildHeaders(apiKey);
 
     try {
+      // Extract model from URL if it's in deployment format
+      // Format: /openai/deployments/{deployment}/responses?api-version=preview
+      const deploymentMatch = apiUrl.match(/\/deployments\/([^\/]+)\/responses/);
+      const model = deploymentMatch ? deploymentMatch[1] : "gpt-5-nano";
+
       const response = await $http.request({
         method: "POST",
         url: apiUrl,
         header,
         body: {
-          messages: [{
-            content: "You are a helpful assistant.",
-            role: "system",
-          }, {
-            content: "Test connection.",
-            role: "user",
-          }],
-          max_tokens: 5
-        }
+          model: model,
+          input: "Test connectivity. You ONLY need to reply 'OK'.",
+        },
       });
 
       if (response.data.error) {
-        handleValidateError(completion, this.extractErrorFromResponse(response));
-        return;
+        return handleValidateError(completion, this.extractErrorFromResponse(response));
       }
 
-      if ((response.data as OpenAiChatCompletion).choices.length > 0) {
-        completion({ result: true });
+      // Accept any successful response from Azure OpenAI
+      if (response.data && !response.data.error) {
+        return completion({ result: true });
       }
     } catch (error) {
       handleValidateError(completion, error);

src/adapter/base.ts

@@ -1,6 +1,6 @@
 import { HttpResponse, ServiceError, TextTranslateQuery, ValidationCompletion } from "@bob-translate/types";
 import { handleGeneralError, convertToServiceError } from "../utils";
-import type { GeminiResponse, OpenAiChatCompletion, ServiceAdapter, ServiceAdapterConfig } from "../types";
+import type { GeminiResponse, OpenAiResponse, ServiceAdapter, ServiceAdapterConfig } from "../types";
 
 export abstract class BaseAdapter implements ServiceAdapter {
   protected constructor(protected readonly config: ServiceAdapterConfig) { }
@@ -25,7 +25,7 @@ export abstract class BaseAdapter implements ServiceAdapter {
 
   abstract handleStream(streamData: { text: string }, query: TextTranslateQuery, targetText: string): string;
 
-  abstract parseResponse(response: HttpResponse<GeminiResponse | OpenAiChatCompletion>): string;
+  abstract parseResponse(response: HttpResponse<GeminiResponse | OpenAiResponse>): string;
 
   abstract testApiConnection(apiKey: string, apiUrl: string, completion: ValidationCompletion): Promise<void>;
 
@@ -96,6 +96,8 @@ export abstract class BaseAdapter implements ServiceAdapter {
     query: TextTranslateQuery,
   ): Promise<void> {
     let targetText = "";
+    let streamError: ServiceError | null = null;
+    
     await $http.streamRequest({
       method: "POST",
       url,
@@ -112,14 +114,24 @@ export abstract class BaseAdapter implements ServiceAdapter {
           return;
         }
 
-        targetText = this.handleStream(
-          { text: streamData.text },
-          query,
-          targetText
-        );
+        try {
+          targetText = this.handleStream(
+            { text: streamData.text },
+            query,
+            targetText
+          );
+        } catch (error) {
+          // Save the error to be handled later
+          if (error && typeof error === 'object' && 'message' in error) {
+            streamError = error as ServiceError;
+          }
+        }
       },
       handler: (result) => {
-        if (result.response.statusCode >= 400) {
+        // If we caught an error from the stream, use that
+        if (streamError) {
+          handleGeneralError(query, streamError);
+        } else if (result.response.statusCode >= 400) {
           handleGeneralError(query, this.extractErrorFromResponse(result));
         } else {
           this.handleStreamCompletion(query, targetText);

src/adapter/gemini.ts

@@ -1,5 +1,5 @@
 import { HttpResponse, ServiceError, TextTranslateQuery, ValidationCompletion } from "@bob-translate/types";
-import type { OpenAiChatCompletion, GeminiResponse } from "../types";
+import type { OpenAiResponse, GeminiResponse } from "../types";
 import { generatePrompts, handleValidateError } from "../utils";
 import { BaseAdapter } from "./base";
 
@@ -70,7 +70,7 @@ export class GeminiAdapter extends BaseAdapter {
     return this.isStreamEnabled() ? `${baseUrl}?alt=sse` : baseUrl;
   }
 
-  public parseResponse(response: HttpResponse<GeminiResponse | OpenAiChatCompletion>): string {
+  public parseResponse(response: HttpResponse<GeminiResponse | OpenAiResponse>): string {
     const { data } = response;
     if (typeof data === 'object' && 'candidates' in data) {
       if (!data?.candidates?.[0]?.content?.parts?.[0]?.text) {

src/adapter/openai-compatible.ts

@@ -2,10 +2,13 @@ import { OpenAiAdapter } from "./openai";
 
 export class OpenAiCompatibleAdapter extends OpenAiAdapter {
   public override getTextGenerationUrl(apiUrl: string): string {
+    if (!apiUrl.endsWith('/responses')) {
+      throw new Error('API URL must end with /responses for OpenAI Compatible services');
+    }
     return apiUrl;
   }
 
   protected override getValidationUrl(apiUrl: string): string {
-    return apiUrl.replace(/\/chat\/completions$/, '/models');
+    return apiUrl.replace(/\/responses$/, '/models');
   }
 }