Familia Seedance

Los modelos de generación de vídeo de ByteDance, cuatro en total, que se invocan a través del endpoint de vídeo de OfoxAI POST /v1/videos. Las tareas se ejecutan de forma asíncrona: al crear una tarea se obtiene su ID, con el que después se consulta el resultado.

Elección de modelo

Los cuatro admiten texto a vídeo, imagen a vídeo y referencias de vídeo, y pueden generar una pista de audio sincronizada (generate_audio es true de forma predeterminada). adaptive conserva la proporción de la imagen de entrada.

La tabla anterior coincide con el video_attributes que devuelve la Models API; si cambian las capacidades de un modelo, prevalece lo que devuelva la API. La facturación es por segundo y el coste real es el usage.video_cost del resultado de la tarea; los precios están en la página del modelo .

Ejemplos de llamada

Los ejemplos siguientes solo muestran la petición de creación de la tarea. El flujo completo para consultar el estado y descargar el resultado está en Video API · Inicio rápido.

curl -X POST https://api.ofox.ai/v1/videos \
  -H "Authorization: Bearer $OFOX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "bytedance/seedance-2.0-mini",
    "prompt": "Un zorro corre por la nieve, con la cámara siguiéndolo",
    "duration": 5,
    "resolution": "720p",
    "aspect_ratio": "16:9"
  }'

curl -X POST https://api.ofox.ai/v1/videos \
  -H "Authorization: Bearer $OFOX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "bytedance/seedance-2.0",
    "prompt": "El perro de la imagen corre hacia la cámara",
    "duration": 5,
    "resolution": "720p",
    "aspect_ratio": "adaptive",
    "frame_images": [
      { "type": "image_url", "image_url": { "url": "https://example.com/dog.jpg" }, "frame_type": "first_frame" }
    ]
  }'

curl -X POST https://api.ofox.ai/v1/videos \
  -H "Authorization: Bearer $OFOX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "bytedance/seedance-2.0",
    "prompt": "Un capullo se abre lentamente hasta convertirse en una rosa en plena floración",
    "duration": 5,
    "resolution": "720p",
    "frame_images": [
      { "type": "image_url", "image_url": { "url": "https://example.com/bud.jpg" }, "frame_type": "first_frame" },
      { "type": "image_url", "image_url": { "url": "https://example.com/rose.jpg" }, "frame_type": "last_frame" }
    ]
  }'

curl -X POST https://api.ofox.ai/v1/videos \
  -H "Authorization: Bearer $OFOX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "bytedance/seedance-2.5",
    "prompt": "La chica de la imagen 1 sostiene la taza de la imagen 2 y sonríe junto a la ventana de una cafetería",
    "duration": 5,
    "resolution": "720p",
    "input_references": [
      { "type": "image_url", "image_url": { "url": "https://example.com/girl.jpg" } },
      { "type": "image_url", "image_url": { "url": "https://example.com/cup.jpg" } }
    ]
  }'

curl -X POST https://api.ofox.ai/v1/videos \
  -H "Authorization: Bearer $OFOX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "bytedance/seedance-2.0",
    "prompt": "El personaje habla con el tono de esta locución, y el estilo de cámara toma como referencia este vídeo",
    "duration": 5,
    "resolution": "720p",
    "input_references": [
      { "type": "image_url", "image_url": { "url": "https://example.com/character.jpg" } },
      { "type": "audio_url", "audio_url": { "url": "https://example.com/voice.mp3" } },
      { "type": "video_url", "video_url": { "url": "https://example.com/style-ref.mp4" } }
    ]
  }'

• frame_images e input_references no pueden enviarse a la vez; si se envían juntos, se devuelve 400 references_conflict.
• Las imágenes pueden ser URL públicas o cadenas que empiecen por data:image/...;base64,.
• Si no necesita pista de audio, envíe "generate_audio": false.
• La descripción completa de la estructura de campos está en Crear una tarea de vídeo.

Imágenes de referencia de personas reales

La API oficial de Seedance de ByteDance no permite subir directamente imágenes o vídeos de referencia que contengan rostros de personas reales. La documentación oficial de BytePlus Seedance 2.0  exige usar material de retrato de personas reales autorizado, y la guía de la biblioteca de retratos de personas reales de Volcano Engine Ark  enumera los pasos: enviar una invitación, verificación y autorización por parte de la propia persona, subida del material, recepción de la autorización y obtención del ID del material.

{
  "model": "bytedance/seedance-2.0",
  "prompt": "La persona de la imagen camina por un mercado nocturno de aspecto cinematográfico",
  "duration": 5,
  "resolution": "720p",
  "real_person": true,
  "input_references": [
    { "type": "image_url", "image_url": { "url": "https://example.com/person.jpg" } }
  ]
}

• Antes del envío, OfoxAI aplica un preprocesamiento de privacidad a las imágenes de referencia, lo que puede reducir los rechazos erróneos de la moderación anti-deepfake upstream, aunque no garantiza que el proveedor las acepte; las tareas rechazadas upstream no se facturan.
• real_person es una instrucción de procesamiento, no una prueba de autorización. Envíe únicamente imágenes que tenga derecho legal y autorización para usar.
• Cómo ajustar las imágenes que siguen siendo rechazadas y los códigos de error del preprocesamiento: Imágenes de referencia de personas reales.

Especificar el proveedor

Para fijar el proveedor, añada en el nivel superior de la petición:

"provider": { "type": "byteplus" }

Un valor incorrecto en provider.type devuelve 400 invalid_provider_type; si el proveedor especificado no sirve el modelo, se devuelve 400 provider_type_unavailable. La descripción general está en Enrutamiento de proveedores de vídeo.

Errores habituales

Si la tarea se crea correctamente pero falla durante la generación, la consulta devuelve status: "failed" y la causa figura en el campo error; el tiempo de espera agotado corresponde a error.code: "expired". Todos los códigos de error están en Códigos de error de Video API.

Documentación oficial

• API de generación de vídeo BytePlus Seedance 2.0 
• Centro de documentación de Volcano Engine Ark 
• OfoxAI · Crear una tarea de vídeo

Preguntas frecuentes