Génération Vidéo Asynchrone Seedance 1.5 Pro

Documentation API

Utilisez ces points de terminaison pour soumettre des tâches Seedance 1.5 Pro et vérifier leur statut. Chaque appel consomme des crédits en fonction de la durée et de l'audio (dialogues synchronisés, effets sonores, musique).

Authentification

Toutes les requêtes doivent inclure votre clé API dans l'en-tête Authorization header:

Authorization: Bearer <YOUR_API_KEY>

Les clés manquantes ou invalides retournent 401 Unauthorized.

POST

https://seedance1-5pro.com/api/generate

Créer une tâche de génération

Soumet une nouvelle tâche Seedance 1.5 Pro. L'appel retourne immédiatement un task_id tandis que le rendu s'achève de manière asynchrone.

Paramètre	Type	Requis	Description
prompt	string (max 1000 chars)	Oui	Description de la scène principale (texte ou flux d'image).
aspect_ratio	string	Oui	Supporté : 16:9, 9:16, 1:1. Ignoré si image_urls existe.
duration	string	Oui	Durée du rendu en secondes ("5" ou "10").
sound	boolean	Non	Inclure l'audio dans le clip (dialogues synchronisés, effets sonores, musique).
image_urls	string[]	Non	URL optionnelles des images de référence (requises pour l'image-vers-vidéo).

Consommation de crédits

Les crédits sont déduits lors de la création de la tâche. Les tâches échouées sont automatiquement remboursées.

Préréglage	Crédits déduits
5 s sans audio	65
10 s sans audio	130
5 s avec audio	130
10 s avec audio	260

Exemple de requête

{
  "prompt": "Drone shot over neon night market",
  "aspect_ratio": "16:9",
  "duration": "5",
  "sound": false,
  "image_urls": [
    "https://cdn.example.com/reference/frame01.png"
  ]
}

Exemple de réponse

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "sd15p_b6d54c8f4b4c4e8"
  }
}

GET / POST

https://seedance1-5pro.com/api/status

Vérifier le statut de la tâche

Utilisez ce point de terminaison pour interroger l'enregistrement le plus récent. Lorsque la tâche est toujours en statut IN_PROGRESS, nous interrogeons le fournisseur une fois de plus avant de répondre.

Paramètre	Type	Requis	Description
task_id	string	Oui	ID retourné par /generate. Envoyez-le via paramètre de requête (?task_id=) ou corps JSON.

Champ	Description
task_id	ID retourné par /generate.
status	SUCCESS (SUCCÈS)
request	Copie nettoyée de la charge utile soumise.
response	Tableau des URL de médias lorsque le statut est SUCCESS.
consumed_credits	Crédits facturés pour la tâche (0 en cas de remboursement).
error_message	Erreur du fournisseur lorsque le statut est FAILED.
created_at	Horodatage UTC auquel la tâche a été enregistrée.

Exemple de requête

GET https://seedance1-5pro.com/api/status?task_id=sd15p_b6d54c8f4b4c4e8
Authorization: Bearer <YOUR_API_KEY>

# or POST
POST https://seedance1-5pro.com/api/status
Authorization: Bearer <YOUR_API_KEY>
Content-Type: application/json

{
  "task_id": "sd15p_b6d54c8f4b4c4e8"
}

Exemple de réponse

{
  "code": 200,
  "message": "success",
  "data": {
    "task_id": "sd15p_b6d54c8f4b4c4e8",
    "status": "SUCCESS",
    "request": {
      "prompt": "Drone shot over neon night market",
      "aspect_ratio": "16:9",
      "duration": "5",
      "sound": false
    },
    "response": [
      "https://static.gogloai.com/seedance15pro/clip_001.mp4"
    ],
    "consumed_credits": 65,
    "error_message": null,
    "created_at": "2025-06-14T05:21:11Z"
  }
}

Gestion des erreurs

401 Unauthorized - Clé API manquante ou invalide.
402 Payment Required - Le solde de crédits n'a pas pu couvrir la déduction.
429 Too Many Requests - Réduisez la cadence de vérification ou le taux de requêtes.
500 - Problème transitoire ; réessayez avec un backoff exponentiel.