API Seedance 2.0 Mini

Referencia completa de la API para los modelos de generación de video Seedance 2.0 Mini de ByteDance.

Variantes del modelo

Esta API admite tres variantes de 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 solicitud

Obligatorios

Opcionales

Solicitud de ejemplo

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 solicitud

Obligatorios

Opcionales

Solicitud de ejemplo

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 solicitud

Obligatorios

Medios de referencia

Cada solicitud debe incluir al menos una imagen o un video. Envía de 1 a 9 imágenes cuando utilices referencias de imagen. El array images solo puede omitirse o estar vacío cuando el array videos contenga al menos un video de referencia. No se admiten solicitudes que solo incluyan audio.

Marcadores de posición de referencia @ (AT)

La función de referencia @ (AT) vincula los medios de referencia al prompt mediante marcadores de posición <<<...>>> numerados. La numeración comienza en 1 de forma independiente para cada tipo de medio y sigue el orden del array correspondiente:

Cada marcador de posición debe apuntar a un elemento que exista en su array correspondiente.

Opcionales

Precios de los videos de referencia

Seedance V2.0 Mini Reference-to-Video sigue la misma estructura de facturación por segundo y basada en la resolución que las demás variantes de referencia de Seedance 2.0. Cuando el array videos contiene al menos un video de referencia, el cargo total de generación se multiplica por 2. Este multiplicador se aplica una sola vez, independientemente del número o la duración de los videos de referencia subidos.

Solicitud de ejemplo

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;

Formato de respuesta

Respuesta inicial

Todos los modelos devuelven un task_id para sondeo:

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 sondeo

Consulta 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": {
      "videos": [
        {
          "url": "https://example.com/generated-video.mp4"
        }
      ]
    }
  }
}

Valores de estado

• submitted: Tarea aceptada y en espera de procesamiento
• processing: Generación de video en curso
• succeed: Generación de video completada
• failed: La generación de video falló

Tiempo de procesamiento

El tiempo de procesamiento típico es de 2-6 minutos según la duración y la resolución.

Consulta cada 5-10 segundos para comprobar el estado.

Mejores prácticas

1. Describe el movimiento con claridad: Incluye descripciones específicas de movimiento en los prompts
2. Selección de resolución: Usa 480p para procesamiento más rápido, 720p para mayor calidad
3. Mejora de audio: Mantén sound activado para experiencias de video más inmersivas
4. Imagen a video: Proporciona un primer fotograma claro mediante image_url; usa image_end_url cuando necesites fotogramas iniciales y finales controlados
5. Medios de referencia: Utiliza referencias de imagen, video y audio compatibles, y asegúrate de incluir al menos una imagen o un video
6. Precios de los videos de referencia: Cualquier solicitud Reference-to-Video que contenga al menos un video de referencia se cobra al doble, independientemente del número o la duración de los videos subidos
7. Parámetro seed: No envíes seed; los modelos Seedance 2.0 Mini no lo admiten