Authorization: Bearer $MIXROUTE_API_KEY 认证,请求体为 JSON。模型 ID 位于 URL 中,不在请求体中重复传 model;不添加 /v1,也不使用 metadata 包装。
支持模型
只使用账户模型列表中可用的完整型号。端点与模型必须匹配:例如
kling-3.0-omni 和 kling-o1 走 omni-video,不能走普通文生/图生端点;动作控制使用 kling-3.0 或 kling-2.6,不是独立的 motion 型号。
调用流程
- 按所需功能选择生成端点,提交原生请求体。
- 检查 HTTP 状态和 JSON
code,code=0表示请求成功。 - 保存提交响应中的
data.id,每次只查询一个网关任务 ID。 - 任务
succeeded后读取data[0].outputs中type=video的url。 - 读取结果 CDN 时不要携带 MixRoute Key。提交超时不代表没有创建任务,不要自动重复提交。
通用选项
默认值与参数层级
网关省略值处理:settings.resolution 补 720p;除动作控制外,settings.duration 补 5。文生视频默认画幅为 16:9。图生、Omni、动作控制的提示词放在 contents 的 type=prompt 项中;只有文生视频使用顶层 prompt。显式填写影响计费的参数,尤其是 2.6 原生音频所需的 1080p。
参数名和枚举值区分大小写。网关不会把超出枚举的值静默改为另一规格;各型号的参数范围仍须满足对应接口限制。Element 和 voice ID 必须可被实际路由的上游账户访问,不能假设个人可灵账户里的资产自动共享。
计费
以下为美元/生成秒的基础单价。最终费用以 模型广场 当前定价、账户分组倍率和控制台账单为准;不包含资源包或账户专属折扣。
提交时预扣,完成后按
outputs[].duration 的实际生成秒数结算,保留小数秒而非仅按请求的整数时长。动作控制按 15 秒预扣,完成后按实际输出时长多退少补;失败或超时任务退回预扣额度。原生响应中的 billing 为可选上游字段,不能当作 MixRoute 最终实扣凭证。不支持 不代表免费。
任务状态、失败原因和完整轮询示例见 查询 Kling 任务。