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 dos 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',
    seed: -1,
    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',
    seed: -1,
    sound: true
  })
});

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. Reproducibilidad: Usa el parámetro seed para reproducir generaciones específicas
4. Mejora de audio: Mantén sound activado para experiencias de video más inmersivas
5. Imagen a video: Proporciona un primer fotograma claro mediante image_url; usa image_end_url cuando necesites fotogramas iniciales y finales controlados