プロバイダールーティング

1 つの動画モデルが複数のプロバイダーで提供されていることがあります。provider はリクエストボディのトップレベルフィールドで、2 つのサブフィールドを取ります：type はどのプロバイダーを使うかを指定し、options はそのプロバイダー固有のパラメータを渡します。

フィールド	型	説明
`provider.type`	string	提供プロバイダーを指定します。列挙にない値は `400 invalid_provider_type`、そのモデルを提供していないプロバイダーは `400 provider_type_unavailable` を返します
`provider.options.<slug>`	object	プロバイダー固有パラメータの passthrough。マッチしたプロバイダーのみが受け取ります

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 に対応しておらず、同等のヘッダー形式もありません。

指定可能なプロバイダーは、当該モデルのページのプロバイダー欄に並んでいるものです。全一覧はプロバイダールーティングを参照してください。

seedance の 2 つのプロバイダー

bytedance/seedance-* シリーズは以下の 2 つのプロバイダーで提供されており、両者のコンテンツポリシーは異なります：

プロバイダー	説明	コンテンツポリシー
`volcengine`	Volcengine Ark、ByteDance の中国本土向け基盤	標準的なモデレーション
`byteplus`	BytePlus、ByteDance の海外向け基盤	すべての利用者に適さない（NSFW）コンテンツに対応

byteplus は seedance がすべての利用者に適さない（NSFW）コンテンツを生成することを許可し、volcengine は標準的なモデレーションを適用します。そのようなコンテンツが必要な場合は provider.type: "byteplus" を明示的に指定してください。指定しない場合、重み付き分配によってリクエストが volcengine に振り分けられ、モデレーションで拒否される可能性があります。

`provider.options`：パラメータの passthrough

プロバイダー固有パラメータは provider.options.<slug> で渡され、マッチしたプロバイダーのみが受け取ります。watermark のようなパラメータはすべてのモデルが対応しているわけではないため、トップレベルのフィールドではなくプロバイダー passthrough に置かれています（OpenRouter の passthrough 設計に合わせています）。どの passthrough パラメータを受け付けるかはモデルによります。


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

type と options は同時に送信できます。