Seedance 2.0 Mini API

Referencia completa de la API de los modelos de generación de vídeo Seedance 2.0 Mini de ByteDance.

Variantes del modelo

Esta API admite tres variantes del modelo:

Comparación rápida

Relaciones de aspecto admitidas

21:9, 16:9, 9:16, 1:1, 4:3, 3:4

Opciones de resolución

Seedance 2.0 Mini Text to Video

Punto de conexión

POST /api/v1/video/task

Parámetros de la solicitud

Obligatorios

Opcionales

Ejemplo de solicitud

javascriptCopiar
const response = await fetch('https://api.flaq.ai/api/v1/video/task', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    model_name: 'seedance-v2.0-mini-text-to-video',
    prompt: 'A golden retriever running through a sunlit meadow',
    duration: 6,
    resolution: '720p',
    aspect_ratio: '16:9',
    sound: true
  })
});

const { data } = await response.json();
const taskId = data.task_id;

Seedance 2.0 Mini Image to Video

Parámetros de la solicitud

Obligatorios

Opcionales

Ejemplo de solicitud

javascriptCopiar
const response = await fetch('https://api.flaq.ai/api/v1/video/task', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    model_name: 'seedance-v2.0-mini-image-to-video',
    image_url: 'https://example.com/image.jpg',
    image_end_url: 'https://example.com/end-frame.jpg',
    prompt: 'Camera slowly pulls back to reveal the full landscape',
    duration: 6,
    resolution: '720p',
    aspect_ratio: '16:9',
    sound: true
  })
});

const { data } = await response.json();
const taskId = data.task_id;

Seedance 2.0 Mini Reference to Video

Parámetros de la solicitud

Obligatorios

Medios de referencia

Cada solicitud debe incluir al menos una imagen o un vídeo. Envía entre 1 y 9 imágenes cuando uses referencias de imagen. La matriz images solo se puede omitir o dejar vacía si videos contiene al menos un vídeo de referencia. No se admiten solicitudes solo de audio.

Marcadores de referencia @ (AT)

La función de referencia @ (AT) vincula los medios de referencia con la instrucción mediante marcadores numerados <<<...>>>. La numeración empieza en 1 de forma independiente para cada tipo de medio y sigue el orden de la matriz correspondiente:

Cada marcador debe apuntar a un elemento existente en su matriz correspondiente.

Opcionales

Precios de los vídeos de referencia

Seedance V2.0 Mini Reference-to-Video utiliza la misma estructura de facturación por segundo según la resolución que las demás variantes de referencia Seedance 2.0. Cuando la matriz videos contiene al menos un vídeo de referencia, el coste total de generación se multiplica por 2. Este multiplicador se aplica una sola vez, independientemente de la cantidad o duración de los vídeos de referencia subidos.

Ejemplo de solicitud

javascriptCopiar
const response = await fetch('https://api.flaq.ai/api/v1/video/task', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    model_name: 'seedance-v2.0-mini-reference-to-video',
    prompt: 'Place the explorer from <<<image_1>>> in the environment from <<<image_2>>>, following the camera movement in <<<video_1>>> and speaking with the reference voice from <<<audio_1>>>',
    duration: 8,
    resolution: '720p',
    aspect_ratio: '16:9',
    sound: true,
    images: [
      'https://example.com/explorer-reference.jpg',
      'https://example.com/environment-reference.jpg'
    ],
    videos: ['https://example.com/camera-movement-reference.mp4'],
    audios: ['https://example.com/voice-reference.mp3']
  })
});

const { data } = await response.json();
const taskId = data.task_id;

Límites de los medios

Estos límites se aplican a las imágenes del primer y último fotograma y a los medios de referencia de los modelos de esta página.

El audio y el vídeo de referencia tienen cada uno un límite independiente de duración total de 15 segundos. Sus cantidades también son independientes: hasta 9 imágenes, 3 vídeos y 3 clips de audio. Añadir vídeos no reduce el número de imágenes permitido.

Todos los modelos usan 720p por defecto, pero se debe seguir proporcionando resolution. El interruptor de sonido tiene el valor predeterminado true; ni este interruptor ni el audio de referencia cambian el precio. La generación a partir de referencias requiere al menos una imagen o un vídeo; no se admiten solicitudes solo de audio. Subir vídeos de referencia duplica el coste de generación, independientemente de su cantidad o duración.

Formato de respuesta

Respuesta inicial

Todos los modelos devuelven un task_id para consultar periódicamente el estado:

jsonCopiar
{
  "code": 0,
  "message": "success",
  "data": {
    "task_id": "{task_id}",
    "response_url": "https://api.flaq.ai/api/v1/video/{task_id}",
    "task_status": "submitted"
  }
}

Respuesta de consulta periódica

Consulta periódicamente GET /api/v1/video/{taskId} para comprobar el estado:

jsonCopiar
{
  "code": 0,
  "message": "success",
  "data": {
    "task_id": "{task_id}",
    "response_url": "https://api.flaq.ai/api/v1/video/{task_id}",
    "task_status": "succeed",
    "task_status_msg": null,
    "task_result": {
      "credit": 0.2,
      "videos": [
        {
          "url": "https://example.com/generated-video.mp4"
        }
      ]
    }
  }
}

Valores de estado

• submitted: Tarea aceptada y pendiente de procesamiento
• processing: Generación de vídeo en curso
• succeed: Generación de vídeo completada
• failed: Error en la generación de vídeo

Tiempo de procesamiento

El tiempo de procesamiento habitual es de 2 a 6 minutos, según la duración y la resolución.

Consulta el estado cada 5-10 segundos.

Buenas prácticas

1. Describe claramente el movimiento: Incluye descripciones específicas del movimiento en las instrucciones
2. Selección de resolución: Usa 480p para un procesamiento más rápido y 720p para mayor calidad
3. Mejora del audio: Mantén sound activado para una experiencia de vídeo más inmersiva
4. Imagen a vídeo: Proporciona un primer fotograma nítido mediante image_url; usa image_end_url cuando necesites controlar los fotogramas inicial y final
5. Medios de referencia: Usa imágenes, vídeos y audio de referencia compatibles, y asegúrate de incluir al menos una imagen o un vídeo
6. Precios de los vídeos de referencia: Toda solicitud de generación a partir de referencias que contenga al menos un vídeo de referencia se cobra al doble, independientemente de la cantidad o duración de los vídeos subidos
7. Parámetro de semilla: No envíes seed; los modelos Seedance 2.0 Mini no lo admiten