Roteamento de provedores

Um modelo de vídeo pode ser atendido por mais de um provedor. provider é um campo de nível superior do corpo da requisição com dois subcampos: type escolhe o provedor e options repassa os parâmetros próprios dele.

Campo	Tipo	Descrição
`provider.type`	string	Fixa o provedor. Um valor fora da enumeração retorna `400 invalid_provider_type`; um provedor que não atende o modelo retorna `400 provider_type_unavailable`
`provider.options.<slug>`	object	Repasse específico do provedor — só o provedor correspondente recebe

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

Se provider.type não for enviado, um modelo atendido por vários provedores é distribuído por peso entre os canais disponíveis, e qual provedor atende uma requisição específica não é previsível. O caminho de vídeo não suporta order / sort / fallback, e não há forma equivalente via cabeçalho.

Os provedores disponíveis para um modelo são os listados em Provedores na página dele; a lista completa está em Roteamento de provedores.

Os dois provedores do seedance

A família bytedance/seedance-* é atendida pelos dois provedores abaixo, cujas políticas de conteúdo diferem:

Provedor	Descrição	Política de conteúdo
`volcengine`	Volcengine Ark, plataforma da ByteDance para a China continental	Moderação padrão
`byteplus`	BytePlus, plataforma da ByteDance para fora da China continental	Permite conteúdo não adequado para todos os públicos (NSFW)

byteplus permite que o seedance gere conteúdo não adequado para todos os públicos (NSFW), enquanto volcengine aplica moderação padrão. provider.type: "byteplus" precisa ser informado explicitamente quando esse conteúdo for necessário; caso contrário, a distribuição por peso pode encaminhar a requisição para volcengine, onde a moderação vai recusá-la.

`provider.options`: repasse de parâmetros

Parâmetros específicos do provedor são repassados por provider.options.<slug> e só o provedor correspondente os recebe. Parâmetros como watermark não são suportados por todos os modelos, por isso ficam no repasse do provedor e não em um campo de nível superior (alinhado ao design da OpenRouter). Quais parâmetros de repasse um modelo aceita depende do modelo.


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

type e options podem ser enviados juntos.