aicodeswitch 3.9.4 → 4.0.0

package/schema/{openai.schema.md → openai-chat-completions.schema.md}

@@ -175,7 +175,7 @@ interface Message {
   tool_calls?: ToolCall[];                  // assistant消息中的工具调用
 }
 
-type ContentBlock = 
+type ContentBlock =
   | TextContent
   | ImageContent
   | ToolCallContent
@@ -399,1021 +399,6 @@ curl -X POST https://api.openai.com/v1/chat/completions \
   }'
 ```
 
----
-
-## Responses API（新一代响应接口）
-
-### 概述
-
-**Responses API** 是 OpenAI 最新的通用响应生成接口，是 Chat Completions API 的升级版本。提供更强大和灵活的能力：
-
-**主要特性**：
-- 文本和图像输入，文本输出
-- 有状态的多轮对话（通过 conversation 或 previous_response_id）
-- 内置工具：网络搜索、文件搜索、计算机使用等
-- 函数调用（自定义工具）
-- 后台处理和长期运行任务
-- 响应存储和检索
-- 流式和非流式响应
-- 推理模型支持（gpt-5、o-series）
-- 对话压缩（conversation compaction）
-
-### API 端点
-
-```bash
-# 创建响应
-POST /v1/responses
-
-# 获取响应
-GET /v1/responses/{response_id}
-
-# 删除响应
-DELETE /v1/responses/{response_id}
-
-# 取消后台响应
-POST /v1/responses/{response_id}/cancel
-
-# 压缩对话
-POST /v1/responses/compact
-
-# 列出响应的输入项
-GET /v1/responses/{response_id}/input_items
-
-# 计算输入 token 数
-POST /v1/responses/input_tokens
-```
-
-### 请求格式 - 创建响应
-
-```typescript
-POST /v1/responses
-Host: api.openai.com
-Authorization: Bearer sk-xxx
-Content-Type: application/json
-
-{
-  // ===== 必需字段 =====
-  "model": string,                          // 模型ID (gpt-4o, gpt-5, o3等)
-
-  // ===== 输入和对话 =====
-  "input"?: string | object,                // 文本、图像或文件输入
-  "instructions"?: string,                  // 系统提示词
-  "conversation"?: string | object,         // 对话ID或对象
-  "previous_response_id"?: string,          // 上一个响应ID，用于多轮对话
-
-  // ===== 响应配置 =====
-  "max_output_tokens"?: number,             // 最大输出 token 数
-  "temperature"?: number,                   // 0-2，采样温度
-  "top_p"?: number,                         // 0-1，核采样
-  "text"?: object,                          // 文本响应格式配置
-  "stream"?: boolean,                       // 是否流式响应
-  "stream_options"?: object,                // 流式选项
-
-  // ===== 工具和函数调用 =====
-  "tools"?: Tool[],                         // 内置工具和函数定义
-  "tool_choice"?: string | object,          // 工具选择策略
-  "max_tool_calls"?: number,                // 最大工具调用次数
-  "parallel_tool_calls"?: boolean,          // 是否并行调用工具
-
-  // ===== 后台处理 =====
-  "background"?: boolean,                   // 后台运行响应
-  "store"?: boolean,                        // 是否存储响应
-
-  // ===== 高级特性 =====
-  "reasoning"?: object,                     // 推理模型配置
-  "prompt_cache_key"?: string,              // 提示词缓存键
-  "prompt_cache_retention"?: string,        // 缓存保留策略（24h）
-  "truncation"?: string,                    // 截断策略（auto/disabled）
-  "include"?: string[],                     // 包含的额外输出字段
-  "metadata"?: object,                      // 自定义元数据
-  "safety_identifier"?: string,             // 用户安全标识
-  "service_tier"?: string                   // 服务等级（auto/default/flex/priority）
-}
-```
-
-### 输入格式
-
-```typescript
-// 文本输入
-{
-  "input": "Tell me a joke about programming"
-}
-
-// 图像输入
-{
-  "input": [
-    {
-      "type": "image",
-      "source": {
-        "type": "url",
-        "url": "https://example.com/image.jpg"
-      }
-    },
-    {
-      "type": "text",
-      "text": "What's in this image?"
-    }
-  ]
-}
-
-// 文件输入
-{
-  "input": [
-    {
-      "type": "document",
-      "source": {
-        "type": "file",
-        "file_id": "file-abc123"
-      }
-    },
-    {
-      "type": "text",
-      "text": "Summarize this document"
-    }
-  ]
-}
-```
-
-### 工具定义
-
-```typescript
-// 函数调用工具
-{
-  "tools": [
-    {
-      "type": "function",
-      "function": {
-        "name": "get_weather",
-        "description": "Get weather for a location",
-        "parameters": {
-          "type": "object",
-          "properties": {
-            "location": {
-              "type": "string",
-              "description": "City name"
-            }
-          },
-          "required": ["location"]
-        }
-      }
-    }
-  ]
-}
-
-// 内置工具示例
-{
-  "tools": [
-    {
-      "type": "web_search"           // 网络搜索
-    },
-    {
-      "type": "file_search"          // 文件搜索
-    },
-    {
-      "type": "code_interpreter"     // 代码执行
-    },
-    {
-      "type": "computer"             // 计算机使用
-    }
-  ]
-}
-```
-
-### 请求示例
-
-```bash
-# 基础文本请求
-curl https://api.openai.com/v1/responses \
-  -H "Content-Type: application/json" \
-  -H "Authorization: Bearer $OPENAI_API_KEY" \
-  -d '{
-    "model": "gpt-4o",
-    "input": "Tell me a three sentence bedtime story about a unicorn."
-  }'
-
-# 多轮对话
-curl https://api.openai.com/v1/responses \
-  -H "Content-Type: application/json" \
-  -H "Authorization: Bearer $OPENAI_API_KEY" \
-  -d '{
-    "model": "gpt-4o",
-    "input": "What is your favorite color from the story?",
-    "previous_response_id": "resp_67ccd2bed1ec8190b14f964abc054267..."
-  }'
-
-# 使用网络搜索
-curl https://api.openai.com/v1/responses \
-  -H "Content-Type: application/json" \
-  -H "Authorization: Bearer $OPENAI_API_KEY" \
-  -d '{
-    "model": "gpt-4o",
-    "input": "What is the latest news about AI?",
-    "tools": [
-      {
-        "type": "web_search"
-      }
-    ]
-  }'
-
-# 后台处理
-curl https://api.openai.com/v1/responses \
-  -H "Content-Type: application/json" \
-  -H "Authorization: Bearer $OPENAI_API_KEY" \
-  -d '{
-    "model": "gpt-4o",
-    "input": "Process a large file and generate a report",
-    "background": true,
-    "store": true
-  }'
-```
-
-### 响应格式
-
-```json
-{
-  "id": "resp_67ccd2bed1ec8190b14f964abc0542670bb6a6b452d3795b",
-  "object": "response",
-  "created_at": 1741476542,
-  "status": "completed",
-  "completed_at": 1741476543,
-  "error": null,
-  "incomplete_details": null,
-  "instructions": null,
-  "max_output_tokens": null,
-  "model": "gpt-4o-2024-08-06",
-  "output": [
-    {
-      "type": "message",
-      "id": "msg_67ccd2bf17f0819081ff3bb2cf6508e60bb6a6b452d3795b",
-      "status": "completed",
-      "role": "assistant",
-      "content": [
-        {
-          "type": "output_text",
-          "text": "In a peaceful grove beneath a silver moon, a unicorn named Lumina discovered a hidden pool that reflected the stars...",
-          "annotations": []
-        }
-      ]
-    }
-  ],
-  "parallel_tool_calls": true,
-  "previous_response_id": null,
-  "reasoning": {
-    "effort": null,
-    "summary": null
-  },
-  "store": true,
-  "temperature": 1.0,
-  "text": {
-    "format": {
-      "type": "text"
-    }
-  },
-  "tool_choice": "auto",
-  "tools": [],
-  "top_p": 1.0,
-  "truncation": "disabled",
-  "usage": {
-    "input_tokens": 36,
-    "input_tokens_details": {
-      "cached_tokens": 0
-    },
-    "output_tokens": 87,
-    "output_tokens_details": {
-      "reasoning_tokens": 0
-    },
-    "total_tokens": 123
-  },
-  "metadata": {}
-}
-```
-
-### 获取响应
-
-```bash
-# 获取已完成的响应
-curl https://api.openai.com/v1/responses/resp_abc123 \
-  -H "Authorization: Bearer $OPENAI_API_KEY"
-
-# 流式获取背景响应
-curl https://api.openai.com/v1/responses/resp_abc123?stream=true \
-  -H "Authorization: Bearer $OPENAI_API_KEY"
-```
-
-### 删除响应
-
-```bash
-curl -X DELETE https://api.openai.com/v1/responses/resp_abc123 \
-  -H "Authorization: Bearer $OPENAI_API_KEY"
-```
-
-### 取消后台响应
-
-```bash
-curl -X POST https://api.openai.com/v1/responses/resp_abc123/cancel \
-  -H "Content-Type: application/json" \
-  -H "Authorization: Bearer $OPENAI_API_KEY"
-```
-
-### 压缩长对话
-
-```bash
-curl -X POST https://api.openai.com/v1/responses/compact \
-  -H "Content-Type: application/json" \
-  -H "Authorization: Bearer $OPENAI_API_KEY" \
-  -d '{
-    "model": "gpt-5",
-    "input": [
-      {
-        "role": "user",
-        "content": "Create a landing page"
-      },
-      {
-        "type": "message",
-        "role": "assistant",
-        "content": [
-          {
-            "type": "output_text",
-            "text": "Here is a landing page..."
-          }
-        ]
-      }
-    ]
-  }'
-```
-
-### 计算输入 Token 数
-
-```bash
-curl -X POST https://api.openai.com/v1/responses/input_tokens \
-  -H "Content-Type: application/json" \
-  -H "Authorization: Bearer $OPENAI_API_KEY" \
-  -d '{
-    "model": "gpt-4o",
-    "input": "Tell me a joke."
-  }'
-
-# 响应
-{
-  "object": "response.input_tokens",
-  "input_tokens": 11
-}
-```
-
-### 响应状态
-
-```
-completed      - 已完成
-failed         - 失败
-in_progress    - 进行中
-cancelled      - 已取消（仅后台任务）
-queued         - 队列中（仅后台任务）
-incomplete     - 不完整
-```
-
-### 流式响应
-
-```bash
-curl https://api.openai.com/v1/responses \
-  -H "Content-Type: application/json" \
-  -H "Authorization: Bearer $OPENAI_API_KEY" \
-  -d '{
-    "model": "gpt-4o",
-    "input": "Write a poem",
-    "stream": true
-  }'
-```
-
-### 流式事件类型
-
-#### **生命周期事件**
-
-```typescript
-// 1. response.created - 响应创建
-{
-  "type": "response.created",
-  "sequence_number": 1,
-  "response": {
-    "id": "resp_67ccfcdd16748190a91872c75d38539e...",
-    "status": "in_progress",
-    ...
-  }
-}
-
-// 2. response.in_progress - 响应进行中
-{
-  "type": "response.in_progress",
-  "sequence_number": 1,
-  "response": {...}
-}
-
-// 3. response.completed - 响应完成
-{
-  "type": "response.completed",
-  "sequence_number": 1,
-  "response": {
-    "id": "resp_123",
-    "status": "completed",
-    "completed_at": 1740855870,
-    "output": [...]
-  }
-}
-
-// 4. response.failed - 响应失败
-{
-  "type": "response.failed",
-  "sequence_number": 1,
-  "response": {
-    "id": "resp_123",
-    "status": "failed",
-    "error": {
-      "code": "server_error",
-      "message": "The model failed to generate a response."
-    }
-  }
-}
-
-// 5. response.incomplete - 响应不完整
-{
-  "type": "response.incomplete",
-  "sequence_number": 1,
-  "response": {
-    "id": "resp_123",
-    "status": "incomplete",
-    "incomplete_details": {
-      "reason": "max_tokens"
-    }
-  }
-}
-
-// 6. response.queued - 响应队列中
-{
-  "type": "response.queued",
-  "sequence_number": 1,
-  "response": {
-    "id": "res_123",
-    "status": "queued"
-  }
-}
-```
-
-#### **输出项事件**
-
-```typescript
-// 1. response.output_item.added - 输出项添加
-{
-  "type": "response.output_item.added",
-  "output_index": 0,
-  "sequence_number": 1,
-  "item": {
-    "id": "msg_123",
-    "status": "in_progress",
-    "type": "message",
-    "role": "assistant",
-    "content": []
-  }
-}
-
-// 2. response.output_item.done - 输出项完成
-{
-  "type": "response.output_item.done",
-  "output_index": 0,
-  "sequence_number": 1,
-  "item": {
-    "id": "msg_123",
-    "status": "completed",
-    "type": "message",
-    "role": "assistant",
-    "content": [...]
-  }
-}
-```
-
-#### **内容部分事件**
-
-```typescript
-// 1. response.content_part.added - 内容部分添加
-{
-  "type": "response.content_part.added",
-  "item_id": "msg_123",
-  "output_index": 0,
-  "content_index": 0,
-  "sequence_number": 1,
-  "part": {
-    "type": "output_text",
-    "text": "",
-    "annotations": []
-  }
-}
-
-// 2. response.content_part.done - 内容部分完成
-{
-  "type": "response.content_part.done",
-  "item_id": "msg_123",
-  "output_index": 0,
-  "content_index": 0,
-  "sequence_number": 1,
-  "part": {
-    "type": "output_text",
-    "text": "Complete text here...",
-    "annotations": []
-  }
-}
-```
-
-#### **文本输出事件**
-
-```typescript
-// 1. response.output_text.delta - 文本增量
-{
-  "type": "response.output_text.delta",
-  "item_id": "msg_123",
-  "output_index": 0,
-  "content_index": 0,
-  "delta": "Hello",
-  "sequence_number": 1,
-  "logprobs": []
-}
-
-// 2. response.output_text.done - 文本完成
-{
-  "type": "response.output_text.done",
-  "item_id": "msg_123",
-  "output_index": 0,
-  "content_index": 0,
-  "text": "Complete response text...",
-  "sequence_number": 1,
-  "logprobs": []
-}
-
-// 3. response.output_text.annotation.added - 文本注释添加
-{
-  "type": "response.output_text.annotation.added",
-  "item_id": "item-abc",
-  "output_index": 0,
-  "content_index": 0,
-  "annotation_index": 0,
-  "annotation": {
-    "type": "text_annotation",
-    "text": "Citation text",
-    "start": 0,
-    "end": 10
-  },
-  "sequence_number": 1
-}
-```
-
-#### **拒绝事件**
-
-```typescript
-// 1. response.refusal.delta - 拒绝文本增量
-{
-  "type": "response.refusal.delta",
-  "item_id": "msg_123",
-  "output_index": 0,
-  "content_index": 0,
-  "delta": "I cannot",
-  "sequence_number": 1
-}
-
-// 2. response.refusal.done - 拒绝文本完成
-{
-  "type": "response.refusal.done",
-  "item_id": "item-abc",
-  "output_index": 1,
-  "content_index": 2,
-  "refusal": "I cannot help with this request.",
-  "sequence_number": 1
-}
-```
-
-#### **函数调用事件**
-
-```typescript
-// 1. response.function_call_arguments.delta - 函数参数增量
-{
-  "type": "response.function_call_arguments.delta",
-  "item_id": "item-abc",
-  "output_index": 0,
-  "delta": "{\"arg\":",
-  "sequence_number": 1
-}
-
-// 2. response.function_call_arguments.done - 函数参数完成
-{
-  "type": "response.function_call_arguments.done",
-  "item_id": "item-abc",
-  "name": "get_weather",
-  "output_index": 1,
-  "arguments": "{\"arg\": 123}",
-  "sequence_number": 1
-}
-```
-
-#### **网络搜索事件**
-
-```typescript
-// 1. response.web_search_call.in_progress
-{
-  "type": "response.web_search_call.in_progress",
-  "output_index": 0,
-  "item_id": "ws_123",
-  "sequence_number": 0
-}
-
-// 2. response.web_search_call.searching
-{
-  "type": "response.web_search_call.searching",
-  "output_index": 0,
-  "item_id": "ws_123",
-  "sequence_number": 0
-}
-
-// 3. response.web_search_call.completed
-{
-  "type": "response.web_search_call.completed",
-  "output_index": 0,
-  "item_id": "ws_123",
-  "sequence_number": 0
-}
-```
-
-#### **文件搜索事件**
-
-```typescript
-// 1. response.file_search_call.in_progress
-{
-  "type": "response.file_search_call.in_progress",
-  "output_index": 0,
-  "item_id": "fs_123",
-  "sequence_number": 1
-}
-
-// 2. response.file_search_call.searching
-{
-  "type": "response.file_search_call.searching",
-  "output_index": 0,
-  "item_id": "fs_123",
-  "sequence_number": 1
-}
-
-// 3. response.file_search_call.completed
-{
-  "type": "response.file_search_call.completed",
-  "output_index": 0,
-  "item_id": "fs_123",
-  "sequence_number": 1
-}
-```
-
-#### **推理事件**（仅 gpt-5、o-series）
-
-```typescript
-// 1. response.reasoning_summary_part.added
-{
-  "type": "response.reasoning_summary_part.added",
-  "item_id": "rs_6806bfca0b2481918a5748308061a26...",
-  "output_index": 0,
-  "summary_index": 0,
-  "sequence_number": 1,
-  "part": {
-    "type": "summary_text",
-    "text": ""
-  }
-}
-
-// 2. response.reasoning_summary_text.delta
-{
-  "type": "response.reasoning_summary_text.delta",
-  "item_id": "rs_6806bfca0b2481918a5748308061a26...",
-  "output_index": 0,
-  "summary_index": 0,
-  "delta": "**Analyzing the problem**\n\nThe user asked...",
-  "sequence_number": 1
-}
-
-// 3. response.reasoning_summary_text.done
-{
-  "type": "response.reasoning_summary_text.done",
-  "item_id": "rs_6806bfca0b2481918a5748308061a26...",
-  "output_index": 0,
-  "summary_index": 0,
-  "text": "Full reasoning summary...",
-  "sequence_number": 1
-}
-
-// 4. response.reasoning_text.delta - 完整推理过程增量
-{
-  "type": "response.reasoning_text.delta",
-  "item_id": "rs_123",
-  "output_index": 0,
-  "content_index": 0,
-  "delta": "The",
-  "sequence_number": 1
-}
-
-// 5. response.reasoning_text.done - 完整推理过程完成
-{
-  "type": "response.reasoning_text.done",
-  "item_id": "rs_123",
-  "output_index": 0,
-  "content_index": 0,
-  "text": "The user is asking...",
-  "sequence_number": 4
-}
-```
-
-#### **代码解释器事件**
-
-```typescript
-// 1. response.code_interpreter_call.in_progress
-{
-  "type": "response.code_interpreter_call.in_progress",
-  "output_index": 0,
-  "item_id": "ci_12345",
-  "sequence_number": 1
-}
-
-// 2. response.code_interpreter_call.interpreting
-{
-  "type": "response.code_interpreter_call.interpreting",
-  "output_index": 4,
-  "item_id": "ci_12345",
-  "sequence_number": 1
-}
-
-// 3. response.code_interpreter_call.completed
-{
-  "type": "response.code_interpreter_call.completed",
-  "output_index": 5,
-  "item_id": "ci_12345",
-  "sequence_number": 1
-}
-
-// 4. response.code_interpreter_call_code.delta
-{
-  "type": "response.code_interpreter_call_code.delta",
-  "output_index": 0,
-  "item_id": "ci_12345",
-  "delta": "print('Hello, world')",
-  "sequence_number": 1
-}
-
-// 5. response.code_interpreter_call_code.done
-{
-  "type": "response.code_interpreter_call_code.done",
-  "output_index": 3,
-  "item_id": "ci_12345",
-  "code": "print('done')",
-  "sequence_number": 1
-}
-```
-
-#### **图像生成事件**
-
-```typescript
-// 1. response.image_generation_call.in_progress
-{
-  "type": "response.image_generation_call.in_progress",
-  "output_index": 0,
-  "item_id": "item-123",
-  "sequence_number": 0
-}
-
-// 2. response.image_generation_call.generating
-{
-  "type": "response.image_generation_call.generating",
-  "output_index": 0,
-  "item_id": "item-123",
-  "sequence_number": 0
-}
-
-// 3. response.image_generation_call.partial_image
-{
-  "type": "response.image_generation_call.partial_image",
-  "output_index": 0,
-  "item_id": "item-123",
-  "partial_image_index": 0,
-  "partial_image_b64": "...",
-  "sequence_number": 0
-}
-
-// 4. response.image_generation_call.completed
-{
-  "type": "response.image_generation_call.completed",
-  "output_index": 0,
-  "item_id": "item-123",
-  "sequence_number": 1
-}
-```
-
-#### **MCP 工具事件**
-
-```typescript
-// 1. response.mcp_call.in_progress
-{
-  "type": "response.mcp_call.in_progress",
-  "sequence_number": 1,
-  "output_index": 0,
-  "item_id": "mcp_682d437d90a88191bf88cd03aae0c3e5..."
-}
-
-// 2. response.mcp_call_arguments.delta
-{
-  "type": "response.mcp_call_arguments.delta",
-  "output_index": 0,
-  "item_id": "item-abc",
-  "delta": "{",
-  "sequence_number": 1
-}
-
-// 3. response.mcp_call_arguments.done
-{
-  "type": "response.mcp_call_arguments.done",
-  "output_index": 0,
-  "item_id": "item-abc",
-  "arguments": "{\"arg1\": \"value1\", \"arg2\": \"value2\"}",
-  "sequence_number": 1
-}
-
-// 4. response.mcp_call.completed
-{
-  "type": "response.mcp_call.completed",
-  "sequence_number": 1,
-  "item_id": "mcp_682d437d90a88191bf88cd03aae0c3e5...",
-  "output_index": 0
-}
-
-// 5. response.mcp_call.failed
-{
-  "type": "response.mcp_call.failed",
-  "sequence_number": 1,
-  "item_id": "mcp_682d437d90a88191bf88cd03aae0c3e5...",
-  "output_index": 0
-}
-
-// 6. response.mcp_list_tools.in_progress
-{
-  "type": "response.mcp_list_tools.in_progress",
-  "sequence_number": 1,
-  "output_index": 0,
-  "item_id": "mcpl_682d4379df088191886b70f4ec39f904..."
-}
-
-// 7. response.mcp_list_tools.completed
-{
-  "type": "response.mcp_list_tools.completed",
-  "sequence_number": 1,
-  "output_index": 0,
-  "item_id": "mcpl_682d4379df088191886b70f4ec39f904..."
-}
-
-// 8. response.mcp_list_tools.failed
-{
-  "type": "response.mcp_list_tools.failed",
-  "sequence_number": 1,
-  "output_index": 0,
-  "item_id": "mcpl_682d4379df088191886b70f4ec39f904..."
-}
-```
-
-#### **自定义工具事件**
-
-```typescript
-// 1. response.custom_tool_call_input.delta
-{
-  "type": "response.custom_tool_call_input.delta",
-  "output_index": 0,
-  "item_id": "ctc_1234567890abcdef",
-  "delta": "partial input text",
-  "sequence_number": 1
-}
-
-// 2. response.custom_tool_call_input.done
-{
-  "type": "response.custom_tool_call_input.done",
-  "output_index": 0,
-  "item_id": "ctc_1234567890abcdef",
-  "input": "final complete input text",
-  "sequence_number": 1
-}
-```
-
-#### **错误事件**
-
-```typescript
-{
-  "type": "error",
-  "code": "ERR_SOMETHING",
-  "message": "Something went wrong",
-  "param": null,
-  "sequence_number": 1
-}
-```
-
-### 流式处理的事件顺序
-
-一个典型的流式响应事件序列：
-
-1. `response.created` - 响应开始创建
-2. `response.in_progress` - 响应开始处理
-3. `response.output_item.added` - 添加输出项（消息）
-4. `response.content_part.added` - 添加内容部分
-5. `response.output_text.delta`（多次） - 文本流式输出
-6. `response.output_text.done` - 文本输出完成
-7. `response.output_item.done` - 输出项完成
-8. `response.completed` - 响应完成
-
-对于带有工具调用的流式响应：
-
-1. `response.created`
-2. `response.output_item.added`
-3. `response.function_call_arguments.delta`（多次）
-4. `response.function_call_arguments.done`
-5. `response.completed`
-
----
-
-## 模型选择
-
-### 当前可用模型
-
-```typescript
-const models = {
-  // Chat Completions API 推荐
-  "gpt-4-turbo": {
-    context: 128000,
-    description: "最强能力，支持Vision",
-    cost: "$10/1M输入，$30/1M输出",
-    best_for: "复杂推理、代码分析"
-  },
-  "gpt-4o": {
-    context: 128000,
-    description: "新一代旗舰模型，更快更便宜",
-    cost: "$5/1M输入，$15/1M输出",
-    best_for: "大多数应用（推荐首选）"
-  },
-  "gpt-4o-mini": {
-    context: 128000,
-    description: "轻量级，成本最低",
-    cost: "$0.15/1M输入，$0.6/1M输出",
-    best_for: "简单任务、高吞吐"
-  },
-  "gpt-3.5-turbo": {
-    context: 4096,
-    description: "经典快速模型",
-    cost: "$0.5/1M输入，$1.5/1M输出",
-    best_for: "对话、翻译"
-  },
-
-  // Realtime API
-  "gpt-4o-realtime-preview": {
-    context: 128000,
-    description: "实时语音对话（预览版）",
-    cost: "$5/1M输入，$20/1M输出",
-    best_for: "实时语音交互"
-  },
-
-  // Completions API（已弃用）
-  "gpt-3.5-turbo-instruct": {
-    context: 4096,
-    description: "文本补全（维护模式）",
-    best_for: "仅用于兼容性"
-  }
-};
-```
-
-### 模型对比表
-
-| 特性 | GPT-4 Turbo | GPT-4o | GPT-4o-mini | 3.5-Turbo |
-|-----|-----------|--------|-----------|----------|
-| 上下文 | 128k | 128k | 128k | 4k |
-| Vision | ✅ | ✅ | ✅ | ❌ |
-| 函数调用 | ✅ | ✅ | ✅ | ✅ |
-| JSON 模式 | ✅ | ✅ | ✅ | ✅ |
-| 推理能力 | ⭐⭐⭐⭐⭐ | ⭐⭐⭐⭐ | ⭐⭐⭐ | ⭐⭐⭐ |
-| 速度 | 中等 | 快 | 最快 | 快 |
-| 成本 | 高 | 中 | 低 | 最低 |
-
-### 选择决策树
-
-```
-你的任务是什么?
-├─ 实时语音交互 ──> gpt-4o-realtime-preview
-├─ 图像识别和分析 ──> gpt-4-turbo 或 gpt-4o
-├─ 代码生成/分析 ──> gpt-4o（推荐）或 gpt-4-turbo
-├─ 简单对话/翻译 ──> gpt-3.5-turbo 或 gpt-4o-mini
-└─ 高吞吐量应用 ──> gpt-4o-mini
-
-预算和延迟考虑?
-├─ 预算充足，性能优先 ──> gpt-4-turbo
-├─ 平衡成本和性能 ──> gpt-4o（推荐首选）
-├─ 成本敏感 ──> gpt-4o-mini
-└─ 低成本、快速 ──> gpt-3.5-turbo
-```
-
----
-
 ## 流式事件
 
 ### 流式响应启用
@@ -1544,11 +529,11 @@ async function requestWithRetry(
     } catch (error: any) {
       const status = error.status;
       const isRetryable = status === 429 || status >= 500;
-      
+
       if (!isRetryable || attempt === maxRetries) {
         throw error;
       }
-      
+
       // 指数退避：第一次等待1秒，第二次2秒，第三次4秒
       const delay = Math.pow(2, attempt - 1) * 1000;
       await new Promise(resolve => setTimeout(resolve, delay));
@@ -1574,24 +559,6 @@ async function requestWithRetry(
 | stop | 字符串数组 | - | 停止生成的序列 |
 | seed | 整数 | - | 随机种子，确保输出可复现 |
 
-### 三个 API 端点速查
-
-```bash
-# Responses API（推荐 - 新一代接口）
-POST https://api.openai.com/v1/responses
-GET https://api.openai.com/v1/responses/{response_id}
-DELETE https://api.openai.com/v1/responses/{response_id}
-POST https://api.openai.com/v1/responses/{response_id}/cancel
-POST https://api.openai.com/v1/responses/compact
-POST https://api.openai.com/v1/responses/input_tokens
-
-# Chat Completions API（标准对话接口）
-POST https://api.openai.com/v1/chat/completions
-
-# Completions API（已弃用，维护中）
-POST https://api.openai.com/v1/completions
-```
-
 ### 认证方式
 
 ```bash
@@ -1612,27 +579,12 @@ OpenAI-Beta: realtime=v1
 ### 1. API 选择指南
 
 ```typescript
-// ✅ 优先使用 Responses API（推荐首选）
-// - 新一代接口，功能最强
-// - 支持有状态对话、内置工具（网搜、文搜、计算机使用）
-// - 支持后台处理和长期运行任务
-// - 支持推理模型（gpt-5、o-series）
-// - 支持响应存储和检索
-
-POST /v1/responses
-
 // ✅ Chat Completions API（简单对话）
 // - 轻量级对话接口
 // - 支持函数调用和 Vision
 // - 当不需要内置工具和后台处理时使用
 
 POST /v1/chat/completions
-
-// ⚠️ 仅在兼容性需求时使用 Completions API
-// - 已进入维护模式
-// - 不推荐用于新项目
-
-POST /v1/completions
 ```
 
 ### 2. 模型选择原则
@@ -1671,7 +623,7 @@ function estimateCost(
     'gpt-4o-mini': { input: 0.00015, output: 0.0006 },
     'gpt-3.5-turbo': { input: 0.0005, output: 0.0015 }
   };
-  
+
   const price = prices[model];
   return (
     (inputTokens * price.input + outputTokens * price.output) / 1000000
@@ -1741,20 +693,20 @@ function: {
 // ✅ 处理连续调用
 for (let turn = 0; turn < maxTurns; turn++) {
   const response = await makeRequest();
-  
+
   if (response.finish_reason !== 'tool_calls') break;
-  
+
   // 执行所有函数调用
   const toolResults = await Promise.all(
     response.tool_calls.map(call => executeTool(call))
   );
-  
+
   // 添加结果到消息历史继续对话
   messages.push({
     role: 'assistant',
     content: response.content
   });
-  
+
   messages.push({
     role: 'user',
     content: toolResults.map(r => ({
@@ -1836,7 +788,7 @@ async function smartRequest(requestFn) {
     } catch (error) {
       if (error.status === 429) {
         // 从响应头读取重试时间
-        const retryAfter = 
+        const retryAfter =
           error.headers?.['retry-after'] || '60';
         await throttledRequest(parseInt(retryAfter) * 1000);
       } else {
@@ -2134,29 +1086,3 @@ const compacted = await openai.beta.responses.compact({
 
 console.log("Compacted response:", compacted.id);
 ```
-
----
-
-## 版本信息和更新
-
-- **文档版本**：2.3（添加完整流式事件文档）
-- **更新日期**：2026 年 2 月 3 日
-- **覆盖 API**：Responses、Chat Completions、Completions（已弃用）
-- **最新模型**：GPT-4o、GPT-4o-mini、GPT-5、O3
-- **API 基础 URL**：https://api.openai.com
-
----
-
-## 常见问题解答
-
-| 问题 | 答案 |
-|-----|------|
-| 应该使用哪个 API？ | 优先使用 Responses API，它是 OpenAI 的新一代标准。Chat Completions API 仍可用但逐渐被替代。Completions API 已过时。 |
-| Responses API 和 Chat Completions API 有什么区别？ | Responses API 支持有状态对话、内置工具（网搜、文搜等）、后台处理、推理模型。Chat Completions 更轻量，只支持基础对话和函数调用。 |
-| Responses API 支持哪些内置工具？ | web_search（网络搜索）、file_search（文件搜索）、code_interpreter（代码执行）、computer（计算机使用）。 |
-| 如何在 Responses API 中进行多轮对话？ | 使用 `previous_response_id` 参数引用之前的响应，或使用 `conversation` 参数。 |
-| 后台处理如何工作？ | 设置 `"background": true`，响应会异步执行。可通过 `GET /v1/responses/{response_id}` 检查状态。 |
-| 哪个模型性价比最好？ | gpt-4o 是目前的最佳选择，性能强、成本合理。 |
-| Responses API 支持流式吗？ | 支持，设置 `"stream": true`。使用 Server-Sent Events 格式。 |
-| 如何处理速率限制？ | 使用指数退避重试策略，从 Retry-After 头读取建议延迟。 |
-