> ## Documentation Index
> Fetch the complete documentation index at: https://docs.wengaocloud.com/llms.txt
> Use this file to discover all available pages before exploring further.

# API 参考概览

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}` — 查询素材详情

<Note>
  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`。
</Note>