Provider-Routing

Ein Videomodell kann von mehr als einem Anbieter bereitgestellt werden. provider ist ein Feld auf oberster Ebene des Request-Bodys mit zwei Unterfeldern: type wählt den Anbieter, options reicht dessen spezifische Parameter durch.

Feld	Typ	Beschreibung
`provider.type`	string	Legt den bereitstellenden Anbieter fest. Ein Wert außerhalb der Enumeration liefert `400 invalid_provider_type`; ein Anbieter, der das Modell nicht bereitstellt, liefert `400 provider_type_unavailable`
`provider.options.<slug>`	object	Anbieterspezifische Durchreichung — nur der passende Anbieter erhält sie

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 } },
    },
  }),
})

Wird provider.type nicht gesendet, verteilt sich ein von mehreren Anbietern bereitgestelltes Modell gewichtet auf die verfügbaren Kanäle, und welcher Anbieter eine einzelne Anfrage bedient, ist nicht vorhersehbar. Der Video-Pfad unterstützt order / sort / fallback nicht, und es gibt keine äquivalente Header-Form.

Die für ein Modell verfügbaren Anbieter sind die auf seiner Modellseite unter Anbieter aufgeführten; die vollständige Liste steht unter Provider-Routing.

Die zwei Anbieter von seedance

Die Familie bytedance/seedance-* wird von den beiden folgenden Anbietern bereitgestellt, deren Inhaltsrichtlinien sich unterscheiden:

Anbieter	Beschreibung	Inhaltsrichtlinie
`volcengine`	Volcengine Ark, ByteDance-Plattform für Festlandchina	Standardmoderation
`byteplus`	BytePlus, ByteDance-Plattform für Märkte außerhalb Festlandchinas	Erlaubt Inhalte, die nicht für alle Zielgruppen geeignet sind (NSFW)

byteplus erlaubt seedance die Erzeugung von Inhalten, die nicht für alle Zielgruppen geeignet sind (NSFW), während volcengine eine Standardmoderation anwendet. Wird solcher Inhalt benötigt, muss provider.type: "byteplus" ausdrücklich gesetzt werden; andernfalls kann die gewichtete Verteilung die Anfrage an volcengine leiten, wo die Moderation sie ablehnt.

`provider.options`: Parameter-Durchreichung

Anbieterspezifische Parameter werden über provider.options.<slug> durchgereicht, und nur der passende Anbieter erhält sie. Parameter wie watermark werden nicht von jedem Modell unterstützt; deshalb liegen sie in der Anbieter-Durchreichung statt in einem Feld auf oberster Ebene (analog zum Design von OpenRouter). Welche durchgereichten Parameter ein Modell akzeptiert, hängt vom Modell ab.


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

type und options können gemeinsam gesendet werden.