统一调用 API

统一调用 API 是本平台为了简化业务接入而提供的二次封装接口。业务接入时优先使用这里定义的统一模型值、字段别名、能力模式和自动路由。

Base URL

https://your-domain.example/v1

使用记录查询 /api/platform/logs 和生成费用预估 /api/platform/generation-cost 使用站点根路径，无需在前面添加 /v1。

鉴权

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

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

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

接入图片或视频异步任务时，可下载 Markdown 接入指南并交给 AI 编程助手。文件包含请求示例、回调与纯客户端轮询方案；真实令牌和模型值仍需从你的配置中提供。

推荐接口

文本生成

文本模型继续使用 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}

使用记录

使用现有接入密钥查询当前账号的消耗、充值、退款和错误记录，无需浏览器登录或 Cookie：

GET /api/platform/logs
Authorization: Bearer sk-你的令牌

curl 'https://your-domain.example/api/platform/logs?p=1&page_size=20&type=0' \-H 'Authorization: Bearer sk-你的令牌'

响应中的 data.items 返回记录列表，data.total 返回记录总数。每条记录包含模型、线路 ID、消耗金额 amount、累计消耗 cumulative_amount、完整计算公式 billing_formula 和原始额度；错误记录的 content 为完整错误信息。

完整返回示例、字段说明、金额换算和错误处理见使用记录 API。

计算生成费用

POST /api/platform/generation-cost
Authorization: Bearer sk-你的令牌
Content-Type: application/json

提交模型、线路、分辨率、画质和时长即可预估图片或视频费用，不创建任务、不扣费。返回预计额度、金额、完整公式和自动选线的费用范围；缺少必需信息时返回 estimated: false，并说明原因。

请求示例、参考视频折扣和字段说明见生成费用 API。

与 API 参考的关系

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