供应商路由

同一视频模型可能由多个供应商承载。provider 是请求体顶层字段，接受两个子字段：type 指定走哪个供应商，options 透传该供应商特有的参数。

字段	类型	说明
`provider.type`	string	指定承载供应商。取值不在枚举内返回 `400 invalid_provider_type`；供应商未承载该模型返回 `400 provider_type_unavailable`
`provider.options.<slug>`	object	provider 特有参数透传，仅匹配到的 provider 会收到

cURL

Terminal


curl https://api.ofox.io/v1/videos \
  -H "Authorization: Bearer $OFOX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "bytedance/seedance-2.0-mini",
    "prompt": "...",
    "duration": 5,
    "provider": {
      "type": "byteplus",
      "options": { "dashscope": { "watermark": false } }
    }
  }'

Python

create_video.py


requests.post(
    "https://api.ofox.io/v1/videos",
    headers={"Authorization": f"Bearer {OFOX_API_KEY}"},
    json={
        "model": "bytedance/seedance-2.0-mini",
        "prompt": "...",
        "duration": 5,
        "provider": {
            "type": "byteplus",
            "options": {"dashscope": {"watermark": False}},
        },
    },
)

TypeScript

create-video.ts


await fetch('https://api.ofox.io/v1/videos', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${OFOX_API_KEY}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    model: 'bytedance/seedance-2.0-mini',
    prompt: '...',
    duration: 5,
    provider: {
      type: 'byteplus',
      options: { dashscope: { watermark: false } },
    },
  }),
})

未传 provider.type 时，由多个供应商承载的模型将在可用渠道之间按权重分流，单次请求最终由哪个供应商承载不可预期。视频链路不支持 order / sort / fallback，也没有等价的 header 写法。

可选供应商为该模型详情页供应商区列出的那些，完整列表见供应商路由。

seedance 的两个供应商

bytedance/seedance-* 系列由以下两个供应商承载，二者内容策略存在差异：

供应商	说明	内容策略
`volcengine`	火山引擎方舟，字节跳动国内平台	标准审核
`byteplus`	BytePlus，字节跳动海外平台	支持不适合所有受众（NSFW）的内容

byteplus 允许 seedance 生成不适合所有受众（NSFW）的内容，volcengine 执行标准审核。需要此类内容时必须显式指定 provider.type: "byteplus"；未指定时请求可能经加权分流进入 volcengine，并被内容审核拒绝。

`provider.options`：参数透传

provider 特有参数通过 provider.options.<slug> 传递，仅匹配到的 provider 会收到。watermark 这类参数并非所有模型都支持，因此放进 provider 透传而非顶层字段（对齐 OpenRouter 的 provider 透传设计）。各模型支持哪些透传参数以模型能力为准。


{
  "model": "alibaba/wan-2.7",
  "prompt": "...",
  "provider": {
    "options": {
      "dashscope": { "watermark": false, "audio_setting": "..." }
    }
  }
}

type 与 options 可以同时传。