参数透传(Token360-Native-Params)

Token360 对接多模态接口时有两种方式:

  1. 默认(归一化):使用 OpenAI 风格字段(如 promptreference_imagesseconds 等)。
  2. 原生参数透传:请求体按目标模型的原生 JSON 组织,通过下方请求头开启。

本文说明 Token360-Native-Params 的语义、支持的端点及常见问题。


请求头:Token360-Native-Params

Token360-Native-Paramstrue1yeson(大小写不敏感)

开启后,必须使用 Content-Type: application/json,且 body 为 合法 JSON 对象{ ... })。
非法 JSON(例如 尾随逗号)、空 body、或根节点不是对象(数组/纯字符串)会被拒绝。


Token360 仍会处理的事项

即使开启原生参数透传,Token360 仍会:

  1. 使用 Token360 API Key 完成鉴权。
  2. 使用 model 值选择请求的模型。
  3. 校验 asset://... 引用是否属于当前账号可用资产。
  4. 在适用时返回 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 enabledbody 为空、Content-Type 非 JSON、JSON 语法错误(尾随逗号)、根节点不是对象等。
返回 duration / InvalidParameterduration 写成字符串,或该模型不支持该秒数。
资产校验失败asset:// 后的 id 与当前账号可用资产不一致,或拼写错误。

相关文档

  • 本站 API 参考 → 视频生成 → 提交视频生成请求:默认归一化字段说明(非透传模式)。
此页面对您有帮助吗?