统一调用 API

统一调用 API 是本平台为了简化业务接入而提供的二次封装接口。底层仍兼容 OpenAI、Gemini、Sora、ElevenLabs 等接口格式，但业务接入时优先使用这里定义的统一模型值、字段别名、能力模式和自动路由。

Base URL

https://your-domain.example/v1

这里的域名会自动使用当前文档站的访问域名，因此同一份文档可以部署在不同域名下。

鉴权

所有用户侧调用都使用 Bearer Token：

Authorization: Bearer sk-你的令牌
Content-Type: application/json

令牌可以在控制台的 API 令牌页面创建。除文件上传或兼容特殊上游接口外，本文档中的请求都默认使用 application/json。

推荐接口

文本生成

文本模型继续使用 OpenAI 兼容接口，完整字段规范见「文本生成」页面。

POST /v1/chat/completions

{
    "model": "gemini-3.5-flash",
    "messages": [
        {
            "role": "user",
            "content": "用一句话介绍本平台 API。"
        }
    ]
}

如果你的客户端使用 Responses API，可使用：

POST /v1/responses

{
    "model": "gemini-3.5-flash",
    "input": "用一句话介绍本平台 API。"
}

多媒体任务

图片和语音接口通常同步返回结果；视频接口通常返回任务对象，需要再查询任务状态。视频任务推荐使用：

POST /v1/videos
GET /v1/videos/{task_id}
GET /v1/videos/{task_id}/content

兼容旧客户端时也可以继续使用：

POST /v1/video/generations
GET /v1/video/generations/{task_id}

与 API 参考的关系

「API 参考」菜单保留由 OpenAPI 生成的底层接口说明，适合查字段 schema、HTTP 方法和兼容接口细节。「统一调用 API」是面向业务接入的推荐写法，重点说明统一模型值、字段别名、自动路由和模型能力。