网关总览
一个 base URL、一把密钥接多家上游:能力清单、四种视频格式、同步与异步、控制台各页。
内容最后核对:2026-11-18
本页目录
这是什么
一句话:一个 base URL、一把密钥,接多家上游。
请求按 OpenAI 形状发进来,网关做四件事:认出调用者 → 选一条渠道 → 转发(跨协议时翻译)→ 按实际用量计费并写一行使用日志。它自己不训练模型,也不生产内容。
能力与端点
| 能力 | 端点 | 形态 |
|---|---|---|
| 文本对话 | POST /v1/chat/completions | 同步,可流式 |
| Anthropic 协议 | POST /v1/messages | 同步,可流式 |
| Gemini 协议 | POST /v1beta/models/{model}:generateContent | 同步,可流式 |
| 图像生成 | POST /v1/images/generations | 同步 |
| 语音合成 | POST /v1/audio/speech | 同步,返回音频字节 |
| 语音转写 / 翻译 | POST /v1/audio/transcriptions、/translations | 同步,multipart |
| 视频生成 | POST /v1/video/generations、POST /v1/videos | 异步任务 |
| 音乐生成 | POST /v1/audio/music | 异步任务 |
厂商原生路径也提供了一份(方舟 api/v3、百炼 api/v1、MiniMax v2、可灵 /kling、即梦 /jimeng),所以厂商官方 SDK 只改 base 就能用,不必改调用代码。清单见「API 参考 → 视频」与「指南 → 用官方 SDK」。
视频为什么有四种格式
同一个任务、同一个 id。四种入站格式只决定字段名:
| 格式 | 入口 | 谁会用它 |
|---|---|---|
| 通用 | /v1/video/generations | 自己写代码接,字段最直白 |
| Sora | /v1/videos | OpenAI 官方 SDK |
| 可灵 | /kling/v1/videos/* | 已有可灵调用代码 |
| 即梦 | /jimeng* | 已有即梦调用代码 |
路由由 model 决定,跟走哪个入口无关。在任意一个入口建的任务,其余入口都查得到 —— 拿同一个 id 去另一个入口查一次,就能验证这件事。
同步还是异步
| 形态 | 能力 | 怎么拿结果 |
|---|---|---|
| 同步 | 文本、图片、语音转写 | 响应里直接有 |
| 同步(字节) | 语音合成、视频下载 | 响应体是文件,看 Content-Type |
| 异步 | 视频、音乐 | 提交拿 id → 轮询状态 → 终态取产物 |
异步任务先按上限预扣、终态按实际用量结算,多退少补。预扣不是扣款,见「计费与配额」。
控制台各页
| 页面 | 能做什么 |
|---|---|
| 总览 | 请求量、成功率、延迟、公告 |
| API 密钥 | 签发与停用密钥 |
| 模型广场 | 公开价目与能力矩阵,免登录 |
| 使用日志 | 每次调用一行:模型、token、耗时、费用、状态 |
| 余额与账单 | 余额、流水、充值、订单 |
| 异步任务 | 视频与音乐的进度、产物、取消 |
| 公告 | 维护通知与变更 |
| 设置 | 注册方式、第三方登录、展示货币(管理员) |