Routage des fournisseurs

Un modèle vidéo peut être servi par plusieurs fournisseurs. provider est un champ à la racine du corps de la requête, avec deux sous-champs : type choisit le fournisseur, options transmet les paramètres qui lui sont propres.

Champ	Type	Description
`provider.type`	string	Épingle le fournisseur. Une valeur hors énumération renvoie `400 invalid_provider_type` ; un fournisseur qui ne sert pas le modèle renvoie `400 provider_type_unavailable`
`provider.options.<slug>`	object	Transmission propre au fournisseur — seul le fournisseur retenu la reçoit

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

Si provider.type n’est pas envoyé, un modèle servi par plusieurs fournisseurs est réparti selon une pondération entre les canaux disponibles, et le fournisseur qui traite une requête donnée n’est pas prévisible. Le chemin vidéo ne prend pas en charge order / sort / fallback et il n’existe pas d’en-tête équivalent.

Les fournisseurs disponibles pour un modèle sont ceux listés sous Fournisseurs sur sa page ; la liste complète figure dans Routage des fournisseurs.

Les deux fournisseurs de seedance

La famille bytedance/seedance-* est servie par les deux fournisseurs ci-dessous, dont les politiques de contenu diffèrent :

Fournisseur	Description	Politique de contenu
`volcengine`	Volcengine Ark, plateforme de ByteDance pour la Chine continentale	Modération standard
`byteplus`	BytePlus, plateforme de ByteDance pour l’international	Autorise le contenu ne convenant pas à tous les publics (NSFW)

byteplus autorise seedance à générer du contenu ne convenant pas à tous les publics (NSFW), tandis que volcengine applique une modération standard. provider.type: "byteplus" doit être indiqué explicitement lorsque ce type de contenu est nécessaire ; sinon, la répartition pondérée peut acheminer la requête vers volcengine, où la modération la rejettera.

`provider.options` : transmission de paramètres

Les paramètres propres au fournisseur sont transmis via provider.options.<slug> et seul le fournisseur retenu les reçoit. Des paramètres comme watermark ne sont pas pris en charge par tous les modèles, d’où leur place dans la transmission fournisseur plutôt que dans un champ racine (conformément à la conception d’OpenRouter). Les paramètres acceptés dépendent du modèle.


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

type et options peuvent être envoyés ensemble.