Seedance

La création vidéo Seedance est asynchrone. La demande de création renvoie un ID de tâche ; interrogez Modelflare jusqu’à ce que la tâche soit terminée ou échoue.

Modèles pris en charge

Créer une tâche

Utilisez la page de modèle correspondante pour le corps complet de la demande :

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"
  }'

Enregistrez id de la réponse. Les réponses de compatibilité peuvent utiliser task_id.

Interroger la tâche

bash

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

La réponse publique est normalisée entre les fournisseurs de vidéo :

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}
  }
}

Interrogation pendant que status est queued ou in_progress. Arrêtez-vous à completed ou failed.

Statut	Signification	Étape suivante
queued	En attente d’exécution	Sondage à nouveau
in_progress	Traitement	Sondage à nouveau
completed	La vidéo est prête	Télécharger le contenu
failed	Échec de la tâche	Lisez l’erreur et corrigez la requête

Lorsque la réponse du service les inclut, metadata peut contenir l’action normalisée, la résolution, le rapport, le format de sortie, l’indicateur audio et l’utilisation du jeton. Traitez ces champs comme facultatifs ; utilisez status et le point de terminaison du contenu comme contrat stable.

Télécharger le résultat

bash

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

Le point de terminaison du contenu renvoie le flux vidéo. Stockez-le rapidement car les URL de résultats peuvent expirer.

Tâches échouées

La création peut renvoyer un ID de tâche avant la fin de la validation du fournisseur. Une interrogation ultérieure peut donc changer la tâche en failed. Conservez l’ID de demande lors de l’enquête sur les erreurs. Ne réessayez pas en modifiant silencieusement l’enveloppe de demande vers une autre famille de modèles.