Skip to main content
OpenAPI 文件是公开 API 契约草案,后续会与后端 endpoint descriptor、错误码、模型能力和计费策略做 CI 校验。

当前覆盖

通用
  • GET /v1/models
  • POST /v1/chat/completions — OpenAI 兼容聊天/文本入口;Gemini 兼容页覆盖文本生成、图片理解和文档理解
  • POST /v1/responses
  • POST /v1/messages
  • POST /v1beta/models/{model}:generateContent — Gemini 原生文本生成和多模态理解,支持图片、视频、文档和非流式输出
  • POST /v1beta/models/{model}:streamGenerateContent?alt=sse — Gemini 原生流式输出,适合文本、图片、视频和文档理解
图片生成
  • POST /volcengine/v3/images/generations — 火山直连图片生成,官方兼容请求体,支持模型级 SSE
  • POST /v3/images/generations — V3 同步生成,按张计费
  • POST /v1/images/generations — V1 OpenAI 兼容
  • POST /v2/images/generations — 异步任务创建
  • GET /v2/images/generations/{id} — 异步任务查询
图片编辑
  • POST /v3/images/edits — V3 同步编辑,按张计费
  • POST /v1/images/edits — V1 OpenAI 兼容
视频生成
  • POST /v1/videos/generations — 创建视频生成任务(异步)
  • GET /v1/videos/generations/{id} — 查询视频生成任务
  • POST /v1/grok-imagine/videos/generations — 创建 Grok Imagine 视频任务
  • GET /v1/grok-imagine/videos/generations/{id} — 查询 Grok Imagine 视频任务
  • POST /v1/google-omni/videos/generations — 创建 Gemini Omni 视频任务
  • GET /v1/google-omni/videos/generations/{id} — 查询 Gemini Omni 视频任务
素材库
  • POST /v1/assets — 创建素材
  • GET /v1/assets — 查询素材列表
  • GET /v1/assets/{id} — 查询素材详情
OpenAPI 的 servers.url 使用 API 网关根域名 https://xxx.wengaocloud.com,因为同一份契约同时包含 /v1/v2/v3 路径。OpenAI SDK 的 base_url 仍使用 https://xxx.wengaocloud.com/v1;V3 接口需使用 https://xxx.wengaocloud.com/v3