Routage des fournisseurs

Un même modèle est souvent servi par plusieurs fournisseurs : bytedance/seedance-2.0, par exemple, provient à la fois de volcengine et de byteplus. ofox sélectionne un fournisseur automatiquement ; provider.type épingle la requête à un fournisseur précis.

Routage par défaut

En l’absence du champ provider, ofox répartit la requête selon une pondération entre les canaux qui servent actuellement le modèle. Le fournisseur qui traite une requête donnée n’est pas prévisible.

Épingler un fournisseur

Indiquez le nom du fournisseur dans le champ type. L’emplacement du champ diffère selon le type de modèle :

Type de modèle	Emplacement du champ
Modèles de chat	`extra_body.provider.type`
Modèles vidéo	`provider.type`

Le protocole natif Gemini ignore extra_body.provider dans le corps — la requête aboutit, la contrainte ne s’applique tout simplement pas, sans erreur. Sur ce protocole, utilisez l’en-tête X-OfoxAI-Provider-Type. Le contrat de champ par protocole figure dans API · Routage des fournisseurs.

Modèles de chat

cURL

Terminal


curl https://api.ofox.io/v1/chat/completions \
  -H "Authorization: Bearer $OFOX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "anthropic/claude-sonnet-5",
    "messages": [{ "role": "user", "content": "..." }],
    "extra_body": {
      "provider": { "type": "bedrock" }
    }
  }'

Python

provider_routing.py


client.chat.completions.create(
    model="anthropic/claude-sonnet-5",
    messages=[{"role": "user", "content": "..."}],
    extra_body={"extra_body": {"provider": {"type": "bedrock"}}},
)

TypeScript

provider-routing.ts


await client.chat.completions.create({
  model: 'anthropic/claude-sonnet-5',
  messages: [{ role: 'user', content: '...' }],
  extra_body: { provider: { type: 'bedrock' } },
} as any)

Avec les SDK OpenAI officiels, extra_body doit être présent comme clé littérale dans le corps de la requête. Le SDK TypeScript l’envoie tel qu’il est écrit dans l’objet de paramètres. L’argument extra_body= du SDK Python fusionne son contenu à la racine du corps : la clé doit donc être imbriquée un niveau plus profond, ou transmise via un en-tête.

Fournisseurs disponibles

Les fournisseurs actuellement pris en charge par ofox sont listés ci-dessous. Les noms courts, entre parenthèses, sont équivalents au nom complet ; les deux sont acceptés :

Fournisseur	Description
`openai`	OpenAI ：API officielle de la famille GPT
`anthropic`	Anthropic ：API officielle de la famille Claude
`gemini`	Google AI ：API officielle de la famille Gemini
`azure_foundry` (`foundry`)	Azure AI Foundry ：plateforme d’hébergement de modèles sur Microsoft Azure
`aws_bedrock` (`bedrock`)	Amazon Bedrock ：service d’hébergement de modèles sur AWS
`google_vertex` (`vertex`)	Vertex AI ：plateforme d’hébergement de modèles sur Google Cloud
`aliyun`	Alibaba Cloud Bailian ：plateforme de services de modèles d’Alibaba Cloud
`volcengine`	Volcengine Ark ：plateforme de ByteDance pour la Chine continentale
`byteplus`	BytePlus ：plateforme de ByteDance pour l’international
`deepseek`	DeepSeek ：API officielle de la famille DeepSeek
`moonshot`	Moonshot AI ：API officielle de la famille Kimi
`zhipu`	Zhipu AI ：API officielle de la famille GLM
`minimax`	MiniMax ：API officielle de la famille MiniMax
`grok`	xAI ：API officielle de la famille Grok
`jina`	Jina AI ：modèles d’embedding et de reranking
`tencent`	Tencent Cloud Hunyuan ：plateforme de services de modèles de Tencent Cloud

Tous les fournisseurs ne servent pas tous les modèles. Ceux qui servent un modèle donné — et les protocoles pris en charge par chacun — sont indiqués sur la page de ce modèle dans le catalogue de modèles . Les mêmes données sont accessibles par programme via provider_cards[], renvoyé par GET /v2/models/catalog/{provider}/{slug}?include=provider_price.

Modèles de chat

Les modèles de chat se répartissent sur la plupart des fournisseurs ci-dessus. La correspondance exacte et la prise en charge des protocoles figurent sur la page de chaque modèle.

Modèles vidéo

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.

Erreurs courantes

`error.type`	Condition de déclenchement
`invalid_provider_type`	La valeur ne figure pas dans l’énumération des fournisseurs : nom mal orthographié ou écriture retirée.
`provider_type_unavailable`	Le fournisseur existe mais ne sert pas ce modèle. Pour les modèles de chat, le message d’erreur liste également ceux qui le servent.