{
  "openapi": "3.1.0",
  "info": {
    "title": "心流 API",
    "description": "心流 API 聚合网关 — 兼容 OpenAI / Anthropic / Google 等多家大模型的文本、图像、视频接口。\n\n> 说明：部分模型共用同一 HTTP 路径（如多个视频模型均为 `POST /v1/videos`，通过请求体中的 `model` 区分）。为便于查阅，文档中按模型分别列出，路径后以 `#模型` 标记加以区分。\n\n每个接口的完整参数、返回字段、错误码与示例见各接口说明。",
    "version": "1.0.0"
  },
  "servers": [
    {
      "url": "https://iliu.ai",
      "description": "国内加速（推荐）"
    },
    {
      "url": "https://api.xinliu.one",
      "description": "海外直连"
    }
  ],
  "tags": [
    {
      "name": "OpenAI"
    },
    {
      "name": "对话模型（新增）"
    },
    {
      "name": "Anthropic"
    },
    {
      "name": "Google"
    },
    {
      "name": "小米 MiMo"
    },
    {
      "name": "月之暗面"
    },
    {
      "name": "图像模型"
    },
    {
      "name": "字节跳动"
    },
    {
      "name": "视频模型"
    },
    {
      "name": "HappyHorse"
    },
    {
      "name": "快手可灵"
    },
    {
      "name": "模型参考"
    },
    {
      "name": "系统 API（客户可用）"
    }
  ],
  "security": [
    {
      "bearerAuth": []
    }
  ],
  "paths": {
    "/v1/responses": {
      "post": {
        "tags": [
          "OpenAI"
        ],
        "summary": "Responses 接口（OpenAI Responses API）",
        "operationId": "op_480810066",
        "description": "### 1. 功能介绍\n\n**OpenAI Responses API** — GPT-5 系列的新一代端点，替代 Chat Completions 协议的升级选项。支持**流式、工具调用、内置搜索、推理模式**。\n\n- 适用模型：`gpt-5.1` / `gpt-5.2` / `gpt-5.4` / `gpt-5.5` 等标有 `openai-response` 端点类型的 GPT 模型\n- 与 Chat Completions 并行可用（两种协议可互操作）\n- 兼容 `openai` SDK 1.65+ 的 `client.responses.create()` 方法\n\n\n### 2. 可用型号\n\n| model | 说明 | enable_groups |\n|---|---|---|\n| `gpt-5.5` | GPT-5.5 旗舰 | `default` `codex` `codex pro` |\n| `gpt-5.4` | GPT-5.4 | `default` `codex` `codex pro` |\n| `gpt-5.4-mini` | GPT-5.4 mini | `default` `codex` `codex pro` |\n| `gpt-5.4-nano` | GPT-5.4 nano | `codex` |\n| `gpt-5.4-openai-compact` | GPT-5.4 紧凑上下文 | `codex` |\n| `gpt-5.3-codex` | GPT-5.3 codex | `default` `codex` |\n| `gpt-5.3-codex-openai-compact` | GPT-5.3 codex 紧凑 | `codex` |\n| `gpt-5.2` | GPT-5.2 | `default` `codex` |\n| `gpt-5.2-codex` | GPT-5.2 codex | `default` |\n| `gpt-5.1` | GPT-5.1（推荐入门） | `default` |\n| `gpt-5.1-codex` | GPT-5.1 codex | `default` |\n| `gpt-5.1-codex-mini` | GPT-5.1 codex mini | `default` |\n| `gpt-5.1-codex-max` | GPT-5.1 codex max | `default` |\n\n### 3. 请求参数\n\n| 参数 | 类型 | 必填 | 说明 |\n|---|---|---|---|\n| `model` | string | ✅ | 模型名。见 §2 可用型号 |\n| `input` | string / array | ✅ | 输入内容。字符串或 `[{role` `content}]` 格式数组 |\n| `instructions` | string |  | 系统指令。相当于 Chat API 的 system message |\n| `stream` | boolean |  | 流式输出。`false`（默认）/ `true` |\n| `temperature` | number |  | 采样温度。0~2 |\n| `max_output_tokens` | integer |  | 最大输出 token |\n| `top_p` | number |  | 核采样。0~1 |\n| `tools` | array |  | 工具列表。OpenAI Responses 格式 |\n| `tool_choice` | string / object |  | 工具选择。`auto` / `required` / `none` |\n| `reasoning` | object |  | 推理配置。`{\"effort\":\"low\" / \"medium\" / \"high\"}` |\n| `truncation` | string |  | 截断策略。`auto`（默认）/ `disabled` |\n| `metadata` | object |  | 元数据。自定义键值对 |\n| `user` | string |  | 终端用户标识 |\n\n\n\n### 4. 返回响应\n\n**成功响应**：\n\n```json\n{\n  \"id\": \"resp_67a2b6a1e3f8420b9a8c7d6e5f4a3b2c\",\n  \"object\": \"response\",\n  \"model\": \"gpt-5.1\",\n  \"status\": \"completed\",\n  \"output\": [\n    {\n      \"type\": \"message\",\n      \"role\": \"assistant\",\n      \"content\": [{\"type\": \"output_text\", \"text\": \"愿天下的母亲都被温柔以待，节日快乐。\", \"annotations\": []}]\n    }\n  ],\n  \"usage\": {\n    \"input_tokens\": 30,\n    \"output_tokens\": 18,\n    \"total_tokens\": 48,\n    \"output_tokens_details\": {\"reasoning_tokens\": 0}\n  }\n}\n```\n\n| 返回字段 | 类型 | 说明 |\n|---|---|---|\n| `id` | string | 响应唯一 ID |\n| `object` | string | 固定 `response` |\n| `model` | string | 实际使用的模型 |\n| `status` | string | `completed` / `in_progress` / `failed` |\n| `output[].type` | string | `message` / `function_call` 等 |\n| `output[].content[].text` | string | 模型回复文本 |\n| `usage.input_tokens` | integer | 输入 token 数 |\n| `usage.output_tokens` | integer | 输出 token 数 |\n| `usage.output_tokens_details.reasoning_tokens` | integer | 推理 token 数（仅开启 reasoning 时） |\n\n### 5. 接入地址\n\n| 线路 | Base URL |\n|---|---|\n| 国内加速（推荐） | `https://iliu.ai` |\n| 海外直连 | `https://api.xinliu.one` |\n\n### 6. 错误码\n\n| 状态码 | 典型错误 | 原因 |\n|---|---|---|\n| `400` | `model not supported` | 请求了不支持 Responses API 的模型 |\n| `401` | — | 令牌无效 |\n| `402` | — | 余额不足 |\n| `404` | `model_not_found` | 模型不存在或未开通 |\n| `429` | — | 速率限制 |\n| `503` | `No available channel` | 上游不可用 |\n\n\n**错误响应格式**：\n\n```json\n{\n  \"error\": {\n    \"message\": \"具体错误描述\",\n    \"type\": \"invalid_request_error\",\n    \"param\": \"model\",\n    \"code\": \"invalid_value\"\n  }\n}\n```\n\n| 字段 | 类型 | 说明 |\n|---|---|---|\n| `error.message` | string | 人类可读的错误描述 |\n| `error.type` | string | `invalid_request_error` / `authentication_error` / `new_api_error` |\n| `error.param` | string | 触发错误的参数名（仅参数类错误有值） |\n| `error.code` | string | 机器可读错误码，如 `invalid_value` `model_not_found` |\n",
        "responses": {
          "200": {
            "description": "成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string"
                    },
                    "object": {
                      "type": "string"
                    },
                    "model": {
                      "type": "string"
                    },
                    "status": {
                      "type": "string"
                    },
                    "output": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      }
                    },
                    "usage": {
                      "type": "object",
                      "properties": {}
                    }
                  }
                },
                "example": {
                  "id": "string",
                  "object": "string",
                  "model": "string",
                  "status": "string",
                  "output": [
                    "string"
                  ],
                  "usage": {}
                }
              }
            }
          }
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "model": {
                    "type": "string"
                  },
                  "input": {
                    "type": "string"
                  },
                  "instructions": {
                    "type": "string"
                  },
                  "stream": {
                    "type": "boolean"
                  },
                  "max_output_tokens": {
                    "type": "integer"
                  },
                  "temperature": {
                    "type": "integer"
                  }
                }
              },
              "example": {
                "model": "string",
                "input": "string",
                "instructions": "string",
                "stream": true,
                "max_output_tokens": 0,
                "temperature": 0
              }
            }
          }
        }
      }
    },
    "/v1/messages": {
      "post": {
        "tags": [
          "Anthropic"
        ],
        "summary": "Messages 接口（Anthropic 原生）",
        "operationId": "op_480810040",
        "description": "### 1. 功能介绍\n\n**Anthropic Messages API 原生协议**。Claude 系列模型的官方协议，支持流式输出、工具调用、视觉理解、推理等功能。将 `@anthropic-ai/sdk` 的 `base_url` 指向心流即可使用。\n\n- 支持 Claude Opus 4.x / Sonnet 4.x / Haiku 4.5 全系\n- 比 OpenAI 兼容模式多了 `thinking`、`computer_use` 等 Claude 专有能力\n- 也通过 OpenAI 兼容 `POST /v1/chat/completions` 调 Claude（见「语言大模型 → 通用接口」）\n\n\n### 2. 可用型号\n\n心流平台上支持 Anthropic 原生协议的 Claude 模型（数据以 [模型广场](http://1.14.137.137/pricing) 为准）：\n\n| model | 说明 | enable_groups |\n|---|---|---|\n| `claude-opus-4-8` | claude-opus-4-8 是目前 Anthropic 最强的“能一个人扛住长时间复杂工作的工具”，特别适 | `claude max` `default` `dev cc max` |\n| `claude-haiku-4-5-20251001` | Claude Haiku 4.5 是速度最快、性价比最高的模型，在编码、计算机使用和代理任务方面的表现与 So | `cc2max` `ccmax` `claude aws 企业` |\n| `claude-haiku-4-5` | Claude Haiku 4.5 是速度最快、性价比最高的模型，在编码、计算机使用和代理任务方面的表现与 So | `cc2max` `ccmax` |\n| `claude-opus-4-5-20251101` | Opus 4.5是人工智能系统能力的一次有意义的进步。 | `claude aws 企业` `claude 官方直连` |\n| `claude-opus-4-6` | Claude Opus 4.6 无需多言 | `dev cc max` `low` `cc2max` |\n| `claude-sonnet-4-5-20250929` | Claude Sonnet 4.5 是构建复杂代理的最强大模型。它是使用计算机的最佳模型。它在推理和数学方面表 | `cc2max` `ccmax` `claude aws 企业` |\n| `claude-sonnet-4-6` | Claude Sonnet 4.6 可大规模提供前沿智能，专为编码、代理和企业工作流而打造。 | `low` `cc2max` `ccmax` |\n| `claude-opus-4-7` | Claude Opus 4.7 是 Anthropic 于 2026 年 4 月 16 日 发布的最新一代旗舰 | `claude 官方直连` `default` `dev cc max` |\n\n> 💡 Claude 模型也支持 **OpenAI 兼容协议**（`POST /v1/chat/completions`），两种协议可互操作。\n\n### 3. 请求参数\n\n| 参数 | 类型 | 必填 | 说明 |\n|---|---|---|---|\n| `model` | string | ✅ | 模型名。见 §2 可用型号 |\n| `messages` | array | ✅ | 对话消息。`[{role, content}]` |\n| `max_tokens` | integer | ✅ | 最大输出 token。Claude 协议**必填**，建议 1024~4096 |\n| `system` | string / array |  | 系统提示词。字符串或 `[{type:\"text\"` `text:\"...\"}]` |\n| `temperature` | number |  | 采样温度。0~1，默认 1 |\n| `top_p` | number |  | 核采样。0~1 |\n| `top_k` | integer |  | Top-K 采样 |\n| `stream` | boolean |  | 流式输出。`false`（默认）/ `true` |\n| `stop_sequences` | array |  | 停止序列。最多 4 个字符串 |\n| `tools` | array |  | 工具定义。Claude 格式的 `[{name` `description` `input_schema}]` |\n| `tool_choice` | string / object |  | 工具选择。`auto` / `any` / `{\"type\":\"tool\"` `\"name\":\"xxx\"}` |\n| `thinking` | object |  | 推理模式。`{\"type\":\"enabled\",\"budget_tokens\":16000}` 启用推理 |\n| `metadata.user_id` | string |  | 用户标识。用于监测和滥用检测 |\n\n\n\n### 4. 返回响应\n\n**成功响应**：\n\n```json\n{\n  \"id\": \"msg_01AbCdEfGh123456789\",\n  \"type\": \"message\",\n  \"role\": \"assistant\",\n  \"model\": \"claude-opus-4-7-20250416\",\n  \"content\": [\n    {\n      \"type\": \"text\",\n      \"text\": \"你好！我是 Claude，由 Anthropic 开发的 AI 助手。\"\n    }\n  ],\n  \"stop_reason\": \"end_turn\",\n  \"stop_sequence\": null,\n  \"usage\": {\n    \"input_tokens\": 25,\n    \"output_tokens\": 20,\n    \"cache_creation_input_tokens\": 0,\n    \"cache_read_input_tokens\": 0\n  }\n}\n```\n\n| 返回字段 | 类型 | 说明 |\n|---|---|---|\n| `id` | string | 消息唯一 ID |\n| `type` | string | 固定 `message` |\n| `role` | string | 固定 `assistant` |\n| `model` | string | 实际使用的模型完整 ID |\n| `content[].type` | string | `text` / `tool_use` |\n| `content[].text` | string | 模型回复文本（`type=text` 时） |\n| `stop_reason` | string | `end_turn`（正常）/ `max_tokens`（截断）/ `tool_use`（触发工具）/ `stop_sequence`（命中停止序列） |\n| `usage.input_tokens` | integer | 输入 token 数（含 system） |\n| `usage.output_tokens` | integer | 输出 token 数 |\n\n### 5. 接入地址\n\n| 线路 | Base URL |\n|---|---|\n| 国内加速（推荐） | `https://iliu.ai` |\n| 海外直连 | `https://api.xinliu.one` |\n\n### 6. 错误码\n\n| 状态码 | 典型错误 | 原因 |\n|---|---|---|\n| `400` | `max_tokens is required` | 缺少必填的 `max_tokens` 字段 |\n| `401` | `invalid x-api-key` | 令牌无效或缺失 |\n| `402` | — | 余额不足 |\n| `404` | `model_not_found` | 模型不存在或未开通 |\n| `429` | `rate_limit_error` | 速率限制 |\n| `503` | `No available channel` | 上游不可用 |\n\n\n**错误响应格式**：\n\n```json\n{\n  \"error\": {\n    \"message\": \"具体错误描述\",\n    \"type\": \"invalid_request_error\",\n    \"param\": \"model\",\n    \"code\": \"invalid_value\"\n  }\n}\n```\n\n| 字段 | 类型 | 说明 |\n|---|---|---|\n| `error.message` | string | 人类可读的错误描述 |\n| `error.type` | string | `invalid_request_error` / `authentication_error` / `new_api_error` |\n| `error.param` | string | 触发错误的参数名（仅参数类错误有值） |\n| `error.code` | string | 机器可读错误码，如 `invalid_value` `model_not_found` |\n",
        "responses": {
          "200": {
            "description": "成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string"
                    },
                    "type": {
                      "type": "string"
                    },
                    "role": {
                      "type": "string"
                    },
                    "model": {
                      "type": "string"
                    },
                    "content": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      }
                    },
                    "stop_reason": {
                      "type": "string"
                    },
                    "usage": {
                      "type": "object",
                      "properties": {}
                    }
                  }
                },
                "example": {
                  "id": "string",
                  "type": "string",
                  "role": "string",
                  "model": "string",
                  "content": [
                    "string"
                  ],
                  "stop_reason": "string",
                  "usage": {}
                }
              }
            }
          }
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "model": {
                    "type": "string"
                  },
                  "max_tokens": {
                    "type": "integer"
                  },
                  "messages": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    }
                  }
                }
              },
              "example": {
                "model": "string",
                "max_tokens": 0,
                "messages": [
                  "string"
                ]
              }
            }
          }
        }
      }
    },
    "/v1beta/models/gemini-2.5-flash:generateContent": {
      "post": {
        "tags": [
          "Google"
        ],
        "summary": "通用接口（Gemini 原生格式）",
        "operationId": "op_477735993",
        "description": "### 1. 功能介绍\n\nGoogle Gemini 原生 `:generateContent` 协议，同步返回。让 `@google/genai` SDK 用户直接把 `base_url` 指向心流即可零改代码接入。\n\n- 支持纯文本对话、多模态识别（图片 / PDF / 音频 / 视频 + 文字提示）、Function Calling\n- 支持推理（`thinkingConfig`）、安全阈值（`safetySettings`）\n- Gemini 系模型**同时支持本接口和 OpenAI 兼容协议**（`POST /v1/chat/completions`），两种可互操作\n\n\n### 2. 可用型号\n\n心流平台上支持 Gemini 原生协议的模型（数据以 [模型广场](http://1.14.137.137/pricing) 为准）：\n\n| model | 说明 | enable_groups |\n|---|---|---|\n| `gemini-3.1-pro-preview` | Gemini 3.1 Pro（最新旗舰） | `default` `gemini T3 稳定` `gemini-officially` `gemini Cli` `gemini studio 企业版` |\n| `gemini-3-pro-preview` | Gemini 3 Pro | `default` `gemini T3 稳定` |\n| `gemini-3.5-flash` | Gemini 3.5 Flash | `default` `gemini T3 稳定` `gemini Cli` |\n| `gemini-3-flash-preview` | Gemini 3 Flash | `default` `gemini T3 稳定` `gemini-officially` |\n| `gemini-3-flash` | Gemini 3 Flash（CLI 版） | `gemini Cli` |\n| `gemini-2.5-pro` | Gemini 2.5 Pro | `default` `gemini T3 稳定` |\n| `gemini-2.5-flash` | Gemini 2.5 Flash | `default` `gemini T3 稳定` `gemini-officially` |\n| `gemini-2.0-flash` | Gemini 2.0 Flash | `gemini T3 稳定` |\n| `gpt-5` | GPT-5（也支持 Gemini 端点） | `default` |\n\n\n### 3. 请求参数\n\n| 参数 | 类型 | 必填 | 说明 |\n|---|---|---|---|\n| `{model}` (path) | string |  | 模型名。拼到 URL 中替换 `{model}` |\n| `contents` | array | ✅ | 对话内容 |\n| `contents[].role` | string |  | 角色。`user`（注意：响应中为 `model`，非 `assistant`） |\n| `contents[].parts[].text` | string |  | 文本内容 |\n| `contents[].parts[].inlineData` | object |  | 多模态输入。`{mimeType, data}`，data 为纯 Base64 |\n| `generationConfig.temperature` | number |  | 采样温度。0~2 |\n| `generationConfig.maxOutputTokens` | integer |  | 最大输出 token |\n| `generationConfig.topP` | number |  | 核采样。0~1 |\n| `generationConfig.topK` | integer |  | Top-K 采样 |\n| `generationConfig.stopSequences` | array |  | 停止序列。数组，最多 5 个 |\n| `generationConfig.thinkingConfig.thinkingBudget` | integer |  | 推理预算。传 `0` 关闭推理；仅 pro/preview 模型 |\n| `safetySettings` | array |  | 安全阈值。`[{category, threshold}]` |\n| `tools` | array |  | Function Calling 工具列表 |\n| `systemInstruction` | object |  | 系统指令。`{\"parts\":[{\"text\":\"...\"}]}` |\n\n\n### 4. 多模态 mimeType\n\n| 类型 | mime_type |\n|---|---|\n| 图片 | `image/png` / `image/jpeg` / `image/webp` |\n| PDF | `application/pdf` |\n| 音频 | `audio/mpeg` / `audio/wav` / `audio/mp3` |\n| 视频 | `video/mp4` / `video/mov` |\n\n> ⚠️ 心流仅支持 `inlineData` Base64 方式，**不支持** Google 原版的 `fileData.fileUri`。\n\n\n### 5. 返回响应\n\n**纯文本**：\n\n```json\n{\n  \"candidates\": [{\n    \"content\": {\n      \"role\": \"model\",\n      \"parts\": [{ \"text\": \"Hi! How can I help you today?\" }]\n    },\n    \"finishReason\": \"STOP\",\n    \"index\": 0\n  }],\n  \"usageMetadata\": {\n    \"promptTokenCount\": 3,\n    \"candidatesTokenCount\": 9,\n    \"totalTokenCount\": 12,\n    \"thoughtsTokenCount\": 15,\n    \"promptTokensDetails\": [{ \"modality\": \"TEXT\", \"tokenCount\": 3 }]\n  },\n  \"modelVersion\": \"gemini-2.5-flash\"\n}\n```\n\n| 返回字段 | 类型 | 说明 |\n|---|---|---|\n| `candidates[].content.parts[].text` | string | 模型回复文本 |\n| `candidates[].content.role` | string | 固定 `model`（**不是** `assistant`） |\n| `candidates[].finishReason` | string | `STOP`（正常）/ `MAX_TOKENS`（截断）/ `SAFETY`（安全过滤）/ `RECITATION`（版权） |\n| `usageMetadata.promptTokenCount` | integer | 输入 token 数 |\n| `usageMetadata.candidatesTokenCount` | integer | 输出 token 数 |\n| `usageMetadata.thoughtsTokenCount` | integer | 推理 token 数（**单独计费**） |\n| `usageMetadata.promptTokensDetails` | array | 按模态拆分的输入 token 明细 |\n\n### 6. 接入地址\n\n| 线路 | Base URL |\n|---|---|\n| 国内加速（推荐） | `https://iliu.ai` |\n| 海外直连 | `https://api.xinliu.one` |\n\n### 7. 错误码\n\n| 状态码 | 说明 |\n|---|---|\n| `400` | 参数错误 |\n| `401` | 令牌无效或未提供 |\n| `402` | 余额不足 |\n| `404` | 模型不存在或未开通 |\n| `429` | 速率限制 |\n| `503` | 上游服务不可用 |\n\n\n**错误响应格式**：\n\n```json\n{\n  \"error\": {\n    \"message\": \"具体错误描述\",\n    \"type\": \"invalid_request_error\",\n    \"param\": \"model\",\n    \"code\": \"invalid_value\"\n  }\n}\n```\n\n| 字段 | 类型 | 说明 |\n|---|---|---|\n| `error.message` | string | 人类可读的错误描述 |\n| `error.type` | string | `invalid_request_error` / `authentication_error` / `new_api_error` |\n| `error.param` | string | 触发错误的参数名（仅参数类错误有值） |\n| `error.code` | string | 机器可读错误码，如 `invalid_value` `model_not_found` |\n",
        "responses": {
          "200": {
            "description": "成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "candidates": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      }
                    },
                    "usageMetadata": {
                      "type": "object",
                      "properties": {}
                    }
                  }
                },
                "example": {
                  "candidates": [
                    "string"
                  ],
                  "usageMetadata": {}
                }
              }
            }
          }
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "contents": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "role": {
                          "type": "string"
                        },
                        "parts": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "text": {
                                "type": "string"
                              },
                              "inlineData": {
                                "type": "object",
                                "properties": {
                                  "mimeType": {
                                    "type": "string"
                                  },
                                  "data": {
                                    "type": "string"
                                  }
                                }
                              }
                            }
                          }
                        }
                      }
                    }
                  },
                  "generationConfig": {
                    "type": "object",
                    "properties": {
                      "temperature": {
                        "type": "integer"
                      },
                      "maxOutputTokens": {
                        "type": "integer"
                      }
                    }
                  },
                  "systemInstruction": {
                    "type": "object",
                    "properties": {}
                  }
                }
              },
              "example": {
                "contents": [
                  {
                    "role": "string",
                    "parts": [
                      {
                        "text": "string",
                        "inlineData": {
                          "mimeType": "string",
                          "data": "string"
                        }
                      }
                    ]
                  }
                ],
                "generationConfig": {
                  "temperature": 0,
                  "maxOutputTokens": 0
                },
                "systemInstruction": {}
              }
            }
          }
        }
      }
    },
    "/v1/chat/completions": {
      "post": {
        "tags": [
          "小米 MiMo"
        ],
        "summary": "通用接口",
        "operationId": "op_477733289",
        "description": "### 1. 功能介绍\n\n**对话模型通用入口**。兼容 OpenAI Chat Completions 协议，通过 `model` 字段切换即可调用心流平台上**所有对话模型**（共 **53 个**，覆盖 10 家厂商）。\n\n- 同一端点、同一 SDK，切换模型无需改代码\n- 支持流式输出（SSE）、多模态视觉识别、函数调用（Function Calling）、JSON 结构化输出\n- 兼容 OpenAI SDK / LangChain / LlamaIndex 及所有支持 OpenAI 协议的工具\n\n\n### 2. 可用型号\n\n心流平台上共 **53 个对话模型**，覆盖 10 家主流厂商（OpenAI、Anthropic、Google、DeepSeek、xAI、通义千问、智谱、月之暗面、MiniMax、小米 MiMo）。\n\n\n所有模型均通过本接口调用，切换 `model` 字段即可。\n\n#### 小米 MiMo 系列（分组 `default` 可用）\n\n| model | 说明 | 端点类型 | enable_groups |\n|---|---|---|---|\n| `mimo-v2.5-pro` | MiMo V2.5 Pro，Agent 与 Coding 旗舰（GDPVal-AA / ClawEval 开源榜第一） | `OpenAi` | `default` |\n| `mimo-v2.5` | MiMo V2.5，原生全模态（文本 / 图像 / 视频 / 音频理解） | `OpenAi` | `default` |\n| `mimo-v2-pro` | MiMo V2 Pro，混合注意力架构，100 万 token 上下文（总参 >1T，激活 42B） | `OpenAi` | `default` |\n\n> 📋 全部 136 个在售模型（按厂商分组）见「模型参考 · 全模型目录」；各模型参数/返回字段支持矩阵见「模型参考 · 全模型参数速查表」。\n\n### 3. 请求参数\n\n| 参数 | 类型 | 必填 | 说明 |\n|---|---|---|---|\n| `model` | string | ✅ | 模型名。见 §2 可用型号 |\n| `messages` | array | ✅ | 对话历史。`[{role, content}]`，role 取值：`system` / `user` / `assistant` / `tool` |\n| `stream` | boolean |  | 流式输出。`false`（默认）/ `true`。开启后以 SSE 推送，以 `data: [DONE]` 结束 |\n| `temperature` | number |  | 采样温度。0~2，默认 1 |\n| `max_tokens` | integer |  | 最大输出 token |\n| `top_p` | number |  | 核采样。0~1 |\n| `tools` | array |  | Function Calling 工具列表 |\n| `tool_choice` | string / object |  | 工具选择。`auto` / `none` / `{\"type\":\"function\"` `\"function\":{\"name\":\"xxx\"}}` |\n| `response_format` | object |  | 响应格式。`{\"type\": \"json_object\"}` 或 `{\"type\": \"text\"}` |\n| `n` | integer |  | 生成条数。默认 1，仅部分模型支持 >1 |\n| `stop` | string / array |  | 停止序列。最多 4 个字符串 |\n| `presence_penalty` | number |  | 主题惩罚。-2.0 ~ 2.0 |\n| `frequency_penalty` | number |  | 重复惩罚。-2.0 ~ 2.0 |\n| `user` | string |  | 终端用户标识。用于用量统计 |\n\n\n\n### 4. 返回响应\n\n**非流式（成功）**：\n\n```json\n{\n  \"id\": \"msg_3d2d24e3d67d4b20a462cff019e01c17\",\n  \"model\": \"claude-sonnet-4-6\",\n  \"object\": \"chat.completion\",\n  \"created\": 1782368953,\n  \"choices\": [{\n    \"index\": 0,\n    \"message\": {\"role\": \"assistant\", \"content\": \"Hi!\"},\n    \"finish_reason\": \"stop\"\n  }],\n  \"usage\": {\n    \"prompt_tokens\": 24,\n    \"completion_tokens\": 1,\n    \"total_tokens\": 25,\n    \"prompt_tokens_details\": {\"cached_tokens\": 0},\n    \"completion_tokens_details\": {\"reasoning_tokens\": 0}\n  }\n}\n```\n\n| 返回字段 | 类型 | 说明 |\n|---|---|---|\n| `id` | string | 消息唯一 ID |\n| `object` | string | `chat.completion` 或 `chat.completion.chunk`（流式） |\n| `created` | integer | Unix 时间戳（秒） |\n| `model` | string | 实际使用的模型 |\n| `choices[].message.content` | string | 模型回复文本（非流式） |\n| `choices[].delta.content` | string | 增量文本（流式） |\n| `choices[].message.reasoning_content` | string | 推理过程文本（仅推理模型） |\n| `choices[].message.tool_calls` | array | 工具调用（Function Calling 模式） |\n| `choices[].finish_reason` | string | `stop`（正常）/ `length`（超长截断）/ `tool_calls`（函数调用）/ `content_filter`（审核） |\n| `usage.prompt_tokens` | integer | 输入 token 数 |\n| `usage.completion_tokens` | integer | 输出 token 数 |\n| `usage.prompt_tokens_details.cached_tokens` | integer | 缓存命中 token 数（省钱） |\n| `usage.completion_tokens_details.reasoning_tokens` | integer | 推理 token 数（仅推理模型） |\n\n### 5. 接入地址\n\n| 线路 | Base URL |\n|---|---|\n| 国内加速（推荐） | `https://iliu.ai` |\n| 海外直连 | `https://api.xinliu.one` |\n\n### 6. 错误码\n\n| 状态码 | 典型响应 | 原因 |\n|---|---|---|\n| `401` | `{\"error\":{\"message\":\"未提供令牌\"}}` | 令牌缺失或无效 |\n| `402` | — | 余额不足 |\n| `404` | `{\"error\":{\"code\":\"model_not_found\"}}` | 模型不存在或未开通 |\n| `429` | — | 速率限制（触发 RPM / TPM 上限） |\n| `503` | `{\"error\":{\"message\":\"No available channel for model ... under group xxx\"}}` | 令牌所在分组未开通该模型 |\n",
        "responses": {
          "200": {
            "description": "成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string"
                    },
                    "model": {
                      "type": "string"
                    },
                    "object": {
                      "type": "string"
                    },
                    "choices": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      }
                    },
                    "usage": {
                      "type": "object",
                      "properties": {}
                    }
                  }
                },
                "example": {
                  "id": "string",
                  "model": "string",
                  "object": "string",
                  "choices": [
                    "string"
                  ],
                  "usage": {}
                }
              }
            }
          }
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "model": {
                    "type": "string"
                  },
                  "messages": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "role": {
                          "type": "string"
                        },
                        "content": {
                          "type": "string"
                        }
                      }
                    }
                  },
                  "stream": {
                    "type": "boolean"
                  },
                  "temperature": {
                    "type": "integer"
                  },
                  "max_tokens": {
                    "type": "integer"
                  },
                  "top_p": {
                    "type": "integer"
                  },
                  "tools": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    }
                  },
                  "response_format": {
                    "type": "object",
                    "properties": {}
                  }
                }
              },
              "example": {
                "model": "string",
                "messages": [
                  {
                    "role": "system",
                    "content": "string"
                  }
                ],
                "stream": false,
                "temperature": 1,
                "max_tokens": 0,
                "top_p": 0,
                "tools": [
                  "string"
                ],
                "response_format": {}
              }
            }
          }
        }
      }
    },
    "/v1/chat/completions#gpt-5.6": {
      "post": {
        "tags": [
          "对话模型（新增）"
        ],
        "summary": "GPT-5.6 系列（gpt-5.6-luna / sol / terra）",
        "operationId": "op_chat_gpt56",
        "description": "### 1. 说明\n\nOpenAI **GPT-5.6** 最新旗舰**推理**系列。走通用 `POST /v1/chat/completions`（OpenAI 兼容），通过 `model` 字段切换。\n\n### 2. 可用型号（2026-07 实测）\n\n| model | 说明 | 状态 |\n|---|---|---|\n| `gpt-5.6` | 基础版 | ⚠️ `default` 分组无可用渠道（503 `model_not_found`） |\n| `gpt-5.6-luna` | Luna 变体 | ✅ 实测可用 |\n| `gpt-5.6-sol` | Sol 变体 | ✅ 实测可用 |\n| `gpt-5.6-terra` | Terra 变体 | ✅ 实测可用 |\n\n### 3. 请求参数\n\n与通用对话接口一致：`model`✅、`messages`✅、`stream`、`temperature`、`top_p`、`max_tokens`、`response_format`、`tools`、`tool_choice` 等。\n\n### 4. 实测要点\n\n- 为**推理模型**，返回 `usage.completion_tokens_details.reasoning_tokens`。\n- 已验证：`temperature` / `top_p` / `stream` / `response_format`(`json_object`) / `reasoning_effort`(`high`) / `system` 角色。\n- ⚠️ `max_tokens` 与 `max_completion_tokens` **被接受但不强制截断**输出。\n- 上游为 OpenAI Responses API，响应 `id` 形如 `resp_...`，仍以标准 Chat Completions 结构返回。\n\n\n### 接入地址\n\n| 线路 | Base URL |\n|---|---|\n| 国内加速（推荐） | `https://iliu.ai` |\n| 海外直连（实测可用） | `https://api.xinliu.one` |\n",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "model": {
                    "type": "string"
                  },
                  "messages": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "role": {
                          "type": "string"
                        },
                        "content": {
                          "type": "string"
                        }
                      }
                    }
                  },
                  "stream": {
                    "type": "boolean"
                  },
                  "temperature": {
                    "type": "number"
                  },
                  "top_p": {
                    "type": "number"
                  },
                  "max_tokens": {
                    "type": "integer"
                  },
                  "response_format": {
                    "type": "object",
                    "properties": {}
                  }
                }
              },
              "example": {
                "model": "gpt-5.6-luna",
                "messages": [
                  {
                    "role": "user",
                    "content": "hi, reply with just: OK"
                  }
                ],
                "stream": false
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string"
                    },
                    "object": {
                      "type": "string"
                    },
                    "model": {
                      "type": "string"
                    },
                    "choices": {
                      "type": "array",
                      "items": {
                        "type": "object"
                      }
                    },
                    "usage": {
                      "type": "object"
                    }
                  }
                },
                "example": {
                  "id": "resp_xxx",
                  "object": "chat.completion",
                  "created": 1783994131,
                  "model": "gpt-5.6-luna",
                  "choices": [
                    {
                      "index": 0,
                      "message": {
                        "role": "assistant",
                        "content": "OK"
                      },
                      "finish_reason": "stop"
                    }
                  ],
                  "usage": {
                    "prompt_tokens": 24,
                    "completion_tokens": 1,
                    "total_tokens": 25,
                    "completion_tokens_details": {
                      "reasoning_tokens": 17
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/v1/chat/completions#claude-5": {
      "post": {
        "tags": [
          "对话模型（新增）"
        ],
        "summary": "Claude 5 系列（claude-sonnet-5 / claude-fable-5）",
        "operationId": "op_chat_claude5",
        "description": "### 1. 说明\n\nAnthropic **Claude 5** 系列（对话）。走 `POST /v1/chat/completions`（OpenAI 兼容）。\n\n### 2. 可用型号（2026-07 实测）\n\n| model | 说明 | 状态 |\n|---|---|---|\n| `claude-sonnet-5` | Claude Sonnet 5 | ✅ 实测可用 |\n| `claude-fable-5` | Claude Fable 5 | ✅ 实测可用 |\n| `claude-sonnet-4-8` | Claude Sonnet 4.8 | ⚠️ `default` 分组无可用渠道（503） |\n\n### 3. 请求参数\n\n与通用对话接口一致：`model`✅、`messages`✅、`stream`、`temperature`、`top_p`、`max_tokens`、`response_format`、`tools`、`tool_choice` 等。\n\n\n### 接入地址\n\n| 线路 | Base URL |\n|---|---|\n| 国内加速（推荐） | `https://iliu.ai` |\n| 海外直连（实测可用） | `https://api.xinliu.one` |\n",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "model": {
                    "type": "string"
                  },
                  "messages": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "role": {
                          "type": "string"
                        },
                        "content": {
                          "type": "string"
                        }
                      }
                    }
                  },
                  "stream": {
                    "type": "boolean"
                  },
                  "temperature": {
                    "type": "number"
                  },
                  "top_p": {
                    "type": "number"
                  },
                  "max_tokens": {
                    "type": "integer"
                  },
                  "response_format": {
                    "type": "object",
                    "properties": {}
                  }
                }
              },
              "example": {
                "model": "claude-sonnet-5",
                "messages": [
                  {
                    "role": "user",
                    "content": "hi, reply with just: OK"
                  }
                ],
                "stream": false
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string"
                    },
                    "object": {
                      "type": "string"
                    },
                    "model": {
                      "type": "string"
                    },
                    "choices": {
                      "type": "array",
                      "items": {
                        "type": "object"
                      }
                    },
                    "usage": {
                      "type": "object"
                    }
                  }
                },
                "example": {
                  "id": "msg_xxx",
                  "object": "chat.completion",
                  "created": 1783994131,
                  "model": "claude-sonnet-5",
                  "choices": [
                    {
                      "index": 0,
                      "message": {
                        "role": "assistant",
                        "content": "OK"
                      },
                      "finish_reason": "stop"
                    }
                  ],
                  "usage": {
                    "prompt_tokens": 24,
                    "completion_tokens": 1,
                    "total_tokens": 25,
                    "completion_tokens_details": {}
                  }
                }
              }
            }
          }
        }
      }
    },
    "/v1/chat/completions#glm-5.2": {
      "post": {
        "tags": [
          "对话模型（新增）"
        ],
        "summary": "GLM-5.2（对话 · 推理）",
        "operationId": "op_chat_glm52",
        "description": "### 1. 说明\n\n智谱 **GLM-5.2**（对话，**推理模型**）。走 `POST /v1/chat/completions`。\n\n### 2. 可用型号（2026-07 实测）\n\n| model | 说明 | 状态 |\n|---|---|---|\n| `glm-5.2` | GLM-5.2 | ✅ 实测可用（返回 `reasoning_tokens`） |\n\n### 3. 请求参数\n\n与通用对话接口一致：`model`✅、`messages`✅、`stream`、`temperature`、`top_p`、`max_tokens`、`response_format`、`tools`、`tool_choice` 等。\n\n### 4. 实测要点\n\n- 推理模型，返回 `usage.completion_tokens_details.reasoning_tokens`。\n\n\n### 接入地址\n\n| 线路 | Base URL |\n|---|---|\n| 国内加速（推荐） | `https://iliu.ai` |\n| 海外直连（实测可用） | `https://api.xinliu.one` |\n",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "model": {
                    "type": "string"
                  },
                  "messages": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "role": {
                          "type": "string"
                        },
                        "content": {
                          "type": "string"
                        }
                      }
                    }
                  },
                  "stream": {
                    "type": "boolean"
                  },
                  "temperature": {
                    "type": "number"
                  },
                  "top_p": {
                    "type": "number"
                  },
                  "max_tokens": {
                    "type": "integer"
                  },
                  "response_format": {
                    "type": "object",
                    "properties": {}
                  }
                }
              },
              "example": {
                "model": "glm-5.2",
                "messages": [
                  {
                    "role": "user",
                    "content": "hi, reply with just: OK"
                  }
                ],
                "stream": false
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string"
                    },
                    "object": {
                      "type": "string"
                    },
                    "model": {
                      "type": "string"
                    },
                    "choices": {
                      "type": "array",
                      "items": {
                        "type": "object"
                      }
                    },
                    "usage": {
                      "type": "object"
                    }
                  }
                },
                "example": {
                  "id": "msg_xxx",
                  "object": "chat.completion",
                  "created": 1783994131,
                  "model": "glm-5.2",
                  "choices": [
                    {
                      "index": 0,
                      "message": {
                        "role": "assistant",
                        "content": "OK"
                      },
                      "finish_reason": "stop"
                    }
                  ],
                  "usage": {
                    "prompt_tokens": 24,
                    "completion_tokens": 1,
                    "total_tokens": 25,
                    "completion_tokens_details": {
                      "reasoning_tokens": 17
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/v1/chat/completions#qwen3.6-plus": {
      "post": {
        "tags": [
          "对话模型（新增）"
        ],
        "summary": "Qwen 3.6-plus（对话 · 推理）",
        "operationId": "op_chat_qwen36plus",
        "description": "### 1. 说明\n\n通义千问 **Qwen 3.6-plus**（对话，**推理模型**）。走 `POST /v1/chat/completions`。\n\n### 2. 可用型号（2026-07 实测）\n\n| model | 说明 | 状态 |\n|---|---|---|\n| `qwen3.6-plus` | Qwen 3.6-plus | ✅ 实测可用（返回 `reasoning_tokens`） |\n| `qwen3.6-max-preview` | Qwen 3.6-max preview | ⏳ 429 上游饱和，稍后重试 |\n| `qwen3.7-plus` | Qwen 3.7-plus | ⏳ 429 上游饱和，稍后重试 |\n\n### 3. 请求参数\n\n与通用对话接口一致：`model`✅、`messages`✅、`stream`、`temperature`、`top_p`、`max_tokens`、`response_format`、`tools`、`tool_choice` 等。\n\n### 4. 实测要点\n\n- `qwen3.6-plus` 为推理模型，返回 `reasoning_tokens`。\n- `qwen3.6-max-preview` / `qwen3.7-plus` 提交时返回 429（上游负载饱和），模型存在，择时重试可用。\n\n\n### 接入地址\n\n| 线路 | Base URL |\n|---|---|\n| 国内加速（推荐） | `https://iliu.ai` |\n| 海外直连（实测可用） | `https://api.xinliu.one` |\n",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "model": {
                    "type": "string"
                  },
                  "messages": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "role": {
                          "type": "string"
                        },
                        "content": {
                          "type": "string"
                        }
                      }
                    }
                  },
                  "stream": {
                    "type": "boolean"
                  },
                  "temperature": {
                    "type": "number"
                  },
                  "top_p": {
                    "type": "number"
                  },
                  "max_tokens": {
                    "type": "integer"
                  },
                  "response_format": {
                    "type": "object",
                    "properties": {}
                  }
                }
              },
              "example": {
                "model": "qwen3.6-plus",
                "messages": [
                  {
                    "role": "user",
                    "content": "hi, reply with just: OK"
                  }
                ],
                "stream": false
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string"
                    },
                    "object": {
                      "type": "string"
                    },
                    "model": {
                      "type": "string"
                    },
                    "choices": {
                      "type": "array",
                      "items": {
                        "type": "object"
                      }
                    },
                    "usage": {
                      "type": "object"
                    }
                  }
                },
                "example": {
                  "id": "msg_xxx",
                  "object": "chat.completion",
                  "created": 1783994131,
                  "model": "qwen3.6-plus",
                  "choices": [
                    {
                      "index": 0,
                      "message": {
                        "role": "assistant",
                        "content": "OK"
                      },
                      "finish_reason": "stop"
                    }
                  ],
                  "usage": {
                    "prompt_tokens": 24,
                    "completion_tokens": 1,
                    "total_tokens": 25,
                    "completion_tokens_details": {
                      "reasoning_tokens": 17
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/v1/chat/completions#kimi-k2.5": {
      "post": {
        "tags": [
          "月之暗面"
        ],
        "summary": "Kimi K2.5（对话 · 月之暗面）",
        "operationId": "op_chat_kimi",
        "description": "### 1. 说明\n\n月之暗面 **Kimi K2.5**（对话，原生多模态旗舰）。走 `POST /v1/chat/completions`，兼容 OpenAI 协议。\n\n### 2. 可用型号\n\n| model | 说明 | 状态 |\n|---|---|---|\n| `kimi-k2.5` | Kimi K2.5，原生多模态旗舰（视觉+文本、思考/非思考、Agent） | ⚠️ `low` 分组专属；`default` Key 返回「无可用渠道」，开通 low 分组后可用 |\n| `kimi-k2.5-20260127` | Kimi K2.5 Cursor 专用版（防与自带模型 id 冲突） | ⚠️ `low` 分组专属 |\n\n### 3. 请求参数\n\n与通用对话接口一致：`model`✅、`messages`✅、`stream`、`temperature`、`top_p`、`max_tokens`、`response_format`、`tools`、`tool_choice` 等。\n\n### 4. 特性\n\n- **超长上下文**：百万 token 级，适合长文档处理。\n- **多模态**：同时支持视觉与文本输入、思考与非思考模式。\n- **Agent 能力**：支持对话与 Agent 任务。\n- **Cursor 专属**：`kimi-k2.5-20260127` 为 Cursor 编辑器专用模型 id。\n\n> ⚠️ Kimi 系列属于 `low` 分组，调用前确认 Key 已开通此分组（default 分组返回 `model_not_found` / 无可用渠道）。\n\n### 接入地址\n\n| 线路 | Base URL |\n|---|---|\n| 国内加速（推荐） | `https://iliu.ai` |\n| 海外直连 | `https://api.xinliu.one` |\n",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "model": {
                    "type": "string"
                  },
                  "messages": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "role": {
                          "type": "string"
                        },
                        "content": {
                          "type": "string"
                        }
                      }
                    }
                  },
                  "stream": {
                    "type": "boolean"
                  },
                  "temperature": {
                    "type": "number"
                  },
                  "top_p": {
                    "type": "number"
                  },
                  "max_tokens": {
                    "type": "integer"
                  },
                  "response_format": {
                    "type": "object",
                    "properties": {}
                  }
                }
              },
              "example": {
                "model": "kimi-k2.5",
                "messages": [
                  {
                    "role": "user",
                    "content": "总结这篇 10 万字的论文要点"
                  }
                ],
                "stream": false
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string"
                    },
                    "object": {
                      "type": "string"
                    },
                    "model": {
                      "type": "string"
                    },
                    "choices": {
                      "type": "array",
                      "items": {
                        "type": "object"
                      }
                    },
                    "usage": {
                      "type": "object"
                    }
                  }
                },
                "example": {
                  "id": "chatcmpl-xxx",
                  "object": "chat.completion",
                  "created": 1783994131,
                  "model": "kimi-k2.5",
                  "choices": [
                    {
                      "index": 0,
                      "message": {
                        "role": "assistant",
                        "content": "论文要点如下……"
                      },
                      "finish_reason": "stop"
                    }
                  ],
                  "usage": {
                    "prompt_tokens": 128,
                    "completion_tokens": 96,
                    "total_tokens": 224
                  }
                }
              }
            }
          }
        }
      }
    },
    "/v1/chat/completions#codex-auto-review": {
      "post": {
        "tags": [
          "对话模型（新增）"
        ],
        "summary": "Codex Auto Review（对话）",
        "operationId": "op_chat_codex_review",
        "description": "### 1. 说明\n\nOpenAI **Codex Auto Review**（对话）。走 `POST /v1/chat/completions`。\n\n### 2. 可用型号（2026-07 实测）\n\n| model | 说明 | 状态 |\n|---|---|---|\n| `codex-auto-review` | Codex 自动代码审查 | ✅ 实测可用 |\n\n### 3. 请求参数\n\n与通用对话接口一致：`model`✅、`messages`✅、`stream`、`temperature`、`top_p`、`max_tokens`、`response_format`、`tools`、`tool_choice` 等。\n\n\n### 接入地址\n\n| 线路 | Base URL |\n|---|---|\n| 国内加速（推荐） | `https://iliu.ai` |\n| 海外直连（实测可用） | `https://api.xinliu.one` |\n",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "model": {
                    "type": "string"
                  },
                  "messages": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "role": {
                          "type": "string"
                        },
                        "content": {
                          "type": "string"
                        }
                      }
                    }
                  },
                  "stream": {
                    "type": "boolean"
                  },
                  "temperature": {
                    "type": "number"
                  },
                  "top_p": {
                    "type": "number"
                  },
                  "max_tokens": {
                    "type": "integer"
                  },
                  "response_format": {
                    "type": "object",
                    "properties": {}
                  }
                }
              },
              "example": {
                "model": "codex-auto-review",
                "messages": [
                  {
                    "role": "user",
                    "content": "hi, reply with just: OK"
                  }
                ],
                "stream": false
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string"
                    },
                    "object": {
                      "type": "string"
                    },
                    "model": {
                      "type": "string"
                    },
                    "choices": {
                      "type": "array",
                      "items": {
                        "type": "object"
                      }
                    },
                    "usage": {
                      "type": "object"
                    }
                  }
                },
                "example": {
                  "id": "msg_xxx",
                  "object": "chat.completion",
                  "created": 1783994131,
                  "model": "codex-auto-review",
                  "choices": [
                    {
                      "index": 0,
                      "message": {
                        "role": "assistant",
                        "content": "OK"
                      },
                      "finish_reason": "stop"
                    }
                  ],
                  "usage": {
                    "prompt_tokens": 24,
                    "completion_tokens": 1,
                    "total_tokens": 25,
                    "completion_tokens_details": {}
                  }
                }
              }
            }
          }
        }
      }
    },
    "/v1/models#全模型目录": {
      "get": {
        "tags": [
          "模型参考"
        ],
        "summary": "模型参考 · 全模型目录（136 个在售模型 · 按厂商分组）",
        "operationId": "op_ref_catalog",
        "description": "> 📖 本条目为**模型参考文档**（非可调用端点）。所有模型经 `GET /v1/models` 可查当前 Key 实际可用列表。\n\n> 数据以 [模型广场](https://iliu.ai/pricing) 为准。\n\n---\n\n# 全模型目录（136 个模型）\n\n心流平台全部 **136 个在售模型**，按类别和厂商分组，数据对齐 [模型广场](https://iliu.ai/pricing)。\n\n> 💡 调用 `GET /v1/models` 获取当前 Key 可用的全部模型及元信息。能否调用取决于 Key 所在分组是否包含该模型的 `enable_groups`。\n\n> ⚠️ 本目录对齐价格页在售清单；**部分新上架模型价格可能尚未由管理员配置**，调用时返回 `400 模型 xxx 的价格尚未配置` 即属此类，请联系客服开启后再用。\n\n---\n\n## 语言大模型（96 个）\n\n### OpenAI（22 个）\n\n| model | 说明 | 端点类型 | enable_groups |\n|---|---|---|---|\n| `gpt-4o-audio-preview` |  | `openai` | `codex pro,default,low` |\n| `gpt-4o-mini` | GPT-4o mini 是由 openai 提供的人工智能模型。 | `openai` | `default` |\n| `gpt-4o-realtime-preview` |  | `openai` | `codex pro,default,low` |\n| `gpt-5.2` | GPT-5.2适用于各行各业的编码和智能任务的最佳模型 | `openai-response,openai` | `codex pro,default,low` |\n| `gpt-5.2-2025-12-11` |  | `openai` | `codex pro,default,low` |\n| `gpt-5.2-chat-latest` |  | `openai` | `codex pro,default,low` |\n| `gpt-5.2-pro` |  | `openai` | `codex pro,default,low` |\n| `gpt-5.2-pro-2025-12-11` |  | `openai` | `low,codex pro,default` |\n| `gpt-5.3-codex` | codex | `openai,openai-response` | `codex pro,default,low` |\n| `gpt-5.3-codex-openai-compact` | gpt-5.3的紧凑上下文配置 | `openai,openai-response` | `default,low` |\n| `gpt-5.4` | GPT-5.4 是 OpenAI 于 2026 年 3 月 5 日 发布的新一代旗舰大模型，核心定位是从… | `openai-response,openai` | `codex pro,default,low` |\n| `gpt-5.4-2026-03-05` |  | `openai` | `codex pro,default,low` |\n| `gpt-5.4-mini` | GPT-5.4mini将GPT-5.4的优势融入到一个更快、更高效的模型中，专为高负载工作量设计。 | `openai,openai-response` | `codex pro,default,low` |\n| `gpt-5.4-nano` | GPT‑5.4 nano 是 GPT‑5.4 最轻量、最快速的版本，专为对速度和成本要求极高的任务而设计… | `openai-response,openai` | `default,low` |\n| `gpt-5.4-openai-compact` | gpt-5.4的紧凑上下文配置 | `openai,openai-response` | `codex pro,default,low` |\n| `gpt-5.5` | GPT-5.5是OpenAI于2026年4月24日发布的旗舰大语言模型，定位为面向实际工作与智能体的新型… | `openai,openai-response` | `low,codex pro,default` |\n| `gpt-5.5-openai-compact` |  | `openai` | `codex pro,default,low` |\n| `gpt-5.6` |  | `openai` | `codex pro` |\n| `gpt-5.6-luna` | GPT-5.6 Luna 主打低成本、大批量处理场景，对应早期 GPT-5 Nano 轻量化模型层级，兼… | `openai,openai-response` | `codex pro,default,low` |\n| `gpt-5.6-sol` | GPT-5.6 Sol 是 GPT-5.6 系列旗舰基础模型，对应初代 GPT-5 无后缀基线版本。别名… | `openai,openai-response` | `codex pro,default,low` |\n| `gpt-5.6-terra` | GPT-5.6 Terra 主打算力与成本均衡，对应早期 GPT-5 迷你模型层级，兼容 -high/-… | `openai,openai-response` | `codex pro,default,low` |\n| `gpt-oss-120b` | GPT OSS 120B 是由 vultr 提供的人工智能模型。 | `openai` | `default` |\n\n### Anthropic（27 个）\n\n| model | 说明 | 端点类型 | enable_groups |\n|---|---|---|---|\n| `claude-3-5-haiku-20241022` |  | `anthropic,openai` | `claude max` |\n| `claude-3-5-sonnet-20240620` |  | `anthropic,openai` | `claude max` |\n| `claude-3-5-sonnet-20241022` |  | `anthropic,openai` | `claude max` |\n| `claude-3-7-sonnet-20250219` |  | `anthropic,openai` | `claude max` |\n| `claude-fable-5` | Claude‑fable‑5 是 Anthropic 推出的公开可用的高性能大型语言模型，具备超长上下文… | `anthropic,openai` | `claude max,claude max 可外接,claude 官方直连,default,low` |\n| `claude-haiku-4-5` | Claude Haiku 4.5 是速度最快、性价比最高的模型，在编码、计算机使用和代理任务方面的表现与… | `openai,anthropic` | `claude max,claude max 可外接,default,low` |\n| `claude-haiku-4-5-20251001` | Claude Haiku 4.5 是速度最快、性价比最高的模型，在编码、计算机使用和代理任务方面的表现与… | `openai,anthropic` | `low,claude aws 企业,claude max,claude max 可外接,claude 官方直连,default` |\n| `claude-haiku-4-5-20251001-thinking` |  | `anthropic,openai` | `claude aws 企业,low` |\n| `claude-opus-4-1-20250805` |  | `anthropic,openai` | `claude 官方直连,claude aws 企业,claude max` |\n| `claude-opus-4-1-20250805-thinking` |  | `anthropic,openai` | `claude aws 企业` |\n| `claude-opus-4-5` |  | `anthropic,openai` | `low,default` |\n| `claude-opus-4-5-20251101` | Opus 4.5是人工智能系统能力的一次有意义的进步。 | `anthropic,openai` | `claude aws 企业,claude max,claude max 可外接,claude 官方直连,default,low` |\n| `claude-opus-4-5-20251101-thinking` |  | `anthropic,openai` | `low,claude aws 企业` |\n| `claude-opus-4-6` | Claude Opus 4.6 无需多言 | `openai,anthropic` | `claude 官方直连,default,low,claude aws 企业,claude max,claude max 可外接` |\n| `claude-opus-4-6-thinking` |  | `anthropic,openai` | `claude aws 企业,low` |\n| `claude-opus-4-7` | Claude Opus 4.7 是 Anthropic 于 2026 年 4 月 16 日 发布的最新一… | `anthropic,openai` | `default,low,claude aws 企业,claude max,claude max 可外接,claude 官方直连` |\n| `claude-opus-4-7-thinking` |  | `anthropic,openai` | `low` |\n| `claude-opus-4-8` | claude-opus-4-8 是目前 Anthropic 最强的“能一个人扛住长时间复杂工作的工具”，… | `OpenAi通用格式` | `low,claude aws 企业,claude max,claude max 可外接,claude 官方直连,default` |\n| `claude-opus-4-8-thinking` |  | `anthropic,openai` | `low` |\n| `claude-sonnet-4-20250514` |  | `anthropic,openai` | `claude max` |\n| `claude-sonnet-4-5-20250929` | Claude Sonnet 4.5 是构建复杂代理的最强大模型。它是使用计算机的最佳模型。它在推理和数学… | `anthropic,openai` | `claude aws 企业,claude max,claude max 可外接,claude 官方直连,default,low` |\n| `claude-sonnet-4-5-20250929-thinking` |  | `anthropic,openai` | `claude aws 企业,low` |\n| `claude-sonnet-4-6` | Claude Sonnet 4.6 可大规模提供前沿智能，专为编码、代理和企业工作流而打造。 | `openai,anthropic` | `claude aws 企业,claude max,claude max 可外接,claude 官方直连,default,low` |\n| `claude-sonnet-4-6-thinking` |  | `anthropic,openai` | `claude aws 企业,low` |\n| `claude-sonnet-4-8` |  | `anthropic,openai` | `low` |\n| `claude-sonnet-4-8-thinking` |  | `anthropic,openai` | `low` |\n| `claude-sonnet-5` | Claude Sonnet 5 默认支持 100 万令牌上下文窗口（100万 令牌既是默认也是最大值;没… | `anthropic` | `claude aws 企业,claude max,claude max 可外接,claude 官方直连,default,low` |\n\n### Google（15 个）\n\n| model | 说明 | 端点类型 | enable_groups |\n|---|---|---|---|\n| `gemini-2.0-flash` | Gemini 2.0 Flash 是由 google-vertex 提供的人工智能模型。 | `openai,gemini` | `gemini T3 稳定` |\n| `gemini-2.5-flash` | Gemini 2.5 Flash 是由 google-vertex 提供的人工智能模型。 | `gemini,openai` | `default,gemini Cli,gemini T3 稳定,gemini-officially` |\n| `gemini-2.5-flash-lite` |  | `gemini,openai` | `default,gemini Cli` |\n| `gemini-2.5-flash-nothinking` |  | `gemini,openai` | `default,gemini Cli` |\n| `gemini-2.5-pro` | Gemini 2.5 Pro ，擅长编码和复杂提示。通过“深度思考”，能在回应前进行推理，提升性能和准确… | `openai,gemini` | `gemini Cli,gemini T3 稳定,gemini-officially,default` |\n| `gemini-3-flash` | gemini-3-flash 兼具速度和前沿智能，并具备出色的搜索和接地能力。 | `openai,gemini` | `default,gemini Cli` |\n| `gemini-3-flash-preview` | Google Gemini 3 系列的 高性能快闪档，主打 Pro 级推理 + Flash 级速度与低成… | `openai,gemini` | `default,gemini Cli,gemini T3 稳定,gemini-officially` |\n| `gemini-3-flash-preview-thinking` | Google Gemini 3 Flash 预览版的推理增强变体，主打 “快速度 + 深思考” 的黄金平… | `openai,gemini` | `gemini T3 稳定` |\n| `gemini-3-pro-preview` | gemini-3-pro-preview 最适合需要广泛的世界知识和跨模态的高级推理的复杂任务 | `openai,gemini` | `gemini-officially,default,gemini Cli,gemini T3 稳定` |\n| `gemini-3-pro-preview-thinking` | Google Gemini 3 Pro 预览版中专门为深度逻辑推理优化的专家级模型变体（也常被称为 “思… | `gemini,openai` | `gemini T3 稳定` |\n| `gemini-3.1-flash-lite` |  | `gemini,openai` | `default,gemini Cli` |\n| `gemini-3.1-flash-lite-preview` |  | `gemini,openai` | `gemini Cli,default` |\n| `gemini-3.1-pro-20260219` |  | `gemini,openai` | `gemini Cli` |\n| `gemini-3.1-pro-preview` | Gemini 3.1 是谷歌迄今为止最智能的模型系列，以先进的推理能力为基础。它旨在通过掌握智能体工作流… | `openai,gemini` | `gemini Cli,gemini studio 企业级,gemini T3 稳定,gemini-officially,default` |\n| `gemini-3.5-flash` | Gemini 3.5 Flash 已正式发布 (GA)，性能稳定，可大规模用于生产环境。作为我们最智能的… | `openai,gemini` | `default,gemini Cli,gemini T3 稳定` |\n\n### DeepSeek（2 个）\n\n| model | 说明 | 端点类型 | enable_groups |\n|---|---|---|---|\n| `deepseek-v4-flash` | DeepSeek-V4-Flash 是DeepSeek V4系列的轻量化版本，主打高性价比与高吞吐效率，… | `OpenAi通用格式` | `default` |\n| `deepseek-v4-pro` | DeepSeek-V4-Pro 是DeepSeek推出的高性能开源大模型，具备顶尖推理与Agent能力，… | `openai` | `default` |\n\n### xAI（9 个）\n\n| model | 说明 | 端点类型 | enable_groups |\n|---|---|---|---|\n| `grok-4.1` | Grok 4.1（标准版） 即日常使用的极速模式，Thinking 为深度推理增强版 | `openai` | `low` |\n| `grok-4.1-thinking` | 主打长文本深度思考、高情商对话、实时信息整合，是 Grok 4.1 系列中负责复杂逻辑与高质量输出的核心… | `openai` | `low` |\n| `grok-4.20-auto` |  | `openai` | `low` |\n| `grok-4.20-beta` | Grok 4.1 Thinking 的全面升级版本，主打更强推理、更快速度、更低幻觉，同时保留实时联网能… | `openai` | `low` |\n| `grok-4.20-fast` |  | `openai` | `low` |\n| `grok-4.3` |  | `openai` | `low` |\n| `grok-4.5` |  | `openai` | `low` |\n| `grok-4.5-latest` |  | `openai` | `low` |\n| `grok-imagine-1.0-video-16s` |  | `openai` | `default` |\n\n### 智谱（4 个）\n\n| model | 说明 | 端点类型 | enable_groups |\n|---|---|---|---|\n| `glm-4.7` | GLM-4.7是智谱AI于2025年底推出的旗舰级开源大语言模型，定位为面向复杂推理、真实编码任务和智能… | `openai` | `default` |\n| `glm-5` | GLM-5 是智谱新一代的旗舰基座模型，面向 Agentic Engineering 打造，能够在复杂系… | `openai` | `default` |\n| `glm-5.1` | 在综合能力与 Coding 能力上，GLM-5.1 整体表现对齐 Claude Opus 4.6，并在长… | `openai` | `default` |\n| `glm-5.2` |  | `openai` | `default` |\n\n### Moonshot（2 个）\n\n| model | 说明 | 端点类型 | enable_groups |\n|---|---|---|---|\n| `kimi-k2.5` | 原生多模态架构设计，同时支持视觉与文本输入、思考与非思考模式、对话与Agent任务。 | `openai` | `low` |\n| `kimi-k2.5-20260127` | cursor软件专用模型id，防止跟自带模型id冲突 | `openai` | `low` |\n\n### 阿里巴巴（6 个）\n\n| model | 说明 | 端点类型 | enable_groups |\n|---|---|---|---|\n| `qwen-plus` | 通义千问超大规模语言模型，支持中文、英文等不同语言输入。适合文本创作、文本处理、编程辅助、翻译服务、对话… | `openai` | `default` |\n| `qwen3.5-plus` | wen3.5原生视觉语言系列Plus模型，基于混合架构设计，融合了线性注意力机制与稀疏混合专家模型，实现… | `openai` | `default` |\n| `qwen3.6-max-preview` | Qwen3.6系列中规模最大、综合能力最强的Max模型Preview版本，当前开放纯文本模型能力供体验。… | `OpenAi通用格式` | `default` |\n| `qwen3.6-plus` | Qwen3.6原生视觉语言系列Plus模型，展现出与当前顶尖前沿模型相媲美的卓越性能，模型效果相较3.5… | `openai` | `default` |\n| `qwen3.7-max` |  | `openai` | `default` |\n| `qwen3.7-plus` |  | `openai` | `default` |\n\n### Minimax（4 个）\n\n| model | 说明 | 端点类型 | enable_groups |\n|---|---|---|---|\n| `MiniMax-M2.5` | M2.5 在编程、工具调用和搜索、办公等生产力场景都达到或者刷新了行业的 SOTA，比如 SWE-Ben… | `openai` | `low` |\n| `MiniMax-M2.5-highspeed` | MiniMax-M2.5-highspeed 是 MiniMax M2.5 系列的高速推理档位，核心定位… | `openai` | `low` |\n| `MiniMax-M2.7` | MiniMax-M2.7 是 MiniMax 于 2026 年 3 月推出的旗舰级闭源大模型，主打自我进… | `openai` | `default,low` |\n| `MiniMax-M2.7-highspeed` | MiniMax-M2.7-highspeed 是 MiniMax M2.7 系列的高速推理档位，核心定位… | `openai` | `low` |\n\n### Xiaomi MiMo（3 个）\n\n| model | 说明 | 端点类型 | enable_groups |\n|---|---|---|---|\n| `mimo-v2-pro` | 小米MiMo-V2-Pro专为要求严格的真实代理工作流程设计。其总参数超过1T，激活参数42B，采用创新… | `OpenAi通用格式` | `default` |\n| `mimo-v2.5` | MiMo-V2.5， 原生全模态模型，支持文本、图像、视频和音频理解，具备强大的 Agent 能力 | `OpenAi通用格式` | `default` |\n| `mimo-v2.5-pro` | MiMo-V2.5-Pro，面向复杂的任务场景，深度适配 Agent 与 Coding 应用，在 GDP… | `OpenAi通用格式` | `default` |\n\n### 讯飞（1 个）\n\n| model | 说明 | 端点类型 | enable_groups |\n|---|---|---|---|\n| `gpt-5.3-codex-spark` |  | `openai` | `codex pro,default,low` |\n\n### 其他（1 个）\n\n| model | 说明 | 端点类型 | enable_groups |\n|---|---|---|---|\n| `codex-auto-review` |  | `openai` | `codex pro,default,low` |\n\n---\n\n## 图像模型（13 个）\n\n### OpenAI（4 个）\n\n| model | 说明 | 端点类型 | enable_groups |\n|---|---|---|---|\n| `gpt-image-2` | AI 图像生成的 “iPhone 时刻” | `openai编辑图片,image-generation` | `default,low,优质image2` |\n| `gpt-image-2-4K` | image2单独的4k版本 | `openai编辑图片,image-generation` | `default` |\n| `gpt-image-2-4k` |  | `openai` | `default` |\n| `gpt-image-2-pro` | image2 pro | `openai编辑图片,image-generation` | `default,low` |\n\n### Google（4 个）\n\n| model | 说明 | 端点类型 | enable_groups |\n|---|---|---|---|\n| `gemini-2.5-flash-image` |  | `gemini,openai` | `gemini-officially` |\n| `gemini-2.5-flash-image-preview` | Nano Banana （香蕉） | `openai,gemini` | `default,gemini 优质香蕉,ultra` |\n| `gemini-3-pro-image-preview` | Nano Banana （香蕉）pro | `gemini,openai` | `ultra,default,gemini 优质香蕉` |\n| `gemini-3.1-flash-image-preview` | Nano Banana （香蕉）2 | `openai,gemini` | `gemini 优质香蕉,gemini-officially,ultra,default` |\n\n### xAI（2 个）\n\n| model | 说明 | 端点类型 | enable_groups |\n|---|---|---|---|\n| `grok-imagine-image` | X平台推出的多模态AI模型，能够根据文本描述生成高质量图像 | `dall-e-3` | `default` |\n| `grok-imagine-image-pro` | X平台推出的多模态AI模型，能够根据文本描述生成高质量图像 | `dall-e-3,OpenAi通用格式` | `default` |\n\n### 字节跳动（3 个）\n\n| model | 说明 | 端点类型 | enable_groups |\n|---|---|---|---|\n| `doubao-seedream-4-0-250828` | 字节跳动发布的最新图像创作模型 | `OpenAi通用格式` | `default` |\n| `doubao-seedream-4-5-251128` | 字节跳动发布的最新图像创作模型 | `OpenAi通用格式` | `default` |\n| `doubao-seedream-5-0-260128` | 字节跳动发布的最新图像创作模型 | `OpenAi通用格式` | `default` |\n\n---\n\n## 视频模型（27 个）\n\n### OpenAI（3 个）\n\n| model | 说明 | 端点类型 | enable_groups |\n|---|---|---|---|\n| `sora-2` | 4s | `OpenAi通用视频格式` | `default` |\n| `sora-2-12s` | 12s | `OpenAi通用视频格式` | `官转,default` |\n| `sora-2-openai-12s` | sora 官 | `OpenAi通用视频格式` | `default,low` |\n\n### Google（11 个）\n\n| model | 说明 | 端点类型 | enable_groups |\n|---|---|---|---|\n| `omni_flash` | 10s | `OpenAi通用视频格式` | `default,官转` |\n| `omni_flash-10s` | 支持7张参考图 支持视频修改 10s | `OpenAi通用视频格式` | `default` |\n| `omni_flash-v2v` | 视频编辑 上传视频url | `OpenAi通用视频格式` | `default,官转` |\n| `omni_flash_nowater` | 通用版 Gemini Omni Flash 去水印定制 | `OpenAi通用格式` | `default,官转` |\n| `omni_flash_nowater-v2v` | omni视频改视频的去水印专用分支 | `OpenAi通用格式` | `default,官转` |\n| `veo_3_1-4K` | veo 4k 高质量模式 文生视频 多参考图生视频专用 | `OpenAi通用视频格式` | `官转` |\n| `veo_3_1-fast` | veo 720p 快速模式 文生视频 多参考图生视频专用 | `OpenAi通用视频格式` | `default,官转` |\n| `veo_3_1-fast-fl` | veo 720p 快速模式 首尾帧生视频专用 | `OpenAi通用视频格式` | `default,官转` |\n| `veo_3_1-fast-fl-hd` | veo 1080P 快速模式 首尾帧图生视频专用 | `OpenAi通用视频格式` | `default` |\n| `veo_3_1-lite` | Veo参考图模式，支持3图参考，轻量 | `OpenAi通用视频格式` | `default` |\n| `veo_3_1-lite-fl` | veo首尾帧模式-轻量 | `OpenAi通用视频格式` | `default` |\n\n### xAI（8 个）\n\n| model | 说明 | 端点类型 | enable_groups |\n|---|---|---|---|\n| `grok-imagine-1.0-video` | 支持6s 10s Grok Imagine 1.0 多模态模型的异步视频生成 | `OpenAi通用视频格式` | `low,default,grok 官方直连` |\n| `grok-imagine-video` |  | `openai` | `low,default` |\n| `grok-imagine-video-1.5-1080p` |  | `openai` | `default` |\n| `grok-imagine-video-1.5-fast` | 1.5 多参版本 10s | `OpenAi通用视频格式` | `default` |\n| `grok-imagine-video-1.5-fast-16s` |  | `openai` | `default` |\n| `grok-imagine-video-1.5-preview` | 不支持文生视频 720p 只支持单图 15s 提示词长度4096 不能超出 | `OpenAi通用视频格式` | `default,grok1.5官方直连` |\n| `grok-imagine-video-preview` | 备用 支持文生 图生 单参 | `OpenAi通用视频格式` | `default` |\n| `grok-video-10s` | 10s 普通分组返回base64 视频用 GET /v1/videos/{task_id}/conten… | `OpenAi通用视频格式` | `default` |\n\n### 快手可灵（1 个）\n\n| model | 说明 | 端点类型 | enable_groups |\n|---|---|---|---|\n| `kling-motion-control` | Kling 2.6 Motion Control AI 运动转移技术 — 真实动作，精准控制 将参考视频… | `动作控制` | `default` |\n\n### 其他（4 个）\n\n| model | 说明 | 端点类型 | enable_groups |\n|---|---|---|---|\n| `omni-flash-10s` |  | `openai` | `default` |\n| `sora-v3-933-fast` |  | `openai` | `default` |\n| `sora-v3-933-pro` |  | `openai` | `default` |\n| `sora-v3-933-pro-480p` |  | `openai` | `default` |\n\n---\n\n## ⚠️ 已停用 / 已下架（14 个）\n\n> 以下模型曾收录于文档，但**已不在 [模型广场](https://iliu.ai/pricing) 在售清单**，可能已被新版本替代。保留于此仅供历史查阅，**不建议在生产中调用**。\n\n| 已停用 model | 建议替代 |\n|---|---|\n| `gpt-5.2-codex` | 见上方在售清单同厂商新版本 |\n| `gpt-5.1` | 见上方在售清单同厂商新版本 |\n| `gpt-5.1-codex-mini` | 见上方在售清单同厂商新版本 |\n| `gpt-5.1-codex` | 见上方在售清单同厂商新版本 |\n| `gpt-5` | 见上方在售清单同厂商新版本 |\n| `gpt-5.1-codex-max` | 见上方在售清单同厂商新版本 |\n| `gpt-image-2-vip` | 见上方在售清单同厂商新版本 |\n| `gpt-image-2-2026-04-21` | 见上方在售清单同厂商新版本 |\n| `grok-imagine-image-edit` | 见上方在售清单同厂商新版本 |\n| `veo_3_1-fl` | 见上方在售清单同厂商新版本 |\n| `veo_3_1-hd` | 见上方在售清单同厂商新版本 |\n| `veo_3_1-hd-fl` | 见上方在售清单同厂商新版本 |\n| `veo_3_1` | 见上方在售清单同厂商新版本 |\n| `grok-video-3-max` | 见上方在售清单同厂商新版本 |\n\n---\n\n## 端点类型说明\n\n| 端点类型 | 对应接口 | 适用模型 |\n|---|---|---|\n| `openai` | `POST /v1/chat/completions` | 对话 / 部分图像 / 部分视频 |\n| `openai-response` | `POST /v1/responses` | GPT-5 系 Responses API |\n| `anthropic` | `POST /v1/messages` | Claude 原生 |\n| `gemini` | `POST /v1beta/models/{model}:generateContent` | Gemini 原生 + Nano Banana |\n| `image-generation` | `POST /v1/images/generations` | GPT Image 2 |\n| `openai编辑图片` | `POST /v1/images/edits` | GPT Image 2 图生图 |\n| `dall-e-3` | `POST /v1/images/generations` | Grok Imagine |\n| `OpenAi通用格式` | `POST /v1/chat/completions` | Claude / MiMo / Seedream / DeepSeek Flash 等 |\n| `OpenAi通用视频格式` | `POST /v1/videos` | Veo / Sora / Grok Video / Omni 等 |\n| `动作控制` | `POST kling/v1/videos/motion-control` | Kling Motion Control |\n\n## 分组说明\n\n模型能否调用取决于你的 Key 所在分组是否包含该模型的 `enable_groups`。分组不匹配时返回：\n```\nNo available channel for model xxx under group xxx (distributor)\n```\n→ 联系客服切换分组。常用分组：`default`（覆盖最多模型）、`low`（低价）、`官转`/`openai官`/`claude 官方直连`（原厂直连）。\n\n完整分组列表见「帮助中心 → 模型分组与倍率说明」。\n",
        "responses": {
          "200": {
            "description": "参考文档（非可调用端点，仅供查阅）"
          }
        }
      }
    },
    "/v1/models#参数速查表": {
      "get": {
        "tags": [
          "模型参考"
        ],
        "summary": "模型参考 · 全模型参数速查表（请求参数 / 返回字段矩阵）",
        "operationId": "op_ref_params",
        "description": "> 📖 本条目为**模型参考文档**（非可调用端点）。所有模型经 `GET /v1/models` 可查当前 Key 实际可用列表。\n\n> 数据以 [模型广场](http://1.14.137.137/pricing) 为准。\n\n---\n\n按模型族列出所有支持的**请求参数**和**返回字段**。✅=支持 ❌=不支持 ⚠️=接受但不生效 —=不适用\n\n> 数据：模型广场 + `probe2` 301 实测样本\n\n---\n\n## 一、对话模型 · POST /v1/chat/completions\n\n### 1.1 请求参数 — GPT / Claude / Gemini\n\n| 参数 | GPT 5.x | Claude 4.x | Gemini 3.x |\n|---|---|---|---|\n| `model` | ✅ | ✅ | ✅ |\n| `messages` | ✅ | ✅ | ✅ |\n| `stream` | ✅ | ✅ | ✅ |\n| `temperature` | ✅ 0~2 | ✅ 0~1 | ✅ 0~2 |\n| `max_tokens` | ✅ | ✅ | ✅ |\n| `top_p` | ✅ | ✅ | ✅ |\n| `tools` | ✅ | ✅（OpenAI兼容） | ✅ |\n| `response_format` | ✅ json_object | ✅ | ✅ |\n| `n` | ⚠️ 部分支持 | ❌ 仅1 | ⚠️ |\n| `stop` | ✅ | ✅ | ✅ |\n| `presence_penalty` | ✅ | ❌ | ❌ |\n| `frequency_penalty` | ✅ | ❌ | ❌ |\n| `user` | ✅ | ✅ | ✅ |\n\n### 1.2 请求参数 — 其他厂商\n\n| 参数 | DeepSeek V4 | Grok 4.x | Qwen 3.x | GLM 5.x | Kimi K2.5 | MiniMax M2.x | MiMo V2.x |\n|---|---|---|---|---|---|---|---|\n| `model` | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |\n| `messages` | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |\n| `stream` | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |\n| `temperature` | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |\n| `max_tokens` | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |\n| `top_p` | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |\n| `tools` | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |\n| `response_format` | ⚠️ | ⚠️ | ⚠️ | ⚠️ | ⚠️ | ⚠️ | ⚠️ |\n| `stop` | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |\n| `presence_penalty` | ✅ | ❌ | ✅ | ❌ | ❌ | ❌ | ❌ |\n| `frequency_penalty` | ✅ | ❌ | ✅ | ❌ | ❌ | ❌ | ❌ |\n\n### 1.3 返回字段\n\n| 字段 | 所有对话模型 | 推理类模型特有 |\n|---|---|---|\n| `id` | ✅ | ✅ |\n| `object` | ✅ | ✅ |\n| `created` | ✅ | ✅ |\n| `model` | ✅ | ✅ |\n| `choices[].index` | ✅ | ✅ |\n| `choices[].message.role` | ✅ | ✅ |\n| `choices[].message.content` | ✅ | ✅ |\n| `choices[].message.reasoning_content` | ❌ | ✅ 推理过程文本 |\n| `choices[].message.tool_calls` | ✅（Function Calling时） | ✅ |\n| `choices[].finish_reason` | ✅ | ✅ |\n| `usage.prompt_tokens` | ✅ | ✅ |\n| `usage.completion_tokens` | ✅ | ✅ |\n| `usage.total_tokens` | ✅ | ✅ |\n| `usage.prompt_tokens_details.cached_tokens` | ⚠️ GPT 5.2+ | ⚠️ |\n| `usage.completion_tokens_details.reasoning_tokens` | ❌ | ✅ 推理token数 |\n\n> 推理类模型：`gpt-5.4` `gpt-5.5` `claude-opus-4-*` `claude-sonnet-4-*` `gemini-3-pro-preview` `gemini-2.5-pro` `deepseek-v4-pro` `grok-4.1-thinking` `glm-5.1` `kimi-k2.5`\n\n### 1.4 finish_reason 枚举\n\n| 值 | 含义 |\n|---|---|\n| `stop` | 正常结束 |\n| `length` | 达到 max_tokens 上限 |\n| `tool_calls` | 模型请求工具调用 |\n| `content_filter` | 内容审核拦截 |\n\n---\n\n## 二、图像模型 · POST /v1/images/generations\n\n### 2.1 请求参数\n\n| 参数 | GPT Image 2 | Grok Imagine | Seedream 4.0 | Seedream 4.5 | Seedream 5.0 | Nano Banana |\n|---|---|---|---|---|---|---|\n| `model` | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |\n| `prompt` | ✅ max 4000c | ✅ | ✅ | ✅ | ✅ | ✅ |\n| `n` | ⚠️ 仅1张 | ✅ 1~4 | ✅ 1~4 | ✅ 1~4 | ✅ 1~4 | ❌ |\n| `size` | ✅ 白名单 | ✅ 3种 | ✅ WxH ≥921600 | ✅ ≥3686400 | ✅ 档位关键字 | ❌ |\n| `quality` | ✅ 4档 | ❌ | ❌ | ❌ | ❌ | ❌ |\n| `background` | ✅ 3种 | ❌ | ❌ | ❌ | ❌ | ❌ |\n| `output_format` | ✅ 3种 | ❌ | ⚠️ 仅png | ⚠️ 仅png | ⚠️ 仅png | ❌ |\n| `response_format` | ✅ url | ✅ url/b64 | ❌ 仅url | ❌ 仅url | ❌ 仅url | ❌ |\n\n### 2.2 Seedream size 实测\n\n| 请求值 | 4.0 (250828) | 4.5 (251128) | 5.0 (260128) |\n|---|---|---|---|\n| `512x512` | ❌ min 921600px | ❌ min 3686400px | 🔁 → `2k` |\n| `1024x1024` | ✅ 4096 tokens | ❌ | 🔁 → `2k` |\n| `1536x1024` | ✅ 6144 tokens | ❌ | 🔁 |\n| `2048x2048` | ✅ 16384 tokens | ✅ 16384 tokens | ⚠️ 空返回 |\n| `3840x2160` | ✅ 32400 tokens | ✅ 32400 tokens | ✅ 17800 tokens |\n| `auto` / aspect | ❌ | ❌ | 🔁 |\n\n### 2.3 返回字段\n\n| 字段 | GPT Image 2 | Grok Imagine | Seedream 4.x | Seedream 5.0 | Nano Banana |\n|---|---|---|---|---|---|\n| `data[].url` | ✅ 1~24h | ✅ url模式 | ✅ TOS 24h | ✅ TOS 24h | ❌ |\n| `data[].b64_json` | ⚠️ 编辑接口 | ✅ b64模式 | ❌ | ❌ | ✅ inlineData |\n| `data[].size` | ❌ | ❌ | ❌ | ✅ | ❌ |\n| `created` | ✅ | ✅ | ✅ | ✅ | ❌ |\n| `usage.output_tokens` | ✅ | ❌ | ✅ 按像素 | ✅ 固定17800 | ✅ |\n| `usage.total_tokens` | ✅ | ✅ 固定16384 | ✅ | ✅ | ✅ |\n| `usage.generated_images` | ❌ | ❌ | ❌ | ✅ | ❌ |\n\n---\n\n## 三、图像编辑 · POST /v1/images/edits\n\n### 3.1 请求参数\n\n| 参数 | GPT Image 2 / Pro | 说明 |\n|---|---|---|\n| `model` | ✅ | `gpt-image-2` / `gpt-image-2-pro` / `gpt-image-2-2026-04-21` |\n| `prompt` | ✅ | max 32000 字符 |\n| `image` | ✅ | **文件上传**(≤50MB)，可重复传入实现多图 |\n| `mask` | ✅ | PNG，透明区=编辑区 |\n| `n` | ⚠️ | 仅1张 |\n| `size` | ✅ | `1024x1024`/`1536x1024`/`1024x1536`/`2048x2048`/`auto` |\n| `quality` | ✅ | `low`/`medium`/`high`/`auto` |\n| `background` | ✅ | `opaque`/`transparent`（仅Pro）/`auto` |\n| `output_format` | ✅ | `png`/`webp`/`jpeg` |\n| `output_compression` | ✅ | 0~100（仅 webp/jpeg） |\n| `moderation` | ✅ | `auto`/`low` |\n| `input_fidelity` | ✅ | `low`/`high` |\n| `stream` | ✅ | `false`/`true` |\n| `partial_images` | ✅ | 0~3（stream=true 时 >=1） |\n| `user` | ✅ | 终端用户标识 |\n\n---\n\n## 四、视频模型 · POST /v1/videos\n\n### 4.1 请求参数 — Google / OpenAI 系\n\n| 参数 | Veo 3.1 全系 | Sora 2 | Omni 系 |\n|---|---|---|\n| `model` | ✅ | ✅ | ✅ |\n| `prompt` | ✅ | ✅ | ✅ |\n| `seconds` | ✅ 2~30 | ✅ 4~20 | ✅ 2~30 |\n| `size` | ✅ | ✅ 2种 | ✅ |\n| `aspect_ratio` | ✅ | — | ✅(flash) / ❌(-10s) |\n\n### 4.2 请求参数 — xAI / 字节跳动 / 其他\n\n| 参数 | Grok Video 3 | Grok 6/10/12s | Grok Img 1.0 | Grok Img 1.5 | Seedance | HappyHorse | Kling |\n|---|---|---|---|---|---|---|---|\n| `model` | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |\n| `prompt` | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |\n| `seconds` | ✅ 2~30 | ✅ 6/10/12 | ✅ 6/10 | ✅ 10/15 | ✅ 4/5/6/8/10 | ✅ | ✅ max30 |\n| `size` | ✅ 2种 | ✅ 1280² | ✅ 2种 | ✅ 2种 | ⚠️ 哑接受 | ✅ | — |\n| `aspect_ratio` | — | — | ✅ | ✅(fast) / ❌(preview) | ✅ 5选1 | — | — |\n### 4.3 请求参数 — 扩展字段\n\n| 参数 | Veo 主系 | Veo -fl 首尾帧 | Omni v2v | Seedance | Kling | 说明 |\n|---|---|---|---|---|---|---|\n| `images` | ✅ 图生 | — | — | ✅(JSON) | — | 参考图URL数组（Seedance 换装/参考图） |\n| `first_frame_image` | — | ✅ | — | — | — | 首帧图 |\n| `last_frame_image` | — | ✅ | — | — | — | 尾帧图 |\n| `images_list` | — | — | ✅ max7 | — | — | 参考图URL数组（Omni） |\n| `video_urls` | — | — | — | ✅(JSON) | — | 参考视频URL数组（Seedance 换装/参考视频） |\n| `video_files` | — | — | ✅ | — | ✅ | 参考视频URL（Omni/Kling） |\n| `quality` | — | — | — | ⚠️ `basic`(哑接受) | — | Seedance 换装场景固定传 basic |\n| `image` | — | — | — | — | — | Grok Img 1.5 单图URL |\n| `input_reference` | — | — | — | ✅(multipart) | — | 本地图片文件参考（Seedance）/ Veo延长 |\n\n### 4.4 视频 Seconds 范围（实测）\n\n| 模型 | 提交值 | 实际生成 |\n|---|---|---|\n| Veo 3.1 / -fast / -fl | `2`~`30` 全部queued | 通常8s段落 |\n| Grok Video 3 Max | `2`~`30` 全部queued | — |\n| Grok Video 6/10/12s | `6` `10` `12` | 对应时长 |\n| Grok Imagine 1.0 | `6` `10` | 对应时长 |\n| Grok Imagine 1.5 fast/super | `10` `15` | 对应时长 |\n| Sora 2 | `4` | 4s |\n| Sora 2-12s | `4` `8` `12` `20` | 对应时长 |\n| Omni 全系 | `2`~`30` | 10s |\n| Seedance 2.0 | 实测 `4` `5` `6` `8` `10` 精确跟随 | 时长真参数，下限 4s |\n\n### 4.5 视频 Size 限制（实测）\n\n| 模型 | 接受 | 拒绝 |\n|---|---|---|\n| Veo 主系 | 1280/720/1920/1080/512, 16:9/9:16/1:1 | — |\n| Veo -fl | 1280/720/1920/1080 | 16:9, 1:1, 9:16, 512 |\n| Grok Img 1.0 | 1280/720, 16:9/9:16/1:1 | 1080, 1920, 512 |\n| Grok Img 1.5 fast | 1280/720, 16:9/9:16/1:1 | 1080, 1920, 512 |\n| Grok Img 1.5 preview | 1280/720 | 所有aspect, 1080, 1920, 512 |\n| Omni flash | 1280~1920, 512, 16:9/9:16/1:1 | — |\n| Omni flash-10s | 1280~1920, 512 | 16:9, 9:16, 1:1 |\n| Sora 2 | 720/1280 方向互换 | — |\n| Seedance 2.0 全系 | 提交任意值均 200（哑接受） | 实际输出恒为 `720x1280`，size 不生效 |\n\n### 4.6 返回字段 — 总结\n\n| 字段 | Veo | Grok Video 3 | Grok 6/10/12s | Sora 2 | Omni | Seedance |\n|---|---|---|---|---|---|---|\n| `task_id` | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |\n| `status` | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |\n| `progress` | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |\n| `url` | ✅ | ✅ `video_url` | ❌ **无URL** | ✅ | ✅ | ✅ |\n| `video_url` | ❌ | ✅ | ❌ | ❌ | ❌ | ❌ |\n| `error` | ✅ `failed`时 | ✅ | ✅ | ✅ | ✅ | ✅ |\n| `created_at` | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |\n| 下载 | url或/content | url或/content | **仅/content** | url或/content | url或/content | url或/content |\n\n---\n\n## 五、错误响应通用格式\n\n所有接口在失败时返回统一 JSON 结构：\n\n```json\n{\n  \"error\": {\n    \"message\": \"具体错误描述\",\n    \"type\": \"invalid_request_error\",\n    \"param\": \"model\",\n    \"code\": \"invalid_value\"\n  }\n}\n```\n\n| 字段 | 类型 | 说明 |\n|---|---|---|\n| `error.message` | string | 人类可读的错误描述 |\n| `error.type` | string | 错误分类，如 `invalid_request_error` `authentication_error` `new_api_error` |\n| `error.param` | string | 触发错误的参数名（仅参数类错误有值） |\n| `error.code` | string | 机器可读的错误码，如 `invalid_value` `model_not_found` |\n\n视频提交错误（提交时未通过上游校验）：\n\n```json\n{\n  \"code\": \"do_response_failed\",\n  \"message\": \"upstream returned non-2xx status: 503\",\n  \"data\": null\n}\n```\n\n| 字段 | 类型 | 说明 |\n|---|---|---|\n| `code` | string | 固定 `do_response_failed` |\n| `message` | string | 嵌套上游错误详情 |\n| `data` | null | 无数据 |\n\n视频任务级失败（提交成功但异步失败）：\n\n```json\n{\n  \"id\": \"task_xxx\",\n  \"status\": \"failed\",\n  \"error\": {\n    \"message\": \"提交中含有违反平台政策的内容\",\n    \"code\": \"task_failed\"\n  }\n}\n```",
        "responses": {
          "200": {
            "description": "参考文档（非可调用端点，仅供查阅）"
          }
        }
      }
    },
    "/v1/images/generations": {
      "post": {
        "tags": [
          "图像模型"
        ],
        "summary": "GPT Image 2 文生图",
        "operationId": "op_477511627",
        "description": "### 1. 功能介绍\n\nOpenAI GPT Image 2 系列**文生图**，同步返回图片。兼容 OpenAI Images 协议，通过 `/v1/images/generations` 调用。\n\n- 支持文生图（本接口）和图生图/编辑（`POST /v1/images/edits`，见编辑接口）\n- 返回 OSS URL 链接（`data[].url`），有效期 1~24 小时\n- 多变体覆盖标准版 / Pro / 官转直连 / VIP\n\n\n### 2. 可用型号\n\n| model | 说明 | enable_groups |\n|---|---|---|\n| `gpt-image-2` | GPT Image 2 标准版 | `default` `官转 image2` `官转` |\n| `gpt-image-2-pro` | GPT Image 2 Pro | `default` `官转 image2` `官转` |\n| `gpt-image-2-2026-04-21` | OpenAI 官转版（2026-04-21） | `官转` |\n| `gpt-image-2-vip` | VIP 通道 | `vip` |\n| `gpt-image-2-4K` | GPT Image 2 · 4K 超清（2026-07 实测新增） | ✅ 实测返回 1 张 OSS URL |\n\n### 3. 请求参数\n\n| 参数 | 类型 | 必填 | 说明 |\n|---|---|---|---|\n| `model` | string | ✅ | 模型名。见 §2 |\n| `prompt` | string | ✅ | 图像描述。支持中英文，最大 4000 字符 |\n| `n` | integer |  | 生成数量。仅支持 **n=1**，传 >1 仍只返回 1 张 |\n| `size` | string |  | 输出尺寸。`1024x1024` / `1536x1024` / `1024x1536` / `2048x2048` / `auto`（默认） |\n| `quality` | string |  | 质量。`low` / `medium` / `high` / `auto`（默认） |\n| `background` | string |  | 背景。`opaque` / `transparent`（Pro 版）/ `auto`（默认） |\n| `output_format` | string |  | 输出格式。`png`（默认）/ `webp` / `jpeg` |\n| `output_compression` | integer |  | 压缩率。0~100，仅 webp/jpeg，默认 100 |\n| `moderation` | string |  | 安全审核。`auto`（默认）/ `low` |\n| `user` | string |  | 终端用户标识 |\n\n\n\n### 4. 支持范围（实测）\n\n#### Size\n\n| size | 结果 | 说明 |\n|---|---|---|\n| `1024x1024` / `1536x1024` / `1024x1536` / `2048x2048` | ✅ | 标准白名单 |\n| `auto` | ✅ | 默认尺寸 |\n| 自定义 WxH（不在白名单） | ❌ | `The parameter size specified in the request is not valid` |\n\n#### n（生成数量）\n\n| n | 结果 |\n|---|---|\n| 1 | ✅ 返回 1 张 |\n| 2~10 | ⚠️ 接受请求，但**仅返回 1 张**（`n` 参数在此模型不生效） |\n\n#### quality\n\n| quality | 结果 |\n|---|---|\n| `low` / `medium` / `high` / `auto` | ✅ 全部接受 |\n\n#### background\n\n| background | 结果 |\n|---|---|\n| `opaque`（默认） | ✅ |\n| `transparent` | ✅（仅 `gpt-image-2-pro`，标准版设 transparent 会被忽略） |\n\n\n\n### 5. 返回响应\n\n**成功（OSS URL）**：\n\n```json\n{\n  \"created\": 1782356107,\n  \"background\": \"opaque\",\n  \"output_format\": \"png\",\n  \"quality\": \"auto\",\n  \"size\": \"1024x1024\",\n  \"data\": [\n    { \"url\": \"https://<oss-domain>/image-generation-<id>.png\" }\n  ],\n  \"usage\": {\n    \"input_tokens\": 4,\n    \"input_tokens_details\": { \"text_tokens\": 4 },\n    \"output_tokens\": 765,\n    \"output_tokens_details\": { \"image_tokens\": 765 },\n    \"total_tokens\": 769\n  }\n}\n```\n\n| 返回字段 | 类型 | 说明 |\n|---|---|---|\n| `data[].url` | string | OSS 图片链接，有效期 1~24h |\n| `size` | string | 实际输出尺寸 |\n| `quality` | string | 实际质量档位 |\n| `usage.input_tokens` | integer | 输入 token 数 |\n| `usage.output_tokens` | integer | 输出图片 token 数 |\n\n### 6. 注意事项\n\n- ⏰ `data[].url` 有效期 1~24 小时，建议及时下载或转存\n- 🔢 `n` 参数仅支持 1，传入 >1 仍只返回 1 张\n- 🔒 内容安全审核不通过返回 400，不消耗额度\n- 🖼️ 图生图/编辑请走 `POST /v1/images/edits`（见编辑接口）\n- 📐 尺寸仅支持白名单取值，自定义 WxH 不在白名单会 400\n\n### 7. 接入地址\n\n| 线路 | Base URL |\n|---|---|\n| 国内加速（推荐） | `https://iliu.ai` |\n| 海外直连 | `https://api.xinliu.one` |\n\n### 8. 错误码\n\n| 状态码 | 典型错误 | 原因 |\n|---|---|---|\n| `400` | `The parameter size specified in the request is not valid` | size 越界或不在白名单 |\n| `400` | `Your request was rejected as a result of our safety system` | 内容审核拒绝 |\n| `401` | — | 令牌无效 |\n| `402` | — | 余额不足 |\n| `429` | — | 速率限制 |\n| `503` | `No available channel` | 上游不可用 |\n\n\n**错误响应格式**：\n\n```json\n{\n  \"error\": {\n    \"message\": \"具体错误描述\",\n    \"type\": \"invalid_request_error\",\n    \"param\": \"model\",\n    \"code\": \"invalid_value\"\n  }\n}\n```\n\n| 字段 | 类型 | 说明 |\n|---|---|---|\n| `error.message` | string | 人类可读的错误描述 |\n| `error.type` | string | `invalid_request_error` / `authentication_error` / `new_api_error` |\n| `error.param` | string | 触发错误的参数名（仅参数类错误有值） |\n| `error.code` | string | 机器可读错误码，如 `invalid_value` `model_not_found` |\n",
        "responses": {
          "200": {
            "description": "成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "created": {
                      "type": "integer"
                    },
                    "data": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "url": {
                            "type": "string"
                          },
                          "b64_json": {
                            "type": "string"
                          }
                        }
                      }
                    },
                    "size": {
                      "type": "string"
                    },
                    "usage": {
                      "type": "object",
                      "properties": {}
                    }
                  }
                },
                "example": {
                  "created": 0,
                  "data": [
                    {
                      "url": "string",
                      "b64_json": "string"
                    }
                  ],
                  "size": "string",
                  "usage": {}
                }
              }
            }
          }
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "model": {
                    "type": "string"
                  },
                  "prompt": {
                    "type": "string"
                  },
                  "size": {
                    "type": "string"
                  },
                  "n": {
                    "type": "integer"
                  },
                  "quality": {
                    "type": "string"
                  },
                  "background": {
                    "type": "string"
                  },
                  "output_format": {
                    "type": "string"
                  },
                  "response_format": {
                    "type": "string"
                  },
                  "moderation": {
                    "type": "string"
                  },
                  "image": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    }
                  }
                }
              },
              "example": {
                "model": "string",
                "prompt": "string",
                "size": "auto",
                "n": 1,
                "quality": "auto",
                "background": "auto",
                "output_format": "png",
                "response_format": "url",
                "moderation": "auto",
                "image": [
                  "string"
                ]
              }
            }
          }
        }
      }
    },
    "/v1/images/edits": {
      "post": {
        "tags": [
          "图像模型"
        ],
        "summary": "GPT Image 2 图生图（编辑）",
        "operationId": "op_477734838",
        "description": "### 1. 功能介绍\n\nGPT Image 2 **图生图/编辑**接口。上传原始图像和可选遮罩，结合文本提示词进行图像编辑。使用 `multipart/form-data` 提交。\n\n- 支持单图编辑、多图组合、局部重绘（遮罩）\n- 支持高保真编辑（`input_fidelity=high`）、透明背景、流式输出\n- `image` **必须为真实文件上传**（curl 用 `-F \"image=@文件路径\"`），不能传 URL 字符串\n\n\n### 2. 可用型号\n\n| model | 说明 | enable_groups |\n|---|---|---|\n| `gpt-image-2` | GPT Image 2 标准版 | `default` `官转 image2` `官转` |\n| `gpt-image-2-pro` | GPT Image 2 Pro | `default` `官转 image2` `官转` |\n| `gpt-image-2-2026-04-21` | OpenAI 官转版 | `官转` |\n\n### 3. 请求参数\n\n| 参数 | 类型 | 必填 | 说明 |\n|---|---|---|---|\n| `model` | string | ✅ | 模型名。见 §2 |\n| `prompt` | string | ✅ | 编辑指令。最大 32000 字符 |\n| `image` | file | ✅ | 原图文件。**必须是真实文件上传**，不能传 URL。支持 png/jpeg/webp，≤50MB。可重复传入实现多图组合 |\n| `mask` | file |  | 遮罩 PNG。透明区为编辑区域，须与原图同尺寸 |\n| `n` | integer |  | 生成数量。仅支持 n=1，默认 1 |\n| `size` | string |  | 输出尺寸。`1024x1024` / `1536x1024` / `1024x1536` / `2048x2048` / `auto`（默认） |\n| `quality` | string |  | 质量。`low` / `medium` / `high` / `auto`（默认） |\n| `background` | string |  | 背景。`transparent`（仅 Pro）/ `opaque` / `auto`（默认） |\n| `output_format` | string |  | 输出格式。`png`（默认）/ `webp` / `jpeg` |\n| `output_compression` | integer |  | 压缩率。0~100，仅 webp/jpeg，默认 100 |\n| `moderation` | string |  | 安全审核。`auto`（默认）/ `low` |\n| `input_fidelity` | string |  | 保真度。`low`（默认，快，便宜）/ `high`（保留更多原图细节，token 消耗大） |\n| `stream` | boolean |  | 流式输出。`false`（默认）/ `true` |\n| `partial_images` | integer |  | 流式中途图。0~3，`stream=true` 时须 ≥1 |\n| `user` | string |  | 终端用户标识 |\n\n\n\n### 4. 支持范围（实测）\n\n#### n\n\n| n | 结果 |\n|---|---|\n| 1 | ✅ 返回 1 张 |\n| >1 | ⚠️ 接受请求，但仅返回 1 张 |\n\n#### input_fidelity\n\n| input_fidelity | 结果 |\n|---|---|\n| `low`（默认） | ✅ 单图约 255 image tokens |\n| `high` | ✅ 保留更多原图细节，image tokens 数更高 |\n\n#### stream（流式）\n\n| stream | partial_images | 结果 |\n|---|---|---|\n| `false` | — | ✅ 同步返回 |\n| `true` | 1~3 | ✅ SSE 推送途中图 + 最终图 |\n| `true` | 0 | ❌ `partial_images` 必须 ≥1 |\n\n\n\n### 5. 返回响应\n\n```json\n{\n  \"created\": 1782356107,\n  \"background\": \"opaque\",\n  \"output_format\": \"png\",\n  \"quality\": \"auto\",\n  \"size\": \"1024x1024\",\n  \"data\": [\n    { \"url\": \"https://<oss-domain>/image-generation-<id>.png\" }\n  ],\n  \"usage\": {\n    \"input_tokens\": 259,\n    \"input_tokens_details\": { \"image_tokens\": 255, \"text_tokens\": 4 },\n    \"output_tokens\": 765,\n    \"output_tokens_details\": { \"image_tokens\": 765 },\n    \"total_tokens\": 1024\n  }\n}\n```\n\n| 返回字段 | 类型 | 说明 |\n|---|---|---|\n| `data[].url` | string | OSS 图片链接，1~24h 有效。编辑接口**通常**返回 `url`，个别渠道可能返回 `b64_json` |\n| `usage.input_tokens_details.image_tokens` | integer | 输入图 token（每张约 255；`input_fidelity=high` 时更高） |\n| `usage.input_tokens_details.text_tokens` | integer | prompt 文本 token |\n\n### 6. 注意事项\n\n- 📎 `image` **必须真实文件上传**，传 URL 字符串会返回 500 错误\n- 🎭 `mask` 须为 PNG，alpha 透明区=编辑区。GPT Image 模型把遮罩视为提示而非精确边界\n- 📏 `image` 可重复传入实现多图组合（curl 多个 `-F \"image=@...\"`），但模型仅处理前 2~3 张\n- 💰 带参考图的请求 input_tokens 高于纯文生图；`input_fidelity=high` 时 image tokens 更高\n- 🔒 不支持编辑敏感内容\n- 🔢 `n` 仅支持 1\n\n### 7. 接入地址\n\n| 线路 | Base URL |\n|---|---|\n| 国内加速（推荐） | `https://iliu.ai` |\n| 海外直连 | `https://api.xinliu.one` |\n\n### 8. 错误码\n\n| 状态码 | 典型错误 | 原因 |\n|---|---|---|\n| `400` | `image is required` | 缺少 image 参数 |\n| `400` | The parameter size specified in the request is not valid | size 不在白名单 |\n| `401` | — | 令牌无效 |\n| `402` | — | 余额不足 |\n| `413` | — | 上传文件过大（单文件 >50MB） |\n| `500` | `\"image\" is required` | 传入了 URL 字符串而非文件 |\n| `503` | — | 上游不可用 |\n\n\n**错误响应格式**：\n\n```json\n{\n  \"error\": {\n    \"message\": \"具体错误描述\",\n    \"type\": \"invalid_request_error\",\n    \"param\": \"model\",\n    \"code\": \"invalid_value\"\n  }\n}\n```\n\n| 字段 | 类型 | 说明 |\n|---|---|---|\n| `error.message` | string | 人类可读的错误描述 |\n| `error.type` | string | `invalid_request_error` / `authentication_error` / `new_api_error` |\n| `error.param` | string | 触发错误的参数名（仅参数类错误有值） |\n| `error.code` | string | 机器可读错误码，如 `invalid_value` `model_not_found` |\n",
        "responses": {
          "200": {
            "description": "成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "created": {
                      "type": "integer"
                    },
                    "data": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "url": {
                            "type": "string"
                          }
                        }
                      }
                    },
                    "size": {
                      "type": "string"
                    },
                    "usage": {
                      "type": "object",
                      "properties": {}
                    }
                  }
                },
                "example": {
                  "created": 0,
                  "data": [
                    {
                      "url": "string"
                    }
                  ],
                  "size": "string",
                  "usage": {}
                }
              }
            }
          }
        }
      }
    },
    "/v1/images/tasks/generations": {
      "post": {
        "tags": [
          "图像模型"
        ],
        "summary": "异步文生图任务提交",
        "operationId": "op_img_tasks_generations",
        "description": "### 1. 功能介绍\n\nGPT Image 2 系列**异步文生图**。提交返回 `task_id` → 轮询 `GET /v1/images/tasks/{task_id}` → 拿到 OSS URL。适用于批量生成或耗时较长、不希望同步阻塞的场景。\n\n- 同步版见 `POST /v1/images/generations`（直接返回图片）\n- 异步版本接口立即返回 `task_id`，不阻塞连接\n- 生成完成后通过查询接口拿 `data[].url`\n\n### 2. 可用型号\n\n| model | 说明 | enable_groups |\n|---|---|---|\n| `gpt-image-2` | GPT Image 2 标准版 | `default` `官转 image2` `官转` |\n| `gpt-image-2-pro` | GPT Image 2 Pro | `default` `官转 image2` `官转` |\n| `gpt-image-2-vip` | VIP 通道 | `vip` |\n\n### 3. 请求参数\n\n| 参数 | 类型 | 必填 | 说明 |\n|---|---|---|---|\n| `model` | string | ✅ | 模型名。见 §2 |\n| `prompt` | string | ✅ | 图像描述。支持中英文，最大 4000 字符 |\n| `n` | integer |  | 生成数量。仅支持 **n=1** |\n| `size` | string |  | 输出尺寸。`1024x1024` / `1536x1024` / `1024x1536` / `2048x2048` / `auto`（默认） |\n| `quality` | string |  | 质量。`low` / `medium` / `high` / `auto`（默认） |\n| `background` | string |  | 背景。`opaque` / `transparent`（Pro 版）/ `auto`（默认） |\n| `output_format` | string |  | 输出格式。`png`（默认）/ `webp` / `jpeg` |\n| `moderation` | string |  | 安全审核。`auto`（默认）/ `low` |\n| `user` | string |  | 终端用户标识 |\n\n### 4. 返回响应\n\n```json\n{\n  \"id\": \"task_lQiB7zOA83KKI5IpNDxtbdnO6639wcUA\",\n  \"task_id\": \"task_lQiB7zOA83KKI5IpNDxtbdnO6639wcUA\",\n  \"object\": \"image.task\",\n  \"model\": \"gpt-image-2\",\n  \"status\": \"queued\",\n  \"progress\": 0,\n  \"created_at\": 1782874934\n}\n```\n\n| 返回字段 | 类型 | 说明 |\n|---|---|---|\n| `task_id` | string | 任务 ID，用于轮询 `GET /v1/images/tasks/{task_id}` |\n| `status` | string | `queued` / `in_progress` / `processing` |\n| `progress` | integer | 0~100 |\n\n### 5. 注意事项\n\n- 🔁 轮询：`GET /v1/images/tasks/{task_id}`，建议每 3~5 秒一次\n- 🔒 内容审核不通过 → `status=failed`，不消耗额度\n- 🔢 `n` 仅支持 1\n- ⏰ 完成后 `data[].url` 有效期 1~24 小时，及时转存\n\n### 6. 接入地址\n\n| 线路 | Base URL |\n|---|---|\n| 国内加速（推荐） | `https://iliu.ai` |\n| 海外直连 | `https://api.xinliu.one` |\n\n### 7. 错误码\n\n| 状态码 | 典型错误 | 原因 |\n|---|---|---|\n| `400` | `The parameter size specified in the request is not valid` | size 不在白名单 |\n| `401` | — | 令牌无效 |\n| `402` | — | 余额不足 |\n| `429` | — | 速率限制 |\n| `503` | `No available channel` | 上游不可用 |\n\n\n**错误响应格式**：\n\n```json\n{\n  \"error\": {\n    \"message\": \"具体错误描述\",\n    \"type\": \"invalid_request_error\",\n    \"param\": \"model\",\n    \"code\": \"invalid_value\"\n  }\n}\n```\n",
        "responses": {
          "200": {
            "description": "成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string"
                    },
                    "task_id": {
                      "type": "string"
                    },
                    "object": {
                      "type": "string"
                    },
                    "model": {
                      "type": "string"
                    },
                    "status": {
                      "type": "string"
                    },
                    "progress": {
                      "type": "integer"
                    },
                    "created_at": {
                      "type": "integer"
                    }
                  }
                },
                "example": {
                  "id": "string",
                  "task_id": "string",
                  "object": "image.task",
                  "model": "string",
                  "status": "queued",
                  "progress": 0,
                  "created_at": 0
                }
              }
            }
          }
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "model": {
                    "type": "string"
                  },
                  "prompt": {
                    "type": "string"
                  },
                  "n": {
                    "type": "integer"
                  },
                  "size": {
                    "type": "string"
                  },
                  "quality": {
                    "type": "string"
                  },
                  "background": {
                    "type": "string"
                  },
                  "output_format": {
                    "type": "string"
                  },
                  "moderation": {
                    "type": "string"
                  }
                }
              },
              "example": {
                "model": "gpt-image-2",
                "prompt": "string",
                "n": 1,
                "size": "auto",
                "quality": "auto",
                "background": "auto",
                "output_format": "png",
                "moderation": "auto"
              }
            }
          }
        }
      }
    },
    "/v1/images/tasks/edits": {
      "post": {
        "tags": [
          "图像模型"
        ],
        "summary": "异步图生图（编辑）任务提交",
        "operationId": "op_img_tasks_edits",
        "description": "### 1. 功能介绍\n\nGPT Image 2 **异步图生图/编辑**。上传原图（及可选遮罩）+ 编辑指令，使用 `multipart/form-data` 提交，立即返回 `task_id` → 轮询 `GET /v1/images/tasks/{task_id}`。\n\n- 同步版见 `POST /v1/images/edits`\n- `image` **必须为真实文件上传**（curl 用 `-F \"image=@文件路径\"`），不能传 URL 字符串\n- 提交层立即返回 `task_id`，不阻塞\n\n### 2. 可用型号\n\n| model | 说明 | enable_groups |\n|---|---|---|\n| `gpt-image-2` | GPT Image 2 标准版 | `default` `官转 image2` `官转` |\n| `gpt-image-2-pro` | GPT Image 2 Pro | `default` `官转 image2` `官转` |\n\n### 3. 请求参数\n\n| 参数 | 类型 | 必填 | 说明 |\n|---|---|---|---|\n| `model` | string | ✅ | 模型名。见 §2 |\n| `prompt` | string | ✅ | 编辑指令。最大 32000 字符 |\n| `image` | file | ✅ | 原图文件。**必须真实文件上传**，不能传 URL。png/jpeg/webp，≤50MB。可重复传入实现多图组合 |\n| `mask` | file |  | 遮罩 PNG。透明区为编辑区域，须与原图同尺寸 |\n| `n` | integer |  | 生成数量。仅支持 n=1 |\n| `size` | string |  | 输出尺寸。`1024x1024` / `1536x1024` / `1024x1536` / `2048x2048` / `auto`（默认） |\n| `quality` | string |  | 质量。`low` / `medium` / `high` / `auto`（默认） |\n| `background` | string |  | 背景。`transparent`（仅 Pro）/ `opaque` / `auto`（默认） |\n| `output_format` | string |  | 输出格式。`png`（默认）/ `webp` / `jpeg` |\n| `input_fidelity` | string |  | 保真度。`low`（默认）/ `high` |\n| `moderation` | string |  | 安全审核。`auto`（默认）/ `low` |\n| `user` | string |  | 终端用户标识 |\n\n### 4. 返回响应\n\n```json\n{\n  \"id\": \"task_lQiB7zOA83KKI5IpNDxtbdnO6639wcUA\",\n  \"task_id\": \"task_lQiB7zOA83KKI5IpNDxtbdnO6639wcUA\",\n  \"object\": \"image.task\",\n  \"model\": \"gpt-image-2\",\n  \"status\": \"queued\",\n  \"progress\": 0,\n  \"created_at\": 1782874934\n}\n```\n\n| 返回字段 | 类型 | 说明 |\n|---|---|---|\n| `task_id` | string | 任务 ID，用于轮询 `GET /v1/images/tasks/{task_id}` |\n| `status` | string | `queued` / `in_progress` / `processing` |\n| `progress` | integer | 0~100 |\n\n### 5. 注意事项\n\n- 📎 `image` **必须真实文件上传**，传 URL 字符串会报错\n- 🎭 `mask` 须为 PNG，alpha 透明区=编辑区\n- 🔁 轮询：`GET /v1/images/tasks/{task_id}`，建议每 3~5 秒一次\n- 🔒 内容审核不通过 → `status=failed`，不消耗额度\n- 🔢 `n` 仅支持 1\n\n### 6. 接入地址\n\n| 线路 | Base URL |\n|---|---|\n| 国内加速（推荐） | `https://iliu.ai` |\n| 海外直连 | `https://api.xinliu.one` |\n\n### 7. 错误码\n\n| 状态码 | 典型错误 | 原因 |\n|---|---|---|\n| `400` | `image is required` | 缺少 image 参数 |\n| `401` | — | 令牌无效 |\n| `402` | — | 余额不足 |\n| `413` | — | 上传文件过大（>50MB） |\n| `500` | `\"image\" is required` | 传入了 URL 字符串而非文件 |\n| `503` | — | 上游不可用 |\n\n\n**错误响应格式**：\n\n```json\n{\n  \"error\": {\n    \"message\": \"具体错误描述\",\n    \"type\": \"invalid_request_error\",\n    \"param\": \"model\",\n    \"code\": \"invalid_value\"\n  }\n}\n```\n",
        "responses": {
          "200": {
            "description": "成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string"
                    },
                    "task_id": {
                      "type": "string"
                    },
                    "object": {
                      "type": "string"
                    },
                    "model": {
                      "type": "string"
                    },
                    "status": {
                      "type": "string"
                    },
                    "progress": {
                      "type": "integer"
                    },
                    "created_at": {
                      "type": "integer"
                    }
                  }
                },
                "example": {
                  "id": "string",
                  "task_id": "string",
                  "object": "image.task",
                  "model": "string",
                  "status": "queued",
                  "progress": 0,
                  "created_at": 0
                }
              }
            }
          }
        }
      }
    },
    "/v1/images/tasks/{task_id}": {
      "get": {
        "tags": [
          "图像模型"
        ],
        "summary": "异步图片任务查询",
        "operationId": "op_img_tasks_query",
        "description": "### 1. 功能介绍\n\n查询异步图片任务（`POST /v1/images/tasks/generations` 或 `POST /v1/images/tasks/edits`）的状态和结果。轮询直到 `status=completed` 拿到 `data[].url`。\n\n### 2. 请求参数\n\n| 参数 | 类型 | 必填 | 说明 |\n|------|------|------|------|\n| `task_id` (path) | string | ✅ | 由异步提交接口返回 |\n| Authorization (header) | string | ✅ | `Bearer <API Key>` |\n\n### 3. 任务状态\n\n| 状态 | 说明 |\n|------|------|\n| `queued` | 排队等待 |\n| `in_progress` / `processing` | 正在生成 |\n| `completed` | 已完成，可取 `data[].url` |\n| `failed` | 失败 |\n\n### 4. 返回格式\n\n**处理中**：\n```json\n{\"id\":\"task_<id>\",\"object\":\"image.task\",\"model\":\"gpt-image-2\",\"status\":\"in_progress\",\"progress\":42,\"created_at\":1782874934}\n```\n\n**已完成**：\n```json\n{\n  \"id\": \"task_<id>\",\n  \"object\": \"image.task\",\n  \"model\": \"gpt-image-2\",\n  \"status\": \"completed\",\n  \"progress\": 100,\n  \"data\": [\n    { \"url\": \"https://<oss-domain>/image-generation-<id>.png\" }\n  ],\n  \"usage\": {\n    \"input_tokens\": 4,\n    \"output_tokens\": 765,\n    \"total_tokens\": 769\n  }\n}\n```\n\n**失败**：\n```json\n{\"id\":\"task_<id>\",\"status\":\"failed\",\"error\":{\"code\":\"generation_failed\",\"message\":\"内容审核不通过\"}}\n```\n\n### 5. 注意事项\n\n- ⏱️ 建议每 3~5 秒轮询一次\n- ⏰ 完成后 `data[].url` 有效期 1~24 小时，及时下载或转存\n\n### 6. 接入地址\n\n| 线路 | Base URL |\n|------|----------|\n| 国内加速（推荐） | `https://iliu.ai` |\n| 海外直连 | `https://api.xinliu.one` |\n\n### 7. 错误码\n\n| 状态码 | 说明 |\n|--------|------|\n| `401` | 令牌无效 |\n| `404` | 任务不存在或已过期 |\n| `500` | 服务端内部错误 |\n",
        "responses": {
          "200": {
            "description": "成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string"
                    },
                    "task_id": {
                      "type": "string"
                    },
                    "object": {
                      "type": "string"
                    },
                    "model": {
                      "type": "string"
                    },
                    "status": {
                      "type": "string"
                    },
                    "progress": {
                      "type": "integer"
                    },
                    "data": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "url": {
                            "type": "string"
                          },
                          "b64_json": {
                            "type": "string"
                          }
                        }
                      }
                    },
                    "usage": {
                      "type": "object",
                      "properties": {}
                    },
                    "error": {
                      "type": "object",
                      "properties": {}
                    }
                  }
                },
                "example": {
                  "id": "string",
                  "task_id": "string",
                  "object": "image.task",
                  "model": "string",
                  "status": "completed",
                  "progress": 100,
                  "data": [
                    {
                      "url": "string",
                      "b64_json": "string"
                    }
                  ],
                  "usage": {},
                  "error": {}
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "task_id",
            "in": "path",
            "required": true,
            "description": "任务 ID（由异步图片提交接口的响应返回）",
            "schema": {
              "type": "string"
            }
          }
        ]
      }
    },
    "/v1/images/generations#grok-imagine": {
      "post": {
        "tags": [
          "图像模型"
        ],
        "summary": "Grok Imagine 文生图",
        "operationId": "op_477734840",
        "description": "### 1. 功能介绍\n\nxAI Grok Imagine 系列**文生图**，同步返回。兼容 OpenAI Images 协议，通过 `/v1/images/generations` 调用。\n\n- 模型：`grok-imagine-image` / `grok-imagine-image-pro` / `grok-imagine-image-edit`\n- 支持两种返回格式：`url`（默认）或 `b64_json`\n- `n` 支持 1~4；图生图通过 `image` 参数传入参考图 URL\n- 计费为按次固定 `total_tokens = 16384`\n\n\n### 2. 可用型号\n\n| model | 说明 | enable_groups |\n|---|---|---|\n| `grok-imagine-image` | Grok Imagine 标准 | `default` `low` |\n| `grok-imagine-image-pro` | Grok Imagine Pro | `default` `low` |\n| `grok-imagine-image-edit` | Grok Imagine 编辑 | `default` `low` |\n\n### 3. 请求参数\n\n| 参数 | 类型 | 必填 | 说明 |\n|---|---|---|---|\n| `model` | string | ✅ | 模型名。见 §2 |\n| `prompt` | string | ✅ | 图像描述 |\n| `n` | integer |  | 期望生成数量。默认 1，支持 1~4。上游可能不严格按请求数量返回 |\n| `size` | string |  | 输出尺寸。`1024x1024` / `1280x720` / `720x1280` |\n| `response_format` | string |  | 返回格式。`url`（默认）/ `b64_json` |\n| `image` | string |  | 参考图 URL。图生图模式，传公网可访问的图片 URL |\n\n\n\n### 4. 支持范围（实测）\n\n#### n\n\n| n | 结果 |\n|---|---|\n| 1 | ✅ 返回 1 张 |\n| 2~4 | ✅ 接受请求，但上游**不保证返回 n 张**（实际 1~4 不等） |\n\n#### size\n\n| size | 结果 |\n|---|---|\n| `1024x1024` | ✅ |\n| `1280x720` / `720x1280` | ✅ |\n| 其他 | ⚠️ 接受请求，上游可能自动调至最近支持尺寸 |\n\n#### response_format\n\n| 值 | 结果 |\n|---|---|\n| `url`（默认） | ✅ 返回 OSS 链接 |\n| `b64_json` | ✅ 返回 Base64 字符串 |\n\n#### 图生图（image 参数）\n\n| 场景 | 结果 |\n|---|---|\n| 传公网可访问的图片 URL | ✅ 图生图模式 |\n| 传本地文件路径或 base64 | ❌ 本接口只接受 URL 字符串（不是 multipart） |\n\n\n\n### 5. 返回响应\n\n**`response_format=url`（默认）**：\n\n```json\n{\n  \"created\": 1782353516,\n  \"data\": [\n    { \"url\": \"https://<domain>/grok/<uuid>.jpg\" }\n  ],\n  \"usage\": { \"total_tokens\": 16384 }\n}\n```\n\n**`response_format=b64_json`**：\n\n```json\n{\n  \"data\": [\n    { \"b64_json\": \"/9j/4QhoRXhpZgAA...\" }\n  ],\n  \"usage\": { \"total_tokens\": 16384 }\n}\n```\n\n| 返回字段 | 类型 | 说明 |\n|---|---|---|\n| `created` | integer | Unix 时间戳（秒） |\n| `data[].url` | string | 图片链接（`response_format=url` 时） |\n| `data[].b64_json` | string | Base64 编码（`response_format=b64_json` 时） |\n| `usage.total_tokens` | integer | 固定 16384，为上游计费单位 |\n\n### 6. 注意事项\n\n- 💰 `total_tokens` 固定为 16384，**不论分辨率和生成数量如何**（按次计费）\n- ⚠️ `n` 参数的实际返回数量可能不稳定，建议以默认值 1 使用\n- 🔎 `image` 参数传公网可访问的 URL 字符串（不是文件上传）\n- ⏰ `url` 返回的链接有有效期，建议及时下载\n\n### 7. 接入地址\n\n| 线路 | Base URL |\n|---|---|\n| 国内加速（推荐） | `https://iliu.ai` |\n| 海外直连 | `https://api.xinliu.one` |\n\n### 8. 错误码\n\n| 状态码 | 说明 |\n|---|---|\n| `400` | 参数错误 |\n| `401` | 令牌无效 |\n| `402` | 余额不足 |\n| `503` | 上游服务不可用 |\n\n\n**错误响应格式**：\n\n```json\n{\n  \"error\": {\n    \"message\": \"具体错误描述\",\n    \"type\": \"invalid_request_error\",\n    \"param\": \"model\",\n    \"code\": \"invalid_value\"\n  }\n}\n```\n\n| 字段 | 类型 | 说明 |\n|---|---|---|\n| `error.message` | string | 人类可读的错误描述 |\n| `error.type` | string | `invalid_request_error` / `authentication_error` / `new_api_error` |\n| `error.param` | string | 触发错误的参数名（仅参数类错误有值） |\n| `error.code` | string | 机器可读错误码，如 `invalid_value` `model_not_found` |\n",
        "responses": {
          "200": {
            "description": "成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "created": {
                      "type": "integer"
                    },
                    "data": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "url": {
                            "type": "string"
                          }
                        }
                      }
                    },
                    "usage": {
                      "type": "object",
                      "properties": {}
                    }
                  }
                },
                "example": {
                  "created": 0,
                  "data": [
                    {
                      "url": "string"
                    }
                  ],
                  "usage": {}
                }
              }
            }
          }
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "model": {
                    "type": "string"
                  },
                  "prompt": {
                    "type": "string"
                  },
                  "n": {
                    "type": "integer"
                  },
                  "size": {
                    "type": "string"
                  },
                  "response_format": {
                    "type": "string"
                  },
                  "image": {
                    "type": "string"
                  }
                }
              },
              "example": {
                "model": "string",
                "prompt": "string",
                "n": 1,
                "size": "string",
                "response_format": "url",
                "image": "string"
              }
            }
          }
        }
      }
    },
    "/v1beta/models/gemini-2.5-flash-image-preview:generateContent": {
      "post": {
        "tags": [
          "图像模型"
        ],
        "summary": "Nano Banana 图片生成",
        "operationId": "op_477734844",
        "description": "### 1. 功能介绍\n\nGoogle Gemini **Nano Banana** 图片生成系列，通过 Gemini **原生非流式** `:generateContent` 协议调用，**同步返回**结果。不走 `/v1/images/generations`。\n\n- 端点：`POST /v1beta/models/{model}:generateContent`\n- 请求格式：Gemini 原生协议（`contents` + `generationConfig`）\n- 返回：**Base64 图片**在 `candidates[].content.parts[].inlineData.data` 中（实测 `mimeType` 多为 `image/jpeg`）\n- **同端点也支持多模态识别和纯文本对话**（见「语言大模型 → Google」）\n\n> 📌 **建议使用非流式 `:generateContent`**：单次请求即同步返回完整图片（Base64 在 `candidates[].content.parts[].inlineData.data`，实测 `mimeType` 多为 `image/jpeg`）。流式 `:streamGenerateContent` 同样能返回图片，但会包成 SSE `data:` 事件、需额外解析，通常不必要。\n\n\n### 2. 可用型号\n\n| model | 说明 | enable_groups |\n|---|---|---|\n| `gemini-2.5-flash-image-preview` | Nano Banana（2.5 Flash） | `default` `普通分组 Gemini 香蕉` |\n| `gemini-3-pro-image-preview` | Nano Banana Pro（3 Pro） | `default` `普通分组 Gemini 香蕉` |\n| `gemini-3.1-flash-image-preview` | Nano Banana 2（3.1 Flash） | `default` `普通分组 Gemini 香蕉` |\n\n\n### 3. 请求参数\n\n| 参数 | 类型 | 必填 | 说明 |\n|---|---|---|---|\n| `{model}` (path) | string |  | 模型名。见 §2 |\n| `contents` | array | ✅ | 对话内容 |\n| `contents[].role` | string |  | 角色。`user` |\n| `contents[].parts[].text` | string |  | 图片描述。prompt 文本 |\n| `generationConfig` | object |  | 生成配置 |\n| `generationConfig.temperature` | number |  | 温度。0~2 |\n| `generationConfig.maxOutputTokens` | integer |  | 最大输出 |\n\n\n\n### 4. 返回响应\n\n**成功（返回图片 URL）**：\n\n```json\n{\n  \"candidates\": [{\n    \"content\": {\n      \"role\": \"model\",\n      \"parts\": [{\n        \"text\": \"\",\n        \"inlineData\": {\n          \"mimeType\": \"image/png\",\n          \"data\": \"iVBORw0KGgo...\"\n        }\n      }]\n    },\n    \"finishReason\": \"STOP\"\n  }],\n  \"usageMetadata\": {\n    \"promptTokenCount\": 120,\n    \"candidatesTokenCount\": 4500,\n    \"totalTokenCount\": 4620\n  }\n}\n```\n\n| 返回字段 | 类型 | 说明 |\n|---|---|---|\n| `candidates[].content.parts[].inlineData.mimeType` | string | 返回图片的格式（实测多为 `image/jpeg`，也可能 `image/png`） |\n| `candidates[].content.parts[].inlineData.data` | string | Base64 编码的图片 |\n| `candidates[].content.parts[].text` | string | 图片描述文本（通常为空） |\n| `candidates[].finishReason` | string | `STOP`（正常）/ `SAFETY`（审核拒绝） |\n| `usageMetadata.promptTokenCount` | integer | 输入 token 数 |\n| `usageMetadata.candidatesTokenCount` | integer | 输出 token 数 |\n\n> ⚠️ Nano Banana 返回的是 **Base64 字符串**，需要自行解码为图片文件（如 `base64 -d > out.png`）。\n\n### 5. 注意事项\n\n- 📦 返回的是 Base64 编码图片（非 URL），`candidates[].content.parts[].inlineData.data`\n- 🔒 content filter 较敏感，涉及人体的 prompt 大概率被 `SAFETY` 拒绝\n- 🎨 **图生图（编辑）**：把原图的 `inlineData` 放到 `contents[].parts[]` 的**第一位**，prompt 放后面\n- 💰 按 token 计费：图片 token 很大（prompt 端的图片 ≈ 258 tokens，输出端图片 ≈ 4096~8192 tokens）\n\n### 6. 接入地址\n\n| 线路 | Base URL |\n|---|---|\n| 国内加速（推荐） | `https://iliu.ai` |\n| 海外直连 | `https://api.xinliu.one` |\n\n### 7. 错误码\n\n| 状态码 | 典型错误 | 原因 |\n|---|---|---|\n| `400` | — | 参数格式错误 |\n| `401` | — | 令牌无效或未提供 |\n| `402` | — | 余额不足 |\n| `404` | `model_not_found` | 模型不存在或未开通 |\n| `429` | — | 速率限制 |\n| `503` | — | 上游服务不可用 |\n\n\n**错误响应格式**：\n\n```json\n{\n  \"error\": {\n    \"message\": \"具体错误描述\",\n    \"type\": \"invalid_request_error\",\n    \"param\": \"model\",\n    \"code\": \"invalid_value\"\n  }\n}\n```\n\n| 字段 | 类型 | 说明 |\n|---|---|---|\n| `error.message` | string | 人类可读的错误描述 |\n| `error.type` | string | `invalid_request_error` / `authentication_error` / `new_api_error` |\n| `error.param` | string | 触发错误的参数名（仅参数类错误有值） |\n| `error.code` | string | 机器可读错误码，如 `invalid_value` `model_not_found` |\n",
        "responses": {
          "200": {
            "description": "成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "candidates": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      }
                    },
                    "usageMetadata": {
                      "type": "object",
                      "properties": {}
                    }
                  }
                },
                "example": {
                  "candidates": [
                    "string"
                  ],
                  "usageMetadata": {}
                }
              }
            }
          }
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "contents": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "properties": {
                        "role": {
                          "type": "string"
                        },
                        "parts": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "text": {
                                "type": "string"
                              },
                              "inlineData": {
                                "type": "object",
                                "properties": {
                                  "mimeType": {
                                    "type": "string"
                                  },
                                  "data": {
                                    "type": "string"
                                  }
                                }
                              }
                            }
                          }
                        }
                      }
                    }
                  },
                  "generationConfig": {
                    "type": "object",
                    "properties": {
                      "maxOutputTokens": {
                        "type": "integer"
                      },
                      "temperature": {
                        "type": "integer"
                      }
                    }
                  }
                }
              },
              "example": {
                "contents": [
                  {
                    "role": "string",
                    "parts": [
                      {
                        "text": "string",
                        "inlineData": {
                          "mimeType": "string",
                          "data": "string"
                        }
                      }
                    ]
                  }
                ],
                "generationConfig": {
                  "maxOutputTokens": 0,
                  "temperature": 0
                }
              }
            }
          }
        }
      }
    },
    "/v1/images/generations#seedream": {
      "post": {
        "tags": [
          "字节跳动"
        ],
        "summary": "豆包 Seedream 图片生成",
        "operationId": "op_480820718",
        "description": "### 1. 功能介绍\n\n字节跳动豆包 **Seedream** 图像生成模型系列，兼容 OpenAI Images 协议，同步返回火山引擎 TOS URL 链接。\n\n- 端点：`POST /v1/images/generations`\n- 协议：兼容 OpenAI Images\n- 返回：`data[].url`（TOS 直链，24 小时有效）\n- 三代模型（4.0 / 4.5 / 5.0），像素规则、计费方式各不同\n\n\n### 2. 可用型号\n\n| model | 说明 | 像素规则 | 计费方式（实测） |\n|---|---|---|---|\n| `doubao-seedream-4-0-250828` | Seedream 4.0（2025-08-28） | 任意 WxH，921 600~8 294 400 像素 | `output_tokens ≈ 分辨率像素 ÷ 256` |\n| `doubao-seedream-4-5-251128` | Seedream 4.5（2025-11-28） | 任意 WxH，≥ 3 686 400 像素（~1920×1920） | 同上 |\n| `doubao-seedream-5-0-260128` | Seedream 5.0（2026-01-28） | 档位关键字（`\"2k\"` / `\"3840x2160\"` 等） | 固定 `output_tokens = 17800` |\n\n> 📐 **4.5 像素下限是 4.0 的 4 倍**。4.0 可生成 1024×1024，4.5 则需要 ≥1920×1920。\n\n### 3. 请求参数\n\n| 参数 | 类型 | 必填 | 说明 |\n|---|---|---|---|\n| `model` | string | ✅ | 模型名。见 §2 |\n| `prompt` | string | ✅ | 图片描述。支持中英文 |\n| `size` | string | ✅ | 分辨率。§4 见分版本规则 |\n| `n` | integer |  | 生成数量。默认 1；4.5 / 5.0 支持 1~4 |\n| `background` | string |  | 背景。服务端默认 `opaque` |\n| `output_format` | string |  | 输出格式。服务端默认 `png` |\n\n\n### 4. Size 支持范围（实测）\n\n#### 4.1 Seedream 4.0（250828）\n\n| 请求 size | 结果 | 说明 |\n|---|---|---|\n| `\"512x512\"` | ❌ | `image size must be at least 921600 pixels` |\n| `\"1024x1024\"` | ✅ | `output_tokens = 4096` |\n| `\"1024x1536\"` | ✅ | 竖版，`output_tokens = 6144` |\n| `\"1536x1024\"` | ✅ | 横版 |\n| `\"2048x2048\"` | ✅ | 2K，`output_tokens = 16384` |\n| `\"3840x2160\"` | ✅ | 4K，`output_tokens = 32400` |\n| `\"1:1\"` / `\"16:9\"` | ❌ | **不接受** aspect ratio 字符串，必须写具体像素 |\n| `\"auto\"` | ❌ | 不支持 auto |\n\n#### 4.2 Seedream 4.5（251128）\n\n| 请求 size | 结果 | 说明 |\n|---|---|---|\n| `\"1024x1024\"` | ❌ | `image size must be at least 3686400 pixels` |\n| `\"2048x2048\"` | ✅ | `output_tokens = 16384` |\n| `\"3840x2160\"` | ✅ | `output_tokens = 32400` |\n\n#### 4.3 Seedream 5.0（260128）\n\n| 请求 size | 服务端返回 `size` | output_tokens |\n|---|---|---|\n| `\"512x512\"` | 🔁 → `\"2k\"` | 17 800 |\n| `\"1024x1024\"` | 🔁 → `\"2k\"` | 17 800 |\n| `\"3840x2160\"` | ✅ `\"3840x2160\"` | 17 800 |\n| `\"2048x2048\"` | ⚠️ 返回空体，避免使用 | — |\n\n> 💡 **5.0 建议直接传关键字**：`\"2k\"` / `\"3840x2160\"`。服务端会规范化到最近档位并覆盖返回的 size 字段。\n\n\n### 5. 返回响应\n\n**4.0 / 4.5 成功**：\n\n```json\n{\n  \"created\": 1782870944,\n  \"background\": \"opaque\",\n  \"output_format\": \"png\",\n  \"quality\": \"auto\",\n  \"size\": \"2048x2048\",\n  \"data\": [{\n    \"url\": \"https://ark-content-generation-v2-cn-beijing.tos-cn-beijing.volces.com/doubao-seedream-4-5/<id>_0.jpeg?X-Tos-Signature=...\"\n  }],\n  \"usage\": {\n    \"output_tokens\": 16384,\n    \"output_tokens_details\": { \"image_tokens\": 16384 },\n    \"total_tokens\": 16384\n  }\n}\n```\n\n**5.0 成功（size 可能被改写）**：\n\n```json\n{\n  \"created\": 1782871081,\n  \"model\": \"doubao-seedream-5-0-260128\",\n  \"data\": [{\n    \"url\": \"https://ark-common-storage-prod-ap-southeast-1.tos-ap-southeast-1.volces.com/seedream/<id>.jpeg?X-Tos-Signature=...\",\n    \"size\": \"2k\"\n  }],\n  \"usage\": {\n    \"generated_images\": 1,\n    \"output_tokens\": 17800,\n    \"total_tokens\": 17800\n  }\n}\n```\n\n| 返回字段 | 类型 | 说明 |\n|---|---|---|\n| `data[].url` | string | 火山引擎 TOS 直链，`X-Tos-Expires=86400`（24h） |\n| `data[].size` | string | 5.0 特有：服务端规范化后的档位 |\n| `size` | string | 服务端实际返回的 size（可能与请求不同） |\n| `usage.output_tokens` | integer | 计费 token，等于 image_tokens |\n| `usage.generated_images` | integer | 5.0 特有：生成的图片数量 |\n\n### 6. 注意事项\n\n- ⚠️ **不同版本像素规则不兼容**：升级 4.0 → 4.5 时必须同步抬高 size 至 ≥1920×1920\n- 🔁 5.0 的返回 `size` 可能与请求不一致（服务端自动规范化）\n- ⏰ `data[].url` 是火山引擎 TOS 直链，24 小时有效，建议及时转存\n- 📐 4.0 / 4.5 **不接受** aspect ratio 字符串或 `auto`，必须写具体 `WxH` 像素\n- 🎯 5.0 统一按 `output_tokens=17800` 计费，与请求档位无关\n\n### 7. 接入地址\n\n| 线路 | Base URL |\n|---|---|\n| 国内加速（推荐） | `https://iliu.ai` |\n| 海外直连 | `https://api.xinliu.one` |\n\n### 8. 错误码\n\n| 状态码 | 典型错误 | 原因 |\n|---|---|---|\n| `400` | `image size must be at least NNNNNN pixels` | size 低于当前模型的像素下限 |\n| `400` | `The parameter size specified in the request is not valid` | 传了 aspect ratio 或 `auto` |\n| `401` | — | 令牌无效 |\n| `402` | — | 余额不足 |\n| `503` | — | 上游不可用 |\n\n\n**错误响应格式**：\n\n```json\n{\n  \"error\": {\n    \"message\": \"具体错误描述\",\n    \"type\": \"invalid_request_error\",\n    \"param\": \"model\",\n    \"code\": \"invalid_value\"\n  }\n}\n```\n\n| 字段 | 类型 | 说明 |\n|---|---|---|\n| `error.message` | string | 人类可读的错误描述 |\n| `error.type` | string | `invalid_request_error` / `authentication_error` / `new_api_error` |\n| `error.param` | string | 触发错误的参数名（仅参数类错误有值） |\n| `error.code` | string | 机器可读错误码，如 `invalid_value` `model_not_found` |\n",
        "responses": {
          "200": {
            "description": "成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "created": {
                      "type": "integer"
                    },
                    "data": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      }
                    },
                    "usage": {
                      "type": "object",
                      "properties": {}
                    }
                  }
                },
                "example": {
                  "created": 0,
                  "data": [
                    "string"
                  ],
                  "usage": {}
                }
              }
            }
          }
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "model": {
                    "type": "string"
                  },
                  "prompt": {
                    "type": "string"
                  },
                  "size": {
                    "type": "string"
                  },
                  "n": {
                    "type": "integer"
                  }
                }
              },
              "example": {
                "model": "string",
                "prompt": "string",
                "size": "string",
                "n": 0
              }
            }
          }
        }
      }
    },
    "/v1/videos": {
      "post": {
        "tags": [
          "视频模型"
        ],
        "summary": "Veo 3.1 视频生成",
        "operationId": "op_477735159",
        "description": "### 1. 功能介绍\n\nGoogle Veo 3.1 系列视频生成（异步）。提交返回 `task_id` → 轮询进度 → 下载 MP4。\n\n- 7 个变体，默认分组全覆盖\n- 支持文生视频、图生视频（`images` 数组）、首尾帧（`first_frame_image` + `last_frame_image`）\n- 生成完成走 `GET /v1/videos/{task_id}/content` 下载 H.264 MP4\n\n\n### 2. 可用型号\n\n| model | 说明 | enable_groups |\n|---|---|---|\n| `veo_3_1` | 720P 高质量 · 文生 / 多参考 | `default` |\n| `veo_3_1-fast` | 720P 快速 · 文生 / 多参考 | `default` |\n| `veo_3_1-fl` | 720P 高质量 · 首尾帧 | `default` |\n| `veo_3_1-fast-fl` | 720P 快速 · 首尾帧 | `default` |\n| `veo_3_1-hd` | 1080P 高清 · 文生 / 多参考 | `default` |\n| `veo_3_1-hd-fl` | 1080P · 首尾帧 | `default` |\n| `veo_3_1-fast-fl-hd` | 1080P 快速 · 首尾帧 | `default` |\n| `veo_3_1-lite` | 轻量版 · 文生（2026-07 实测新增） | ✅ 实测 `queued` |\n| `veo_3_1-lite-fl` | 轻量版 · 首尾帧（2026-07 实测新增） | ✅ 实测 `queued` |\n| `veo_3_1-fast-hd` | 1080P 快速 · 文生（2026-07 实测新增） | ⚠️ `default` 分组无渠道 `model_not_found` |\n| `veo_3_1-4K` | 4K 超清 | ⚠️ `default` 分组 503 无渠道 |\n\n### 3. 请求参数\n\n| 参数 | 类型 | 必填 | 说明 |\n|---|---|---|---|\n| `model` | string | ✅ | 模型名。见 §2 |\n| `prompt` | string | ✅ | 视频描述。多图参考可用 `@image1` / `@image2` 占位 |\n| `seconds` | string |  | 时长。**必须字符串**（`\"5\"`），推荐 5/8 秒 |\n| `size` | string |  | 分辨率。`\"1280x720\"` / `\"1920x1080\"` 等 |\n| `images` | array |  | 参考图 URL 数组。图生视频模式 |\n| `first_frame_image` | string |  | 首帧图 URL。`-fl` 变体专用 |\n| `last_frame_image` | string |  | 尾帧图 URL。`-fl` 变体专用 |\n| `aspect_ratio` | string |  | 宽高比。`\"16:9\"` / `\"9:16\"` / `\"1:1\"` |\n\n\n\n### 4. 支持范围（实测）\n\n#### Seconds\n\n对 `veo_3_1` / `veo_3_1-fast` / `veo_3_1-fast-fl` 提交以下值全部 `queued`：\n\n| seconds | 结果 | 说明 |\n|---|---|---|\n| `\"2\"` `\"3\"` `\"4\"` `\"5\"` `\"6\"` `\"8\"` `\"10\"` `\"12\"` `\"15\"` `\"20\"` `\"30\"` | ✅ 提交层接受 | Veo 3.1 通常生成 8 秒段落，过长可能截断 |\n\n> ⚠️ 提交层几乎不校验，真校验在异步阶段。推荐 **5 / 8 秒**。\n\n#### Size\n\n对 `veo_3_1` / `veo_3_1-fast` 提交以下全部 queued：\n\n| size | 结果 |\n|---|---|\n| `1280x720` / `1920x1080` / `1080x1920` / `720x1280` / `512x512` | ✅ |\n| `16:9` / `9:16` / `1:1`（aspect_ratio 字符串） | ✅ |\n\n对 `veo_3_1-fast-fl`（首尾帧变体）：\n\n| size/aspect | 结果 |\n|---|---|\n| `1280x720` / `1920x1080` / `1080x1920` / `720x1280` | ✅ |\n| `16:9` / `1:1` / `9:16` | ❌ `fail_to_fetch_task` |\n| `512x512` | ❌ `fail_to_fetch_task` |\n\n> ⚠️ 首尾帧变体（`-fl` 系）对 aspect_ratio 和 512x512 敏感，推荐用具体像素。\n\n\n\n### 5. 返回响应\n\n```json\n{\n  \"id\": \"task_r2bWgmjF20NV2RfbEfUnJwYk5RO3Aqmo\",\n  \"task_id\": \"task_r2bWgmjF20NV2RfbEfUnJwYk5RO3Aqmo\",\n  \"object\": \"video\",\n  \"model\": \"veo-3.1-fast\",\n  \"status\": \"queued\",\n  \"progress\": 0,\n  \"created_at\": 1782874934\n}\n```\n\n| 返回字段 | 类型 | 说明 |\n|---|---|---|\n| `task_id` | string | 任务 ID，用于轮询和下载 |\n| `status` | string | `queued` / `in_progress` / `processing` |\n| `progress` | integer | 0~100 |\n\n### 6. 注意事项\n\n- ⚠️ `seconds` 必须字符串，传数字 400\n- 🔒 内容审核不通过 → `status=failed`，不消耗额度\n- ⏱️ 30~120 秒完成，5~10 秒轮询一次\n- 🎬 下载：`GET /v1/videos/{task_id}/content`\n- 📋 轮询：`GET /v1/videos/{task_id}`\n\n### 7. 接入地址\n\n| 线路 | Base URL |\n|---|---|\n| 国内加速 | `https://iliu.ai` |\n| 海外直连 | `https://api.xinliu.one` |\n\n### 8. 错误码\n\n| 状态码 | 典型错误 | 原因 |\n|---|---|---|\n| `400` | `cannot unmarshal number into Go struct field .Alias.seconds` | `seconds` 传了数字 |\n| `401` | — | 令牌无效 |\n| `402` | — | 余额不足 |\n| `503` | `No available channel` | 上游不可用 |\n\n\n**错误响应格式**：\n\n```json\n{\n  \"error\": {\n    \"message\": \"具体错误描述\",\n    \"type\": \"invalid_request_error\",\n    \"param\": \"model\",\n    \"code\": \"invalid_value\"\n  }\n}\n```\n\n| 字段 | 类型 | 说明 |\n|---|---|---|\n| `error.message` | string | 人类可读的错误描述 |\n| `error.type` | string | `invalid_request_error` / `authentication_error` / `new_api_error` |\n| `error.param` | string | 触发错误的参数名（仅参数类错误有值） |\n| `error.code` | string | 机器可读错误码，如 `invalid_value` `model_not_found` |\n",
        "responses": {
          "200": {
            "description": "成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string"
                    },
                    "task_id": {
                      "type": "string"
                    },
                    "model": {
                      "type": "string"
                    },
                    "status": {
                      "type": "string"
                    },
                    "progress": {
                      "type": "integer"
                    },
                    "created_at": {
                      "type": "integer"
                    }
                  }
                },
                "example": {
                  "id": "string",
                  "task_id": "string",
                  "model": "string",
                  "status": "string",
                  "progress": 0,
                  "created_at": 0
                }
              }
            }
          }
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "model": {
                    "type": "string"
                  },
                  "prompt": {
                    "type": "string"
                  },
                  "seconds": {
                    "type": "string"
                  },
                  "size": {
                    "type": "string"
                  },
                  "images": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    }
                  },
                  "first_frame_image": {
                    "type": "string"
                  },
                  "last_frame_image": {
                    "type": "string"
                  }
                }
              },
              "example": {
                "model": "string",
                "prompt": "string",
                "seconds": "string",
                "size": "string",
                "images": [
                  "string"
                ],
                "first_frame_image": "string",
                "last_frame_image": "string"
              }
            }
          }
        }
      }
    },
    "/v1/videos#omni": {
      "post": {
        "tags": [
          "视频模型"
        ],
        "summary": "Omni 视频生成",
        "operationId": "op_477735985",
        "description": "### 1. 功能介绍\n\nGoogle/Gemini **Omni** 系列视频生成（异步）。支持文生、图生、视频改视频（v2v）。10 秒时长。\n\n\n### 2. 可用型号\n\n| model | 说明 | enable_groups |\n|---|---|---|\n| `omni-flash-10s` | Omni Flash 10s（OpenAI 端点版） | `default` |  |\n| `omni_flash-v2v` | 视频编辑 上传视频url | `default` |\n| `omni_flash-10s` | 支持7张参考图 支持视频修改 10s | `default` |\n| `omni_flash` | 10s | `default` |\n| `omni_flash_nowater` | 无水印 10s（→ 上游 `omni-fast`，2026-07 实测新增） | ✅ 实测 `queued` |\n| `omni_flash_nowater-v2v` | 无水印 · 视频改视频（→ 上游 `omni-fast-v2v`） | ✅ 实测 `queued` |\n\n> ⚠️ 无水印变体 `prompt` 至少 **5 个非符号字符**，否则 400 `prompt is too short`。`omni-flash-10s` 对部分令牌返回 401 `Invalid token`，需换分组。\n\n### 3. 请求参数\n\n| 参数 | 类型 | 必填 | 说明 |\n|---|---|---|---|\n| `model` | string | ✅ | 见 §2 |\n| `prompt` | string | ✅ | 视频描述 |\n| `seconds` | string |  | `\"10\"` |\n| `size` | string |  | `\"1280x720\"` 等 |\n| `images_list` | string[] |  | 参考图 URL 数组（最多 7 张） |\n| `video_files` | string[] |  | 参考视频 URL（v2v 模式） |\n\n\n### 4. 支持范围（实测）\n\n#### Seconds\n\n对 `omni_flash` / `omni_flash-10s` 提交以下全部 queued：`\"2\"`~`\"30\"`\n\n#### Size\n\n| size | omni_flash | omni_flash-10s | omni_flash-v2v |\n|---|---|---|---|\n| `1280x720` | ✅ | ✅ | ✅ |\n| `1920x1080` / `720x1280` / `1080x1920` | ✅ | ✅ | ✅ |\n| `512x512` | ✅ | ✅ | ✅ |\n| `16:9` / `9:16` / `1:1` | ✅ | ❌ `fail_to_fetch_task` | ✅ |\n\n> ⚠️ `omni_flash-10s` **不接受 aspect_ratio 字符串**，只接受具体像素。\n\n\n\n### 5. 返回响应\n\n```json\n{\n  \"id\": \"task_sTardssGL50pTG5yWWtaMUFNLUKcD5ka\",\n  \"task_id\": \"task_sTardssGL50pTG5yWWtaMUFNLUKcD5ka\",\n  \"object\": \"video\",\n  \"model\": \"omni-fast\",\n  \"status\": \"queued\",\n  \"progress\": 0,\n  \"created_at\": 1782874972\n}\n```\n\n### 6. 接入地址\n\n| 线路 | Base URL |\n|---|---|\n| 国内加速 | `https://iliu.ai` |\n| 海外直连 | `https://api.xinliu.one` |\n\n### 7. 错误码\n\n| 状态码 | 说明 |\n|---|---|\n| `400` | 参数错误 |\n| `401` | 令牌无效 |\n| `503` | 上游不可用 |\n\n\n**错误响应格式**：\n\n```json\n{\n  \"error\": {\n    \"message\": \"具体错误描述\",\n    \"type\": \"invalid_request_error\",\n    \"param\": \"model\",\n    \"code\": \"invalid_value\"\n  }\n}\n```\n\n| 字段 | 类型 | 说明 |\n|---|---|---|\n| `error.message` | string | 人类可读的错误描述 |\n| `error.type` | string | `invalid_request_error` / `authentication_error` / `new_api_error` |\n| `error.param` | string | 触发错误的参数名（仅参数类错误有值） |\n| `error.code` | string | 机器可读错误码，如 `invalid_value` `model_not_found` |\n",
        "responses": {
          "200": {
            "description": "成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string"
                    },
                    "task_id": {
                      "type": "string"
                    },
                    "status": {
                      "type": "string"
                    }
                  }
                },
                "example": {
                  "id": "string",
                  "task_id": "string",
                  "status": "string"
                }
              }
            }
          }
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "model": {
                    "type": "string"
                  },
                  "prompt": {
                    "type": "string"
                  },
                  "seconds": {
                    "type": "string"
                  },
                  "size": {
                    "type": "string"
                  },
                  "input_reference": {
                    "type": "string"
                  }
                }
              },
              "example": {
                "model": "string",
                "prompt": "string",
                "seconds": "string",
                "size": "string",
                "input_reference": "string"
              }
            }
          }
        }
      }
    },
    "/v1/videos#veo-3.1-extend": {
      "post": {
        "tags": [
          "视频模型"
        ],
        "summary": "Veo 3.1 视频延长（Extend）",
        "operationId": "op_477735160",
        "description": "### 1. 功能介绍\n\n对已完成的 Veo 视频任务进行**延长续写**。需提供源 Veo 视频的 `task_id`。\n\n\n### 2. 可用型号\n\n| model | 说明 | enable_groups |\n|---|---|---|\n| `veo_3_1-fast-extend` | Veo 3.1 延长续写 | `default` |\n\n### 3. 请求参数\n\n| 参数 | 类型 | 必填 | 说明 |\n|---|---|---|---|\n| `model` | string | ✅ | `veo_3_1-fast-extend` |\n| `prompt` | string | ✅ | 延长内容描述 |\n| `seconds` | string |  | 延长秒数 |\n| `input_reference` | string |  | 源 Veo 视频的 `task_id` |\n\n\n### 4. 调用流程\n\n```\n① POST /v1/videos (Veo 生成) → task_id_A\n② POST /v1/videos (本接口, input_reference=task_id_A) → task_id_B\n③ GET /v1/videos/{task_id_B} → 轮询\n④ GET /v1/videos/{task_id_B}/content → 下载\n```\n\n### 5. 返回响应\n\n```json\n{\n  \"id\": \"task_xxx\",\n  \"task_id\": \"task_xxx\",\n  \"status\": \"queued\",\n  \"progress\": 0\n}\n```\n\n### 6. 接入地址\n\n| 线路 | Base URL |\n|---|---|\n| 国内加速 | `https://iliu.ai` |\n| 海外直连 | `https://api.xinliu.one` |\n\n### 7. 错误码\n\n| 状态码 | 说明 |\n|---|---|\n| `400` | 缺少 `input_reference` |\n| `401` | 令牌无效 |\n| `503` | 上游不可用 |\n\n\n**错误响应格式**：\n\n```json\n{\n  \"error\": {\n    \"message\": \"具体错误描述\",\n    \"type\": \"invalid_request_error\",\n    \"param\": \"model\",\n    \"code\": \"invalid_value\"\n  }\n}\n```\n\n| 字段 | 类型 | 说明 |\n|---|---|---|\n| `error.message` | string | 人类可读的错误描述 |\n| `error.type` | string | `invalid_request_error` / `authentication_error` / `new_api_error` |\n| `error.param` | string | 触发错误的参数名（仅参数类错误有值） |\n| `error.code` | string | 机器可读错误码，如 `invalid_value` `model_not_found` |\n",
        "responses": {
          "200": {
            "description": "成功"
          }
        }
      }
    },
    "/v1/videos#sora-2": {
      "post": {
        "tags": [
          "视频模型"
        ],
        "summary": "Sora 2 视频生成",
        "operationId": "op_477735498",
        "description": "### 1. 功能介绍\n\nOpenAI **Sora 2** 系列视频生成（异步）。文生视频，支持 4s 和 12s 时长。\n\n\n### 2. 可用型号\n\n| model | 说明 | enable_groups |\n|---|---|---|\n| `sora-2` | Sora 2（4s 默认） | `default` |\n| `sora-2-12s` | Sora 2（12s） | `default` |\n| `sora-2-openai-12s` | Sora 2 官转（12s） | `sora官方` `soravip` |\n\n### 3. 请求参数\n\n| 参数 | 类型 | 必填 | 说明 |\n|---|---|---|---|\n| `model` | string | ✅ | 见 §2 |\n| `prompt` | string | ✅ | 视频描述 |\n| `seconds` | string |  | `\"4\"` / `\"12\"` |\n| `size` | string |  | `\"720x1280\"` / `\"1280x720\"` |\n\n\n### 4. 支持范围（实测）\n\n#### Seconds\n\n| model | seconds | 结果 |\n|---|---|---|\n| `sora-2` | `\"4\"` `\"8\"` `\"12\"` | ✅ |\n| `sora-2-12s` | `\"4\"` `\"8\"` `\"12\"` `\"20\"` | ✅ |\n\n#### Size\n\n| size | 结果 |\n|---|---|\n| `720x1280`（竖版） | ✅ |\n| `1280x720`（横版） | ✅ |\n\n\n\n### 5. 返回响应\n\n```json\n{\n  \"id\": \"task_xxx\",\n  \"task_id\": \"task_xxx\",\n  \"object\": \"video\",\n  \"model\": \"sora-2\",\n  \"status\": \"queued\",\n  \"progress\": 0,\n  \"created_at\": 1782353660\n}\n```\n\n### 6. 接入地址\n\n| 线路 | Base URL |\n|---|---|\n| 国内加速 | `https://iliu.ai` |\n| 海外直连 | `https://api.xinliu.one` |\n\n### 7. 错误码\n\n| 状态码 | 说明 |\n|---|---|\n| `400` | 参数错误或 length 不匹配 |\n| `401` | 令牌无效 |\n| `503` | `No available channel`（如用官转变体但未开通 sora 分组） |\n\n\n**错误响应格式**：\n\n```json\n{\n  \"error\": {\n    \"message\": \"具体错误描述\",\n    \"type\": \"invalid_request_error\",\n    \"param\": \"model\",\n    \"code\": \"invalid_value\"\n  }\n}\n```\n\n| 字段 | 类型 | 说明 |\n|---|---|---|\n| `error.message` | string | 人类可读的错误描述 |\n| `error.type` | string | `invalid_request_error` / `authentication_error` / `new_api_error` |\n| `error.param` | string | 触发错误的参数名（仅参数类错误有值） |\n| `error.code` | string | 机器可读错误码，如 `invalid_value` `model_not_found` |\n",
        "responses": {
          "200": {
            "description": "成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string"
                    },
                    "task_id": {
                      "type": "string"
                    },
                    "status": {
                      "type": "string"
                    },
                    "progress": {
                      "type": "integer"
                    }
                  }
                },
                "example": {
                  "id": "string",
                  "task_id": "string",
                  "status": "string",
                  "progress": 0
                }
              }
            }
          }
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "model": {
                    "type": "string"
                  },
                  "prompt": {
                    "type": "string"
                  },
                  "seconds": {
                    "type": "string"
                  },
                  "size": {
                    "type": "string"
                  },
                  "input_reference": {
                    "type": "string"
                  }
                }
              },
              "example": {
                "model": "string",
                "prompt": "string",
                "seconds": "string",
                "size": "string",
                "input_reference": "string"
              }
            }
          }
        }
      }
    },
    "/v1/videos#sora-3": {
      "post": {
        "tags": [
          "视频模型"
        ],
        "summary": "Sora 3 视频生成",
        "operationId": "op_sora3_verified",
        "description": "### 1. 功能介绍\n\nOpenAI **Sora 3** 系列视频生成（异步）。文生视频，与 Sora 2 共用 `POST /v1/videos` 端点，通过 `model` 区分。提交后返回任务 ID，再用 `GET /v1/videos/{id}` 轮询、`GET /v1/videos/{id}/content` 下载。\n\n> 2026-07 实测补录：Sora 3 此前未收录于文档，本条目为实测新增。\n\n### 2. 可用型号（2026-07 实测）\n\n| model | 说明 | 状态 |\n|---|---|---|\n| `sora-v3-933-fast` | Sora 3 快速版 | ✅ 实测可用（返回 `status: processing`） |\n| `sora-v3-933-pro` | Sora 3 Pro | ✅ 实测可用 |\n| `sora-v3-933-pro-480p` | Sora 3 Pro 480p | ✅ 实测可用 |\n| `sora3-vip5-480p` / `720p` / `1080p` | Sora 3 VIP5 | ⚠️ `default` 分组无可用渠道（503），需开通 VIP 分组 |\n| `sora3-vip5-fast-480p` / `720p` / `1080p` | Sora 3 VIP5 快速 | ⚠️ 同上，503 |\n| `sora-v4-fast` / `sora-v4-pro` | Sora 4 | ⚠️ `default` 分组无可用渠道（503） |\n\n### 3. 请求参数\n\n| 参数 | 类型 | 必填 | 说明 |\n|---|---|---|---|\n| `model` | string | ✅ | 见 §2 |\n| `prompt` | string | ✅ | 视频描述 |\n| `seconds` | string |  | 时长，如 `\"4\"`（与 Sora 2 一致） |\n| `size` | string |  | 分辨率，如 `\"720x1280\"` / `\"1280x720\"`；pro/480p 变体由 model 名决定输出档位 |\n\n### 4. 返回响应\n\n```json\n{\n  \"id\": \"task_lQiB7zOA83KKI5IpNDxtbdnO6639wcUA\",\n  \"task_id\": \"task_lQiB7zOA83KKI5IpNDxtbdnO6639wcUA\",\n  \"object\": \"video\",\n  \"model\": \"sora-v3-933-fast\",\n  \"status\": \"processing\",\n  \"progress\": 0,\n  \"created_at\": 1783995000\n}\n```\n\n轮询任务：`GET /v1/videos/{id}`；下载成片：`GET /v1/videos/{id}/content`。\n\n### 5. 接入地址\n\n| 线路 | Base URL |\n|---|---|\n| 国内加速 | `https://iliu.ai` |\n| 海外直连（实测可用） | `https://api.xinliu.one` |\n\n### 6. 错误码\n\n| 状态码 | 典型响应 | 原因 |\n|---|---|---|\n| `400` | `参数错误` | 参数缺失或不合法 |\n| `401` | `Invalid token` | 令牌无效 |\n| `503` | `无可用渠道（distributor）` | 该分组未开通此模型（如 vip5 / v4 变体） |\n",
        "responses": {
          "200": {
            "description": "成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string"
                    },
                    "task_id": {
                      "type": "string"
                    },
                    "object": {
                      "type": "string"
                    },
                    "model": {
                      "type": "string"
                    },
                    "status": {
                      "type": "string"
                    }
                  }
                },
                "example": {
                  "id": "task_lQiB7zOA83KKI5IpNDxtbdnO6639wcUA",
                  "task_id": "task_lQiB7zOA83KKI5IpNDxtbdnO6639wcUA",
                  "object": "video",
                  "model": "sora-v3-933-fast",
                  "status": "processing"
                }
              }
            }
          }
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "model": {
                    "type": "string"
                  },
                  "prompt": {
                    "type": "string"
                  },
                  "seconds": {
                    "type": "string"
                  },
                  "size": {
                    "type": "string"
                  }
                }
              },
              "example": {
                "model": "sora-v3-933-fast",
                "prompt": "a cat walking in a sunny garden",
                "seconds": "4",
                "size": "720x1280"
              }
            }
          }
        }
      }
    },
    "/v1/videos#grok-imagine-video-preview": {
      "post": {
        "tags": [
          "视频模型"
        ],
        "summary": "Grok Imagine Video Preview 视频生成",
        "operationId": "op_477735972",
        "description": "### 1. 功能介绍\n\nxAI **Grok Imagine Video Preview**（异步）。备用通道，支持文生和图生两种模式。\n\n\n### 2. 可用型号\n\n| model | 说明 | enable_groups |\n|---|---|---|\n| `grok-imagine-video-preview` | 备用 · 文生 / 图生 | `default` |\n| `grok-imagine-video-1.5-preview` | 1.5 Preview · 720p 单图 15s | `default` |\n\n### 3. 请求参数\n\n| 参数 | 类型 | 必填 | 说明 |\n|---|---|---|---|\n| `model` | string | ✅ | 见 §2 |\n| `prompt` | string | ✅ | 视频描述 |\n| `seconds` | string |  | 时长 |\n| `size` | string |  | `\"1280x720\"` 等 |\n| `image` | string |  | 参考图 URL |\n\n\n### 4. 支持范围（实测）\n\n#### Size\n\n| size | 结果 |\n|---|---|\n| `1280x720` / `720x1280` | ✅ |\n| `1080x1920` / `1920x1080` | ❌ `fail_to_fetch_task` |\n\n\n\n### 5. 返回响应\n\n```json\n{\"id\":\"task_xxx\",\"task_id\":\"task_xxx\",\"object\":\"video\",\"status\":\"queued\",\"progress\":0}\n```\n\n### 6. 接入地址\n\n| 线路 | Base URL |\n|---|---|\n| 国内加速（推荐） | `https://iliu.ai` |\n| 海外直连 | `https://api.xinliu.one` |\n\n\n### 7. 错误码\n\n| 状态码 | 典型错误 | 原因 |\n|---|---|---|\n| `400` | — | 参数错误，检查必填字段和值的格式 |\n| `401` | — | 令牌无效或缺失 |\n| `402` | — | 余额不足 |\n| `429` | — | 速率限制，降低并发 |\n| `503` | `No available channel` | 上游不可用或分组不匹配 |\n\n**错误响应格式**：\n\n```json\n{\n  \"error\": {\n    \"message\": \"具体错误描述\",\n    \"type\": \"invalid_request_error\",\n    \"param\": \"model\",\n    \"code\": \"invalid_value\"\n  }\n}\n```\n\n| 字段 | 类型 | 说明 |\n|---|---|---|\n| `error.message` | string | 人类可读的错误描述 |\n| `error.type` | string | `invalid_request_error` / `authentication_error` / `new_api_error` |\n| `error.param` | string | 触发错误的参数名（仅参数类错误有值） |\n| `error.code` | string | 机器可读错误码 |\n",
        "responses": {
          "200": {
            "description": "成功"
          }
        }
      }
    },
    "/v1/videos#grok-video-3": {
      "post": {
        "tags": [
          "视频模型"
        ],
        "summary": "Grok Video 3 视频生成",
        "operationId": "op_477735956",
        "description": "### 1. 功能介绍\n\nxAI **Grok Video 3** 系列视频生成（异步）。支持文生视频和多图参考，返回 `url`。\n\n\n### 2. 可用型号\n\n| model | 说明 | enable_groups |\n|---|---|---|\n| `grok-video-3-max` | Grok Video 3 Max（文生 / 多图） | `default` |\n\n### 3. 请求参数\n\n| 参数 | 类型 | 必填 | 说明 |\n|---|---|---|---|\n| `model` | string | ✅ | `grok-video-3-max` |\n| `prompt` | string | ✅ | 视频描述 |\n| `seconds` | string |  | 时长 |\n| `size` | string |  | `\"1280x720\"` / `\"720x1280\"` |\n\n\n### 4. 支持范围（实测）\n\n#### Seconds\n\n| seconds | 结果 |\n|---|---|\n| `\"2\"` `\"3\"` `\"4\"` `\"5\"` `\"6\"` `\"8\"` `\"10\"` `\"12\"` `\"15\"` `\"20\"` `\"30\"` | ✅ 全部 queued |\n\n#### Size\n\n| size | 结果 |\n|---|---|\n| `1280x720` / `720x1280` | ✅ |\n\n\n\n### 5. 返回响应\n\n```json\n{\n  \"id\": \"task_3q65PlNhIlCvK9z0o448dP1df8fjujWE\",\n  \"task_id\": \"task_3q65PlNhIlCvK9z0o448dP1df8fjujWE\",\n  \"object\": \"video\",\n  \"model\": \"grok-imagine-video\",\n  \"status\": \"queued\",\n  \"progress\": 0,\n  \"created_at\": 1782874965\n}\n```\n\n### 6. 注意事项\n\n- ✅ `completed` 响应**含 `video_url`**，可直接下载\n- 📋 也支持 `GET /v1/videos/{task_id}/content` 下载\n\n\n### 7. 接入地址\n\n| 线路 | Base URL |\n|---|---|\n| 国内加速（推荐） | `https://iliu.ai` |\n| 海外直连 | `https://api.xinliu.one` |\n\n\n### 8. 错误码\n\n| 状态码 | 典型错误 | 原因 |\n|---|---|---|\n| `400` | — | 参数错误，检查必填字段和值的格式 |\n| `401` | — | 令牌无效或缺失 |\n| `402` | — | 余额不足 |\n| `429` | — | 速率限制，降低并发 |\n| `503` | `No available channel` | 上游不可用或分组不匹配 |\n\n**错误响应格式**：\n\n```json\n{\n  \"error\": {\n    \"message\": \"具体错误描述\",\n    \"type\": \"invalid_request_error\",\n    \"param\": \"model\",\n    \"code\": \"invalid_value\"\n  }\n}\n```\n\n| 字段 | 类型 | 说明 |\n|---|---|---|\n| `error.message` | string | 人类可读的错误描述 |\n| `error.type` | string | `invalid_request_error` / `authentication_error` / `new_api_error` |\n| `error.param` | string | 触发错误的参数名（仅参数类错误有值） |\n| `error.code` | string | 机器可读错误码 |\n",
        "responses": {
          "200": {
            "description": "成功"
          }
        }
      }
    },
    "/v1/videos#grok-video-6s-10s-12s": {
      "post": {
        "tags": [
          "视频模型"
        ],
        "summary": "Grok Video 6s/10s/12s 视频生成",
        "operationId": "op_477735965",
        "description": "### 1. 功能介绍\n\nxAI Grok Video **6s / 10s / 12s** 系列（异步）。文生视频。\n\n> ⚠️ **关键差异**：`completed` 响应**不含任何 URL 字段**，只能通过 `GET /v1/videos/{task_id}/content` 下载视频。\n\n\n### 2. 可用型号\n\n| model | 说明 | enable_groups |\n|---|---|---|\n| `grok-video-10s` | Grok Video 10s | `default` |\n\n### 3. 请求参数\n\n| 参数 | 类型 | 必填 | 说明 |\n|---|---|---|---|\n| `model` | string | ✅ | 见 §2 |\n| `prompt` | string | ✅ | 视频描述 |\n| `seconds` | string |  | `\"6\"` / `\"10\"` / `\"12\"` |\n| `size` | string |  | `\"1280x720\"` |\n\n\n### 4. 支持范围（实测）\n\n#### 关键差异\n\n| 特性 | Grok Video 3 | Grok Video 6/10/12s |\n|---|---|---|\n| Size 支持 | ✅ `1280x720` | ✅ `1280x720` |\n| completed 返回 url | ✅ 有 `video_url` | ❌ **无任何 URL 字段** |\n| 下载方式 | url 或 /content | **仅** `/content` |\n\n> ⚠️ 对接时判断\"有 url 就用 url、没 url 就走 /content\"，别只读 url 字段。\n\n\n\n### 5. 返回响应\n\n**查询（completed）** — 注意**没有 `url` 字段**：\n\n```json\n{\n  \"id\": \"task_uh3B5YC4DurIkKMtzq4fkc5hr99Vp9po\",\n  \"size\": \"1280x720\",\n  \"model\": \"grok-video-6s\",\n  \"object\": \"video\",\n  \"status\": \"completed\",\n  \"progress\": 100,\n  \"seconds\": \"6\",\n  \"created_at\": 1778141892,\n  \"completed_at\": 1778141950\n}\n```\n\n### 6. 调用流程\n\n```\n① POST /v1/videos → task_id\n② GET  /v1/videos/{task_id} → 轮询至 completed（注意无 url！）\n③ GET  /v1/videos/{task_id}/content → 下载 MP4 ⭐ 唯一渠道\n```\n\n\n### 7. 接入地址\n\n| 线路 | Base URL |\n|---|---|\n| 国内加速（推荐） | `https://iliu.ai` |\n| 海外直连 | `https://api.xinliu.one` |\n\n\n### 8. 错误码\n\n| 状态码 | 典型错误 | 原因 |\n|---|---|---|\n| `400` | — | 参数错误，检查必填字段和值的格式 |\n| `401` | — | 令牌无效或缺失 |\n| `402` | — | 余额不足 |\n| `429` | — | 速率限制，降低并发 |\n| `503` | `No available channel` | 上游不可用或分组不匹配 |\n\n**错误响应格式**：\n\n```json\n{\n  \"error\": {\n    \"message\": \"具体错误描述\",\n    \"type\": \"invalid_request_error\",\n    \"param\": \"model\",\n    \"code\": \"invalid_value\"\n  }\n}\n```\n\n| 字段 | 类型 | 说明 |\n|---|---|---|\n| `error.message` | string | 人类可读的错误描述 |\n| `error.type` | string | `invalid_request_error` / `authentication_error` / `new_api_error` |\n| `error.param` | string | 触发错误的参数名（仅参数类错误有值） |\n| `error.code` | string | 机器可读错误码 |\n",
        "responses": {
          "200": {
            "description": "成功"
          }
        }
      }
    },
    "/v1/videos#grok-imagine-1.0": {
      "post": {
        "tags": [
          "视频模型"
        ],
        "summary": "Grok Imagine 1.0 视频生成",
        "operationId": "op_477735966",
        "description": "### 1. 功能介绍\n\nxAI **Grok Imagine 1.0 视频**生成（异步）。Grok Imagine 多模态模型的视频生成分支，支持 6s/10s。\n\n\n### 2. 可用型号\n\n| model | 说明 | enable_groups |\n|---|---|---|\n| `grok-imagine-1.0-video` | Grok Imagine 1.0 视频（6s/10s） | `default` |\n| `grok-imagine-1.0-video-16s` | Grok Imagine 1.0 视频 16s（2026-07 实测新增） | ✅ 实测 `queued` |\n\n### 3. 请求参数\n\n| 参数 | 类型 | 必填 | 说明 |\n|---|---|---|---|\n| `model` | string | ✅ | `grok-imagine-1.0-video` |\n| `prompt` | string | ✅ | 视频描述 |\n| `seconds` | string |  | `\"6\"` / `\"10\"` |\n| `size` | string |  | `\"1280x720\"` / `\"720x1280\"` |\n\n\n### 4. 支持范围（实测）\n\n#### Size\n\n| size | 结果 |\n|---|---|\n| `1280x720` / `720x1280` | ✅ |\n| `16:9` / `9:16` / `1:1` | ✅ |\n| `1080x1920` / `1920x1080` | ❌ `fail_to_fetch_task` |\n| `512x512` | ❌ `fail_to_fetch_task` |\n\n#### Seconds\n\n| seconds | 结果 |\n|---|---|\n| `\"6\"` / `\"10\"` | ✅ |\n\n\n\n### 5. 返回响应\n\n```json\n{\"id\":\"task_xxx\",\"task_id\":\"task_xxx\",\"object\":\"video\",\"status\":\"queued\",\"progress\":0}\n```\n\n### 6. 接入地址\n\n| 线路 | Base URL |\n|---|---|\n| 国内加速（推荐） | `https://iliu.ai` |\n| 海外直连 | `https://api.xinliu.one` |\n\n\n### 7. 错误码\n\n| 状态码 | 典型错误 | 原因 |\n|---|---|---|\n| `400` | — | 参数错误，检查必填字段和值的格式 |\n| `401` | — | 令牌无效或缺失 |\n| `402` | — | 余额不足 |\n| `429` | — | 速率限制，降低并发 |\n| `503` | `No available channel` | 上游不可用或分组不匹配 |\n\n**错误响应格式**：\n\n```json\n{\n  \"error\": {\n    \"message\": \"具体错误描述\",\n    \"type\": \"invalid_request_error\",\n    \"param\": \"model\",\n    \"code\": \"invalid_value\"\n  }\n}\n```\n\n| 字段 | 类型 | 说明 |\n|---|---|---|\n| `error.message` | string | 人类可读的错误描述 |\n| `error.type` | string | `invalid_request_error` / `authentication_error` / `new_api_error` |\n| `error.param` | string | 触发错误的参数名（仅参数类错误有值） |\n| `error.code` | string | 机器可读错误码 |\n",
        "responses": {
          "200": {
            "description": "成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string"
                    },
                    "task_id": {
                      "type": "string"
                    },
                    "status": {
                      "type": "string"
                    },
                    "progress": {
                      "type": "integer"
                    }
                  }
                },
                "example": {
                  "id": "string",
                  "task_id": "string",
                  "status": "string",
                  "progress": 0
                }
              }
            }
          }
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "model": {
                    "type": "string"
                  },
                  "prompt": {
                    "type": "string"
                  },
                  "seconds": {
                    "type": "string"
                  },
                  "size": {
                    "type": "string"
                  },
                  "input_reference": {
                    "type": "string"
                  }
                }
              },
              "example": {
                "model": "string",
                "prompt": "string",
                "seconds": "string",
                "size": "string",
                "input_reference": "string"
              }
            }
          }
        }
      }
    },
    "/v1/videos#grok-imagine-1.5-720p": {
      "post": {
        "tags": [
          "视频模型"
        ],
        "summary": "Grok Imagine 1.5 720p 视频生成",
        "operationId": "op_477735968",
        "description": "### 1. 功能介绍\n\nxAI **Grok Imagine 1.5 720p** 视频生成（异步）。只允许**一张图片参考**，15 秒时长。\n\n\n### 2. 可用型号\n\n| model | 说明 | enable_groups |\n|---|---|---|\n| `grok-imagine-1.5-video-super-720p` | Grok 1.5 Super 720p（15s，单图参考） | `default` |\n| `grok-imagine-video-1.5-1080p` | Grok Imagine 1.5 1080p（2026-07 实测新增） | ✅ 实测 `queued` |\n| `grok-imagine-video-1.5-fast` | Grok Imagine 1.5 快速 | ✅ 实测 `queued` |\n| `grok-imagine-video-1.5-fast-16s` | Grok Imagine 1.5 快速 16s | ✅ 实测 `queued` |\n\n> 上述新增 3 个变体均走 `POST /v1/videos`（与其它 Grok 视频共用端点，`model` 区分）。另 `grok-imagine-video`（无版本号）当前上游返回 404，不可用。\n\n### 3. 请求参数\n\n| 参数 | 类型 | 必填 | 说明 |\n|---|---|---|---|\n| `model` | string | ✅ | `grok-imagine-1.5-video-super-720p` |\n| `prompt` | string | ✅ | 视频描述，**最长 4096 字符** |\n| `seconds` | string |  | `\"15\"` |\n| `image` | string |  | 参考图 URL（**仅一张**） |\n\n\n### 4. 支持范围（实测）\n\n#### Size（1.5 系列）\n\n| size | Grok Imagine 1.5 fast | Grok Imagine 1.5 preview |\n|---|---|---|\n| `1280x720` / `720x1280` | ✅ | ✅ |\n| `16:9` / `9:16` / `1:1` | ✅ | ❌ `fail_to_fetch_task` |\n| `1080x1920` / `1920x1080` | ❌ | ❌ |\n| `512x512` | ❌ | ❌ |\n\n> ⚠️ **1.5 preview 只接受具体像素**，不接受 aspect_ratio 字符串；1.5 fast 则两者都接受。\n\n\n\n### 5. 返回响应\n\n```json\n{\"id\":\"task_xxx\",\"task_id\":\"task_xxx\",\"object\":\"video\",\"status\":\"queued\",\"progress\":0}\n```\n\n### 6. 接入地址\n\n| 线路 | Base URL |\n|---|---|\n| 国内加速（推荐） | `https://iliu.ai` |\n| 海外直连 | `https://api.xinliu.one` |\n\n\n### 7. 错误码\n\n| 状态码 | 典型错误 | 原因 |\n|---|---|---|\n| `400` | — | 参数错误，检查必填字段和值的格式 |\n| `401` | — | 令牌无效或缺失 |\n| `402` | — | 余额不足 |\n| `429` | — | 速率限制，降低并发 |\n| `503` | `No available channel` | 上游不可用或分组不匹配 |\n\n**错误响应格式**：\n\n```json\n{\n  \"error\": {\n    \"message\": \"具体错误描述\",\n    \"type\": \"invalid_request_error\",\n    \"param\": \"model\",\n    \"code\": \"invalid_value\"\n  }\n}\n```\n\n| 字段 | 类型 | 说明 |\n|---|---|---|\n| `error.message` | string | 人类可读的错误描述 |\n| `error.type` | string | `invalid_request_error` / `authentication_error` / `new_api_error` |\n| `error.param` | string | 触发错误的参数名（仅参数类错误有值） |\n| `error.code` | string | 机器可读错误码 |\n",
        "responses": {
          "200": {
            "description": "成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string"
                    },
                    "task_id": {
                      "type": "string"
                    },
                    "status": {
                      "type": "string"
                    },
                    "progress": {
                      "type": "integer"
                    }
                  }
                },
                "example": {
                  "id": "string",
                  "task_id": "string",
                  "status": "string",
                  "progress": 0
                }
              }
            }
          }
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "model": {
                    "type": "string"
                  },
                  "prompt": {
                    "type": "string"
                  },
                  "input_reference": {
                    "type": "string"
                  },
                  "seconds": {
                    "type": "string"
                  }
                }
              },
              "example": {
                "model": "string",
                "prompt": "string",
                "input_reference": "string",
                "seconds": "string"
              }
            }
          }
        }
      }
    },
    "/v1/videos#grok-imagine-1.5-preview": {
      "post": {
        "tags": [
          "视频模型"
        ],
        "summary": "Grok Imagine 1.5 Preview 视频生成",
        "operationId": "op_477736273",
        "description": "### 1. 功能介绍\n\nxAI **Grok Imagine Video Preview**（异步）。备用通道，支持文生和图生两种模式。\n\n\n### 2. 可用型号\n\n| model | 说明 | enable_groups |\n|---|---|---|\n| `grok-imagine-video-preview` | 备用 · 文生 / 图生 | `default` |\n| `grok-imagine-video-1.5-preview` | 1.5 Preview · 720p 单图 15s | `default` |\n\n### 3. 请求参数\n\n| 参数 | 类型 | 必填 | 说明 |\n|---|---|---|---|\n| `model` | string | ✅ | 见 §2 |\n| `prompt` | string | ✅ | 视频描述 |\n| `seconds` | string | ✅ | 时长 |\n| `size` | string | `\"1280x720\"` 等 |  |\n| `image` | string | 参考图 URL |  |\n\n\n### 4. 支持范围（实测）\n\n#### Size\n\n| size | 结果 |\n|---|---|\n| `1280x720` / `720x1280` | ✅ |\n| `1080x1920` / `1920x1080` | ❌ `fail_to_fetch_task` |\n\n\n### 5. 请求示例代码\n\n```bash\ncurl -X POST https://iliu.ai/v1/videos \\\n  -H \"Authorization: Bearer $API_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"model\":\"grok-imagine-video-preview\",\"prompt\":\"a red flower\",\"seconds\":\"6\",\"size\":\"1280x720\"}'\n```\n\n### 6. 返回响应\n\n```json\n{\"id\":\"task_xxx\",\"task_id\":\"task_xxx\",\"object\":\"video\",\"status\":\"queued\",\"progress\":0}\n```\n\n### 7. 接入地址\n\n| 线路 | Base URL |\n|---|---|\n| 国内加速（推荐） | `https://iliu.ai` |\n| 海外直连 | `https://api.xinliu.one` |\n\n\n### 8. 错误码\n\n| 状态码 | 典型错误 | 原因 |\n|---|---|---|\n| `400` | — | 参数错误，检查必填字段和值的格式 |\n| `401` | — | 令牌无效或缺失 |\n| `402` | — | 余额不足 |\n| `429` | — | 速率限制，降低并发 |\n| `503` | `No available channel` | 上游不可用或分组不匹配 |\n\n**错误响应格式**：\n\n```json\n{\n  \"error\": {\n    \"message\": \"具体错误描述\",\n    \"type\": \"invalid_request_error\",\n    \"param\": \"model\",\n    \"code\": \"invalid_value\"\n  }\n}\n```\n\n| 字段 | 类型 | 说明 |\n|---|---|---|\n| `error.message` | string | 人类可读的错误描述 |\n| `error.type` | string | `invalid_request_error` / `authentication_error` / `new_api_error` |\n| `error.param` | string | 触发错误的参数名（仅参数类错误有值） |\n| `error.code` | string | 机器可读错误码 |\n\n### 9. 相关文档\n\n- [视频任务查询](../视频模型/视频任务查询.md)\n- [视频内容下载](../视频模型/视频内容下载.md)\n- [全模型参数速查表](../帮助中心/全模型参数速查表.md)\n- [错误码大全](../帮助中心/错误码大全.md)\n",
        "responses": {
          "200": {
            "description": "成功"
          }
        }
      }
    },
    "/v1/videos#happyhorse-1.0": {
      "post": {
        "tags": [
          "HappyHorse"
        ],
        "summary": "HappyHorse 1.0 视频生成",
        "operationId": "op_477735981",
        "description": "### 1. 功能介绍\n\n阿里淘天 **HappyHorse 1.0** 系列视频生成（异步）。支持文生、图生、参考生视频、视频编辑。\n\n\n### 2. 可用型号\n\n| model | 说明 | enable_groups |\n|---|---|---|\n| `happyhorse-1.0-t2v` | 文生视频 | `default` |\n| `happyhorse-1.0-i2v` | 图生视频 | `default` |\n| `happyhorse-1.0-r2v` | 参考生视频 | `default` |\n| `happyhorse-1.0-video-edit` | 视频编辑 | `default` |\n\n### 3. 请求参数\n\n| 参数 | 类型 | 必填 | 说明 |\n|---|---|---|---|\n| `model` | string | ✅ | 见 §2 |\n| `prompt` | string | ✅ | 视频描述 |\n| `seconds` | string |  | 时长 |\n| `size` | string |  | `\"1280x720\"` |\n\n\n### 4. 返回响应\n\n```json\n{\"id\":\"task_xxx\",\"task_id\":\"task_xxx\",\"object\":\"video\",\"status\":\"queued\",\"progress\":0}\n```\n\n### 5. 接入地址\n\n| 线路 | Base URL |\n|---|---|\n| 国内加速（推荐） | `https://iliu.ai` |\n| 海外直连 | `https://api.xinliu.one` |\n\n\n### 6. 错误码\n\n| 状态码 | 典型错误 | 原因 |\n|---|---|---|\n| `400` | — | 参数错误，检查必填字段和值的格式 |\n| `401` | — | 令牌无效或缺失 |\n| `402` | — | 余额不足 |\n| `429` | — | 速率限制，降低并发 |\n| `503` | `No available channel` | 上游不可用或分组不匹配 |\n\n**错误响应格式**：\n\n```json\n{\n  \"error\": {\n    \"message\": \"具体错误描述\",\n    \"type\": \"invalid_request_error\",\n    \"param\": \"model\",\n    \"code\": \"invalid_value\"\n  }\n}\n```\n\n| 字段 | 类型 | 说明 |\n|---|---|---|\n| `error.message` | string | 人类可读的错误描述 |\n| `error.type` | string | `invalid_request_error` / `authentication_error` / `new_api_error` |\n| `error.param` | string | 触发错误的参数名（仅参数类错误有值） |\n| `error.code` | string | 机器可读错误码 |\n",
        "responses": {
          "200": {
            "description": "成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string"
                    },
                    "task_id": {
                      "type": "string"
                    },
                    "status": {
                      "type": "string"
                    }
                  }
                },
                "example": {
                  "id": "string",
                  "task_id": "string",
                  "status": "string"
                }
              }
            }
          }
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "model": {
                    "type": "string"
                  },
                  "prompt": {
                    "type": "string"
                  },
                  "seconds": {
                    "type": "string"
                  },
                  "input_reference": {
                    "type": "string"
                  },
                  "size": {
                    "type": "string"
                  }
                }
              },
              "example": {
                "model": "string",
                "prompt": "string",
                "seconds": "string",
                "input_reference": "string",
                "size": "string"
              }
            }
          }
        }
      }
    },
    "/v1/videos#seedance-2.0-fast": {
      "post": {
        "tags": [
          "HappyHorse"
        ],
        "summary": "豆包 Seedance 2.0 Fast 视频生成",
        "operationId": "op_477735992",
        "description": "### 1. 功能介绍\n\n字节跳动豆包 **Seedance 2.0** 视频生成（异步）。同族三个型号参数行为一致，以 fast 版为实测主力。支持文生视频与「全参考」（图片 + 视频混合参考，可用于换装 / 图生视频）。\n\n流程为三步异步：**提交 `POST /v1/videos` → 轮询 `GET /v1/videos/{taskId}` → 取直链 / 下载 `GET /v1/videos/{taskId}/content`**。\n\n\n### 2. 可用型号\n\n| model | 说明 | enable_groups |\n|---|---|---|\n| `doubao-seedance` | 系列前缀别名，能力兜底到 fast | `default` |\n| `doubao-seedance-2-0-260128` | 标准版 | `default` |\n| `doubao-seedance-2-0-fast-260128` | Fast 版（实测主力，能力以它为准） | `default` |\n\n> 三者上游同族、参数行为一致；项目只精确列出 fast 条目，其余变体通过 `doubao-seedance` 前缀 fallback 复用同一套能力。支持文生视频与「全参考」（图片 + 视频混合参考，可用于换装 / 图生视频）。\n\n### 3. 请求参数\n\n纯 JSON 提交用 `Content-Type: application/json`；带本地文件参考时用 `multipart/form-data`。\n\n| 参数 | 类型 | 必填 | 说明 | 是否生效 |\n|---|---|---|---|---|\n| `model` | string | ✅ | 上表三个 ID 之一 | — |\n| `prompt` | string | ✅ | 视频描述。带参考素材时需在文末按类型顺序追加 `@image1` / `@video1` 等标签 | ✅ |\n| `seconds` | string | ✖ | 时长秒数，**必须传字符串**（传数字会 400）。允许 `4` / `5` / `6` / `8` / `10`，下限 4 秒 | ✅ 生效 |\n| `size` | string | ✖ | 形如 `1280x720`（WxH） | ❌ 哑接受（实际输出恒为 `720x1280`） |\n| `aspect_ratio` | string | ✖ | 由 `size` 推导，如 `16:9`，与 `size` 一并发送 | 供推比例 |\n| `quality` | string | ✖ | 换装 / 参考场景固定传 `basic` | — |\n| `images` | string[] | ✖ | 图片参考 **URL** 数组（换装 / 参考图） | ✅ 生效 |\n| `video_urls` | string[] | ✖ | 视频参考 **URL** 数组（换装 / 参考视频） | ✅ 生效 |\n| `input_reference` | file(multipart) | ✖ | 本地**图片**文件上传参考 | ✅ 生效 |\n| `seed` | int | ✖ | 不支持，可不传 | ❌ 忽略 |\n\n> ⚠️ 参考图 / 视频字段是 `images` / `video_urls`，**不是** `reference_images`（后者会被静默忽略，不报错但参考不生效）；base64 内联图不被接受（返回 422），参考素材须用可下载 URL 或本地文件 multipart。\n\n\n\n### 4. 支持范围（实测 2026-07-16）\n\n#### Seconds（真参数，产出 mp4 时长精确跟随，误差 <0.1s）\n\n| seconds | 结果 |\n|---|---|\n| `\"4\"` `\"5\"` `\"6\"` `\"8\"` `\"10\"` | ✅ 生效，时长精确匹配 |\n| `\"3\"` | 被上顶到 4.10s（下限 4 秒） |\n| `\"12\"` | 因测试账户额度不足（403）未验证，非型号拒绝 |\n\n#### Size（不生效）\n\n请求 `1280x720` / `1920x1080` / `720x1280` / `1024x1024` 等，产出 mp4 **全部为 `720x1280`（竖向 720p）**，像素与朝向均不采纳。提交阶段全 200 不报错，属「哑接受」。\n\n\n### 5. 模式对照\n\n| 模式 | Content-Type | 关键字段 |\n|---|---|---|\n| 文生视频 | JSON / multipart | `model` `prompt` `seconds` |\n| 图片 URL 参考 | JSON | `+ images` |\n| 视频 URL 参考 | JSON | `+ video_urls` |\n| 图 + 视频全参考（换装） | JSON | `+ images` `+ video_urls` `+ quality:\"basic\"` |\n| 本地图片文件参考 | multipart | `+ input_reference` |\n\n> **参考素材顺序**：prompt 里用按类型连续编号的标签引用——图片 `@image1` / `@image2`…、视频 `@video1` / `@video2`…（编号 = 该类型内数组下标，从 1 起）。无法在正文精确定位时，把 `@imageN` / `@videoN` 直接追加到 prompt 末尾即可保证上游按序对齐。\n\n\n### 6. 返回响应\n\n**提交响应**（任务标识可能在 `task_id` 或 `id`，取 `task_id || id`）：\n\n```json\n{\n  \"task_id\": \"xxxxxxxx\",\n  \"model\": \"doubao-seedance-2-0-fast-260128\",\n  \"status\": \"queued\"\n}\n```\n\n**轮询完成响应**（`GET /v1/videos/{taskId}`）：\n\n```json\n{\n  \"status\": \"completed\",\n  \"model\": \"doubao-seedance-2-0-260128\",\n  \"metadata\": {\n    \"url\": \"https://.../result.mp4\"\n  }\n}\n```\n\n> ⚠️ seedance 独有差异：完成后视频直链**只在 `metadata.url`**，没有 `video_url` / `url` / `data[0].url`；取值优先级 `video_url → url → metadata.url → data[0].url → data.url`。响应**不含任何时长字段**（duration/seconds），需下载 mp4 解析 mvhd 才能拿真实时长。\n\n### 7. 接入地址\n\n| 线路 | Base URL |\n|---|---|\n| 国内加速 | `https://iliu.ai` |\n| 海外直连 | `https://api.xinliu.one` |\n\n### 8. 错误码\n\n| 状态码 | 说明 |\n|---|---|\n| `400` | 参数错误（如 `duration_required`、`prompt is required`、size 不被支持） |\n| `401` | 令牌无效 |\n| `429` | 同时任务数超上限 |\n| `503` | 上游不可用 |\n\n\n**错误响应格式**：\n\n```json\n{\n  \"error\": {\n    \"message\": \"具体错误描述\",\n    \"type\": \"invalid_request_error\",\n    \"param\": \"model\",\n    \"code\": \"invalid_value\"\n  }\n}\n```\n\n| 字段 | 类型 | 说明 |\n|---|---|---|\n| `error.message` | string | 人类可读的错误描述 |\n| `error.type` | string | `invalid_request_error` / `authentication_error` / `new_api_error` |\n| `error.param` | string | 触发错误的参数名（仅参数类错误有值） |\n| `error.code` | string | 机器可读错误码，如 `invalid_value` `model_not_found` |\n",
        "responses": {
          "200": {
            "description": "成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string"
                    },
                    "task_id": {
                      "type": "string"
                    },
                    "status": {
                      "type": "string"
                    }
                  }
                },
                "example": {
                  "id": "string",
                  "task_id": "string",
                  "status": "string"
                }
              }
            }
          }
        }
      }
    },
    "/kling/v1/videos/motion-control": {
      "post": {
        "tags": [
          "快手可灵"
        ],
        "summary": "Kling Motion Control 动作转移",
        "operationId": "op_480835181",
        "description": "### 1. 功能介绍\n\n快手可灵 **Kling 2.6 Motion Control** — 动作转移技术。将参考视频中的精确动作转移到静态角色图像。单次最长 30 秒。\n\n> ⚠️ **独立路径**：`POST kling/v1/videos/motion-control`，不走 `POST /v1/videos`。\n\n\n### 2. 可用型号\n\n| model | 说明 | enable_groups |\n|---|---|---|\n| `kling-motion-control` | Kling 2.6 动作转移 | `default` |\n\n### 3. 请求参数\n\n| 参数 | 类型 | 必填 | 说明 |\n|---|---|---|---|\n| `model` | string | ✅ | `kling-motion-control` |\n| `prompt` | string | ✅ | 动作描述 |\n| `seconds` | string | ✅ | 时长。最长 30 秒 |\n| `reference_image` | string |  | 静态角色图片 URL。动作转移到该角色 |\n| `reference_video` | string | ✅ | 参考动作视频 URL。提取动作信息 |\n\n\n\n### 4. 返回响应\n\n```json\n{\n  \"id\": \"task_xxx\",\n  \"task_id\": \"task_xxx\",\n  \"status\": \"queued\",\n  \"progress\": 0\n}\n```\n\n### 5. 注意事项\n\n- 🎯 动作转移：参考视频的动作 → 静态角色图像\n- ⏱️ 最长 30 秒动画\n- 📋 轮询和下载与通用视频接口相同：`GET /v1/videos/{task_id}` + `GET /v1/videos/{task_id}/content`\n\n### 6. 接入地址\n\n| 线路 | Base URL |\n|---|---|\n| 国内加速（推荐） | `https://iliu.ai` |\n| 海外直连 | `https://api.xinliu.one` |\n\n\n### 7. 错误码\n\n| 状态码 | 典型错误 | 原因 |\n|---|---|---|\n| `400` | — | 参数错误，检查必填字段和值的格式 |\n| `401` | — | 令牌无效或缺失 |\n| `402` | — | 余额不足 |\n| `429` | — | 速率限制，降低并发 |\n| `503` | `No available channel` | 上游不可用或分组不匹配 |\n\n**错误响应格式**：\n\n```json\n{\n  \"error\": {\n    \"message\": \"具体错误描述\",\n    \"type\": \"invalid_request_error\",\n    \"param\": \"model\",\n    \"code\": \"invalid_value\"\n  }\n}\n```\n\n| 字段 | 类型 | 说明 |\n|---|---|---|\n| `error.message` | string | 人类可读的错误描述 |\n| `error.type` | string | `invalid_request_error` / `authentication_error` / `new_api_error` |\n| `error.param` | string | 触发错误的参数名（仅参数类错误有值） |\n| `error.code` | string | 机器可读错误码 |\n",
        "responses": {
          "200": {
            "description": "成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string"
                    },
                    "task_id": {
                      "type": "string"
                    },
                    "status": {
                      "type": "string"
                    }
                  }
                },
                "example": {
                  "id": "string",
                  "task_id": "string",
                  "status": "string"
                }
              }
            }
          }
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "model": {
                    "type": "string"
                  },
                  "prompt": {
                    "type": "string"
                  },
                  "seconds": {
                    "type": "string"
                  },
                  "reference_image": {
                    "type": "string"
                  },
                  "reference_video": {
                    "type": "string"
                  }
                }
              },
              "example": {
                "model": "string",
                "prompt": "string",
                "seconds": "string",
                "reference_image": "string",
                "reference_video": "string"
              }
            }
          }
        }
      }
    },
    "/v1/videos/{id}": {
      "get": {
        "tags": [
          "快手可灵"
        ],
        "summary": "视频任务查询（共用）",
        "operationId": "op_477735513",
        "description": "### 1. 功能介绍\n\n所有异步视频任务（Veo/Sora/Grok/HappyHorse/豆包/Omni等）共用的进度查询接口。也用于 Nano Banana 异步生图任务查询。\n\n### 2. 请求参数\n\n| 参数 | 类型 | 必填 | 说明 |\n|------|------|------|------|\n| `task_id` (path) | string | ✅ | 由 `POST /v1/videos` 返回 |\n| Authorization (header) | string | ✅ | `Bearer <API Key>` |\n\n### 3. 注意事项\n\n- ⚠️ Grok Video 6s/10s/12s 系列完成响应**不含 URL**，只能通过 `/content` 下载\n- ⏱️ 建议首次查询在提交后 5 秒，之后每 5~10 秒轮询\n\n### 4. 任务状态\n\n| 状态 | 说明 |\n|------|------|\n| `queued` | 排队等待 |\n| `in_progress` / `processing` | 正在生成 |\n| `completed` | 已完成，可下载 |\n| `failed` | 失败 |\n\n### 5. 返回格式\n\n**处理中**：\n```json\n{\"id\":\"task_<id>\",\"model\":\"grok-imagine-1.0-video\",\"object\":\"video\",\"status\":\"in_progress\",\"progress\":37,\"seconds\":\"10\",\"size\":\"720x1280\",\"prompt\":\"...\",\"quality\":\"standard\",\"created_at\":1782354929}\n```\n\n**已完成（有 URL）**：\n```json\n{\"id\":\"task_<id>\",\"object\":\"video\",\"model\":\"grok-video-3-max\",\"status\":\"completed\",\"progress\":100,\"video_url\":\"https://<domain>/<id>.mp4\"}\n```\n\n**已完成（无 URL — Grok 6s/10s/12s）**：\n```json\n{\"id\":\"task_<id>\",\"model\":\"grok-video-6s\",\"status\":\"completed\",\"progress\":100,\"size\":\"1280x720\"}\n```\n\n**失败**：\n```json\n{\"id\":\"task_<id>\",\"status\":\"failed\",\"error\":{\"code\":\"generation_failed\",\"message\":\"内容审核不通过\"}}\n```\n\n### 6. 接入地址\n\n| 线路 | Base URL |\n|------|----------|\n| 国内加速（推荐） | `https://iliu.ai` |\n| 海外直连 | `https://api.xinliu.one` |\n\n### 7. 错误码\n\n| 状态码 | 说明 |\n|--------|------|\n| `401` | 令牌无效 |\n| `404` | 任务不存在或已过期 |\n| `500` | 服务端内部错误 |\n",
        "responses": {
          "200": {
            "description": "成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string"
                    },
                    "task_id": {
                      "type": "string"
                    },
                    "status": {
                      "type": "string"
                    },
                    "progress": {
                      "type": "integer"
                    },
                    "video_url": {
                      "type": "string"
                    },
                    "error": {
                      "type": "object",
                      "properties": {}
                    }
                  }
                },
                "example": {
                  "id": "string",
                  "task_id": "string",
                  "status": "string",
                  "progress": 0,
                  "video_url": "string",
                  "error": {}
                }
              }
            }
          }
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "任务 ID（由视频生成接口的响应返回）",
            "schema": {
              "type": "string"
            }
          }
        ]
      }
    },
    "/v1/videos/{id}/content": {
      "get": {
        "tags": [
          "快手可灵"
        ],
        "summary": "视频内容下载（共用）",
        "operationId": "op_477735514",
        "description": "### 1. 功能介绍\n\n下载已完成视频任务的视频文件。返回 H.264 MP4 二进制流。所有视频任务共用。Grok Video 6s/10s/12s 系列**唯一**的下载方式。\n\n### 2. 请求参数\n\n| 参数 | 类型 | 必填 | 说明 |\n|------|------|------|------|\n| `task_id` (path) | string | ✅ | 需先通过查询接口确认 status=completed |\n| Authorization (header) | string | ✅ | `Bearer <API Key>` |\n\n### 3. 注意事项\n\n- ⚠️ 必须先确认任务状态为 `completed`，否则返回 404\n- ⚠️ Grok Video 6s/10s/12s 只能通过本接口下载（查询响应无 URL）\n- 📁 视频文件一般保留 24 小时以上，超时可能被清理（返回 410）\n\n### 4. 返回格式\n\n- HTTP 200，Content-Type: `video/mp4`\n- 6 秒 720p 视频约 8~9 MB\n\n### 5. 接入地址\n\n| 线路 | Base URL |\n|------|----------|\n| 国内加速（推荐） | `https://iliu.ai` |\n| 海外直连 | `https://api.xinliu.one` |\n\n### 6. 错误码\n\n| 状态码 | 说明 |\n|--------|------|\n| `401` | 令牌无效 |\n| `404` | task_id 不存在或任务未完成 |\n| `410` | 文件已过期被清理 |\n| `500` | 服务端内部错误 |\n",
        "responses": {
          "200": {
            "description": "成功"
          }
        },
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "任务 ID（由视频生成接口的响应返回）",
            "schema": {
              "type": "string"
            }
          }
        ]
      }
    },
    "/v1/models": {
      "get": {
        "tags": [
          "系统 API（客户可用）"
        ],
        "summary": "GET /v1/models 模型列表",
        "operationId": "op_477734251",
        "description": "### 1. 功能介绍\n\nOpenAI 兼容协议，列出当前 API Key 可调用的**所有模型**及元信息。接入前建议先调此接口获取真实模型 ID。\n\n无需任何参数。返回 80+ 个模型，每个含 `model_type`、`tags`、`supported_endpoint_types`、`description`。\n\n\n\n### 2. 返回响应\n\n```json\n{\n  \"object\": \"list\",\n  \"data\": [\n    {\n      \"id\": \"claude-sonnet-4-6\",\n      \"object\": \"model\",\n      \"created\": 1626777600,\n      \"owned_by\": \"custom\",\n      \"model_type\": \"对话\",\n      \"description\": \"Claude Sonnet 4.6 ...\",\n      \"tags\": \"文本,识图,编程,推理\",\n      \"supported_endpoint_types\": [\"anthropic\", \"openai\"]\n    },\n    {\n      \"id\": \"veo_3_1-fast\",\n      \"object\": \"model\",\n      \"model_type\": \"视频\",\n      \"description\": \"Google Veo 3.1 Fast\",\n      \"tags\": \"视频生成\",\n      \"supported_endpoint_types\": [\"OpenAi通用视频格式\"]\n    }\n  ]\n}\n```\n\n| 返回字段 | 类型 | 说明 |\n|---|---|---|\n| `data[].id` | string | 模型 ID，API 调用时直接用 |\n| `data[].model_type` | string | `对话` / `图像` / `视频` / `工具` |\n| `data[].tags` | string | 逗号分隔标签，如 `\"文本,推理\"`、`\"视频生成\"` |\n| `data[].supported_endpoint_types` | array | 兼容端点。`openai`→chat / `gemini`→generateContent / `OpenAi通用视频格式`→videos / `image-generation`→images |\n| `data[].owned_by` | string | 模型来源 |\n| `data[].description` | string | 模型简述 |\n\n### 3. 接入地址\n\n| 线路 | Base URL |\n|---|---|\n| 国内加速 | `https://iliu.ai` |\n| 海外直连 | `https://api.xinliu.one` |\n\n### 4. 错误码\n\n| 状态码 | 说明 |\n|---|---|\n| `401` | 令牌无效 |\n\n\n**错误响应格式**：\n\n```json\n{\n  \"error\": {\n    \"message\": \"具体错误描述\",\n    \"type\": \"invalid_request_error\",\n    \"param\": \"model\",\n    \"code\": \"invalid_value\"\n  }\n}\n```\n\n| 字段 | 类型 | 说明 |\n|---|---|---|\n| `error.message` | string | 人类可读的错误描述 |\n| `error.type` | string | `invalid_request_error` / `authentication_error` / `new_api_error` |\n| `error.param` | string | 触发错误的参数名（仅参数类错误有值） |\n| `error.code` | string | 机器可读错误码，如 `invalid_value` `model_not_found` |\n",
        "responses": {
          "200": {
            "description": "成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "object": {
                      "type": "string"
                    },
                    "data": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      }
                    }
                  }
                },
                "example": {
                  "object": "string",
                  "data": [
                    "string"
                  ]
                }
              }
            }
          }
        }
      }
    },
    "/api/status": {
      "get": {
        "tags": [
          "系统 API（客户可用）"
        ],
        "summary": "GET /api/status 系统状态",
        "operationId": "op_477734260",
        "description": "### 1. 功能介绍\n\n返回站点公开状态信息，包括系统公告、API 线路配置。**无需认证**，公开接口。\n\n\n\n### 2. 返回响应\n\n```json\n{\n  \"data\": {\n    \"announcements\": [\n      {\n        \"id\": 40,\n        \"content\": \"上线omni无水印版本 普通分组限量 官转为稳定\",\n        \"publishDate\": \"2026-06-23T13:17:10.481Z\",\n        \"type\": \"default\"\n      }\n    ],\n    \"api_info\": [\n      {\"route\": \"国内线路\", \"url\": \"https://iliu.ai/v1\"},\n      {\"route\": \"美国专线\", \"url\": \"https://api.xinliu.one/v1\"}\n    ],\n    \"system_name\": \"心流\"\n  },\n  \"success\": true\n}\n```\n\n| 返回字段 | 类型 | 说明 |\n|---|---|---|\n| `data.announcements[]` | array | 公告列表，按时间倒序 |\n| `data.announcements[].content` | string | 公告正文 |\n| `data.announcements[].publishDate` | string | 发布时间（ISO 8601） |\n| `data.api_info[]` | array | API 线路配置 |\n\n### 3. 接入地址\n\n| 线路 | Base URL |\n|---|---|\n| 国内加速 | `https://iliu.ai` |\n| 海外直连 | `https://api.xinliu.one` |\n\n### 4. 错误码\n\n| 状态码 | 说明 |\n|---|---|\n| `500` | 服务器异常（极少见） |\n\n\n**错误响应格式**：\n\n```json\n{\n  \"error\": {\n    \"message\": \"具体错误描述\",\n    \"type\": \"invalid_request_error\",\n    \"param\": \"model\",\n    \"code\": \"invalid_value\"\n  }\n}\n```\n\n| 字段 | 类型 | 说明 |\n|---|---|---|\n| `error.message` | string | 人类可读的错误描述 |\n| `error.type` | string | `invalid_request_error` / `authentication_error` / `new_api_error` |\n| `error.param` | string | 触发错误的参数名（仅参数类错误有值） |\n| `error.code` | string | 机器可读错误码，如 `invalid_value` `model_not_found` |\n",
        "responses": {
          "200": {
            "description": "成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "object",
                      "properties": {}
                    },
                    "success": {
                      "type": "boolean"
                    }
                  }
                },
                "example": {
                  "data": {},
                  "success": true
                }
              }
            }
          }
        }
      }
    },
    "/api/usage/token/": {
      "get": {
        "tags": [
          "系统 API（客户可用）"
        ],
        "summary": "GET /api/usage/token/ 令牌用量",
        "operationId": "op_477734264",
        "description": "### 1. 功能介绍\n\n查询当前 API Key 的累计用量、剩余额度、过期时间等账户信息。\n\n\n\n### 2. 返回响应\n\n```json\n{\n  \"data\": {\n    \"name\": \"令牌名称\",\n    \"expires_at\": 0,\n    \"unlimited_quota\": true,\n    \"total_granted\": -146,\n    \"total_used\": 23750000,\n    \"total_available\": -23750146,\n    \"model_limits_enabled\": false,\n    \"model_limits\": {},\n    \"object\": \"token_usage\"\n  },\n  \"message\": \"\",\n  \"success\": true\n}\n```\n\n| 返回字段 | 类型 | 说明 |\n|---|---|---|\n| `data.name` | string | 令牌名称 |\n| `data.expires_at` | integer | 过期时间戳。**0 表示永不过期** |\n| `data.unlimited_quota` | boolean | **true 时为无限额度**（此时 `total_available` 为负数） |\n| `data.total_granted` | integer | 总授予额度 |\n| `data.total_used` | integer | 已使用额度 |\n| `data.total_available` | integer | 剩余额度。无限模式下为负数 |\n| `data.model_limits_enabled` | boolean | 是否启用按模型限额 |\n\n### 3. 额度换算\n\n非无限额度模式下：`美元 ≈ total_available / 500000`.\n\n### 4. 接入地址\n\n| 线路 | Base URL |\n|---|---|\n| 国内加速 | `https://iliu.ai` |\n| 海外直连 | `https://api.xinliu.one` |\n\n### 5. 错误码\n\n| 状态码 | 说明 |\n|---|---|\n| `401` | 令牌无效 |\n\n\n**错误响应格式**：\n\n```json\n{\n  \"error\": {\n    \"message\": \"具体错误描述\",\n    \"type\": \"invalid_request_error\",\n    \"param\": \"model\",\n    \"code\": \"invalid_value\"\n  }\n}\n```\n\n| 字段 | 类型 | 说明 |\n|---|---|---|\n| `error.message` | string | 人类可读的错误描述 |\n| `error.type` | string | `invalid_request_error` / `authentication_error` / `new_api_error` |\n| `error.param` | string | 触发错误的参数名（仅参数类错误有值） |\n| `error.code` | string | 机器可读错误码，如 `invalid_value` `model_not_found` |\n",
        "responses": {
          "200": {
            "description": "成功",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "object",
                      "properties": {}
                    },
                    "success": {
                      "type": "boolean"
                    }
                  }
                },
                "example": {
                  "data": {},
                  "success": true
                }
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "securitySchemes": {
      "bearerAuth": {
        "type": "http",
        "scheme": "bearer",
        "description": "在 Authorization 请求头中传入 API 令牌：`Authorization: Bearer <token>`"
      }
    }
  }
}