Estado y resultado de la tarea de Seedance

La creación de vídeos de Seedance es asíncrona. La solicitud de creación devuelve un ID de tarea; sondea Modelflare hasta que la tarea se complete o falle.

Modelos compatibles

Crear una tarea

Utilice la página del modelo coincidente para ver el cuerpo completo de la solicitud:

bash

curl https://modelflare.dev/v1/videos \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.5",
    "content": [{"type": "text", "text": "A cat walks through a sunlit room"}],
    "resolution": "720p",
    "duration": 5,
    "ratio": "16:9"
  }'

Guardar id de la respuesta. Las respuestas de compatibilidad pueden utilizar task_id.

Sondear la tarea

bash

curl https://modelflare.dev/v1/videos/TASK_ID \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY"

La respuesta del público está normalizada entre los proveedores de vídeo:

JSON

{
  "id": "TASK_ID",
  "object": "video",
  "model": "seedance-2.5",
  "status": "in_progress",
  "progress": 42,
  "created_at": 1786084139,
  "seconds": "5",
  "metadata": {
    "action": "omniGenerate",
    "resolution": "1080p",
    "ratio": "9:16",
    "output_format": "mp4",
    "generate_audio": true,
    "usage": {"completion_tokens": 120, "total_tokens": 140}
  }
}

Sondeo mientras status es queued o in_progress. Deténgase en completed o failed.

Estado	Significado	Siguiente paso
queued	Esperando para ejecutar	Encuesta nuevamente
in_progress	Procesamiento	Encuesta nuevamente
completed	Vídeo listo	Descargar el contenido
failed	Tarea fallida	Leer el error y arreglar la solicitud

Cuando la respuesta del servicio los incluye, metadata puede contener la acción normalizada, la resolución, la relación, el formato de salida, el indicador de audio y el uso del token. Trate estos campos como opcionales; utilice status y el punto final de contenido como contrato estable.

Descargar el resultado

bash

curl --fail --location \
  https://modelflare.dev/v1/videos/TASK_ID/content \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  --output seedance-result.mp4

El punto final de contenido devuelve la transmisión de video. Guárdelo lo antes posible porque las URL de resultados pueden caducar.

Tareas fallidas

La creación puede devolver un ID de tarea antes de que finalice la validación del proveedor. Por lo tanto, una encuesta posterior puede cambiar la tarea a failed. Conserve el ID de la solicitud cuando investigue errores. No vuelva a intentarlo cambiando silenciosamente el sobre de solicitud a otra familia de modelos.