供應商路由

同一影片模型可能由多個供應商承載。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 可以同時傳。