Enrutamiento de proveedores

Un modelo de vídeo puede estar servido por más de un proveedor. provider es un campo de nivel superior del cuerpo de la petición con dos subcampos: type elige el proveedor y options transmite los parámetros propios de ese proveedor.

Campo	Tipo	Descripción
`provider.type`	string	Fija el proveedor. Un valor fuera de la enumeración devuelve `400 invalid_provider_type`; un proveedor que no sirve el modelo devuelve `400 provider_type_unavailable`
`provider.options.<slug>`	object	Passthrough propio del proveedor: solo lo recibe el proveedor que coincide

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 no se envía provider.type, un modelo servido por varios proveedores se reparte con un peso entre los canales disponibles, y qué proveedor atiende una petición concreta no es predecible. La ruta de vídeo no admite order / sort / fallback, ni existe una cabecera equivalente.

Los proveedores disponibles para un modelo son los que aparecen en Proveedores en su página; la lista completa está en Enrutamiento de proveedores.

Los dos proveedores de seedance

La familia bytedance/seedance-* está servida por los dos proveedores siguientes, cuyas políticas de contenido difieren:

Proveedor	Descripción	Política de contenido
`volcengine`	Volcengine Ark, plataforma de ByteDance para China continental	Moderación estándar
`byteplus`	BytePlus, plataforma de ByteDance para el resto del mundo	Permite contenido no apto para todos los públicos (NSFW)

byteplus permite que seedance genere contenido no apto para todos los públicos (NSFW), mientras que volcengine aplica moderación estándar. Debe indicarse provider.type: "byteplus" de forma explícita cuando se requiera ese contenido; de lo contrario, el reparto ponderado puede enviar la petición a volcengine, donde la moderación la rechazará.

`provider.options`: transmisión de parámetros

Los parámetros propios del proveedor se transmiten mediante provider.options.<slug> y solo los recibe el proveedor que coincide. Parámetros como watermark no están admitidos por todos los modelos, por eso se ubican en el passthrough del proveedor y no en un campo de nivel superior (siguiendo el diseño de OpenRouter). Qué parámetros acepta cada modelo depende del modelo.


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

type y options pueden enviarse juntos.