​

API 手册说明

本页说明 API 手册的阅读方式。 如果你想先理解平台自己的 special / default / standard 等分组概念，请先阅读 平台分组说明。 如果你需要在具体软件中填写 API Key、Base URL 和模型，请进入 集成指南总览。 先从总入口进入具体模型或协议页：

1. 文本模型总入口
2. 图片模型总入口
3. 视频模型总入口

当前模型页会统一成以下结构：

1. 标题与简要摘要
2. 请求鉴权
3. 提交任务接口
4. 请求参数
5. 响应
6. 任务查询接口
7. 同步调用协议（仅同时支持同步协议时出现）
8. 使用示例
9. 注意事项

说明如下：

1. 每个模型页只展示该模型当前稳定对外支持的参数。
2. 参数表统一包含“默认值”列。
3. 页面只展示外部可见的模型信息，不出现内部实现词，也不出现内部渠道名。
4. 请求鉴权 使用代码示例展示，例如先说明所有接口均需要使用 Bearer Token 进行认证，再给出 Authorization: Bearer YOUR_API_KEY 的请求头示例。
5. 需要额外解释的字段，直接写在参数表后，不再单独起“参数说明”章节。
6. 使用示例 按能力组织，例如 文生图、图生图，而不是按业务场景组织。
7. 页面不再保留 适合场景 章节，直接进入调用信息。
8. 没有单独写出的参数，表示该模型页当前不作为稳定对外参数提供。
9. 参考图统一使用 images 传入，单图也使用数组。
10. 对同时支持异步任务协议和同步直返协议的模型页，可以在 任务查询接口 后继续补充 同步调用协议 小节。
11. 同步调用协议 必须区分真实接口：文生图使用 POST /v1/images/generations，图生图使用 POST /v1/images/edits。
12. 顶部摘要直接使用普通 Markdown，不再依赖自定义头部组件。
13. 对同一个稳定模型下存在 default / standard 差异的情况，应在同一页内增加“分组参数说明”，直接讲清楚当前分组差异。
14. 文档站只写调用契约，不写价格、内部主备和底层比价。
15. API 手册说明接口本身；客户端、CLI、Agent 应用和工作流平台的具体配置步骤统一维护在集成指南中。
16. 同一模型若开放多个平台分组，先看 平台分组说明，再回到具体模型页阅读“分组说明”或“分组参数说明”。
17. 只有当同一模型存在公开分组差异时，才增加“分组说明”或“分组参数说明”；没有分组差异的模型页不再强制保留该章节。

当前第一批图片系列已覆盖：

1. gpt-image-2
2. gpt-image-2-official（官方）
3. nano-banana
4. nano-banana-pro
5. nano-banana2

当前第一批优先视频系列已覆盖：

1. grok-imagine-video-1.0
2. grok-imagine-video-1.5
3. gemini-omni-flash
4. gemini-omni-flash-ext
5. veo-3.1
6. veo-3.1-fast
7. seedance-2.0
8. seedance-2.0-fast
9. happyhorse-1.0

其余模型页会在后续批次继续按这一结构补齐；补充页面不再默认放进主入口。