文档目录

网关总览

一个 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/videosOpenAI 官方 SDK
可灵/kling/v1/videos/*已有可灵调用代码
即梦/jimeng*已有即梦调用代码

路由由 model 决定,跟走哪个入口无关。在任意一个入口建的任务,其余入口都查得到 —— 拿同一个 id 去另一个入口查一次,就能验证这件事。

同步还是异步

形态能力怎么拿结果
同步文本、图片、语音转写响应里直接有
同步(字节)语音合成、视频下载响应体是文件,看 Content-Type
异步视频、音乐提交拿 id → 轮询状态 → 终态取产物

异步任务先按上限预扣、终态按实际用量结算,多退少补。预扣不是扣款,见「计费与配额」。

控制台各页

页面能做什么
总览请求量、成功率、延迟、公告
API 密钥签发与停用密钥
模型广场公开价目与能力矩阵,免登录
使用日志每次调用一行:模型、token、耗时、费用、状态
余额与账单余额、流水、充值、订单
异步任务视频与音乐的进度、产物、取消
公告维护通知与变更
设置注册方式、第三方登录、展示货币(管理员)

从哪一篇开始

你的情况看这篇
第一次接进来快速开始
不知道密钥该放哪鉴权与密钥
模型名对不上模型与路由
要算成本、要对账计费与配额
任务一直转圈异步任务
已经在别家跑通了从别的网关迁移
报错了常见问题与排障