参数透传(Token360-Native-Params)
Token360 对接多模态接口时有两种方式:
- 默认(归一化):使用 OpenAI 风格字段(如
prompt、reference_images、seconds等)。 - 原生参数透传:请求体按目标模型的原生 JSON 组织,通过下方请求头开启。
本文说明 Token360-Native-Params 的语义、支持的端点及常见问题。
请求头:Token360-Native-Params
Token360-Native-Params | true、1、yes、on(大小写不敏感) |
开启后,必须使用 Content-Type: application/json,且 body 为 合法 JSON 对象({ ... })。
非法 JSON(例如 尾随逗号)、空 body、或根节点不是对象(数组/纯字符串)会被拒绝。
Token360 仍会处理的事项
即使开启原生参数透传,Token360 仍会:
- 使用 Token360 API Key 完成鉴权。
- 使用
model值选择请求的模型。 - 校验
asset://...引用是否属于当前账号可用资产。 - 在适用时返回 Token360 任务 ID 和计费信息。
请在 asset://{assetId} 引用中使用 Token360 资产 ID。轮询与计费仍使用 Token360 端点。
支持该请求头的端点
POST /v1/videos | 视频生成 | 原生模式仅 application/json,不支持 multipart/form-data。 |
POST /v1/images/generations | 图像生成 | body 须为非空 JSON 对象(仅 {} 会被拒绝)。 |
POST /v1/audio/speech | 语音合成(TTS) | 不再强制默认模式下的部分字段校验(如 input/voice);仍以原生 JSON 为准,并完成 model / asset:// 处理。 |
不支持原生模式的模型会返回明确的“不支持”类错误。
常见问题
JSON object body is required when Token360-Native-Params is enabled | body 为空、Content-Type 非 JSON、JSON 语法错误(尾随逗号)、根节点不是对象等。 |
返回 duration / InvalidParameter | duration 写成字符串,或该模型不支持该秒数。 |
| 资产校验失败 | asset:// 后的 id 与当前账号可用资产不一致,或拼写错误。 |
相关文档
- 本站 API 参考 → 视频生成 → 提交视频生成请求:默认归一化字段说明(非透传模式)。
此页面对您有帮助吗?
上一篇
Webhook
下一篇
批量任务