DOCUMENTATION DÉVELOPPEUR
De votre description à la vidéo, directement.
Ces exemples appellent SeedanceLink. Utilisez votre propre clé API ; votre session Google sert à la console web.
Avant de commencer
Connectez-vous, ajoutez assez de solde pour le devis et créez une clé dans un groupe où Seedance est activé. L’exemple minimal ci-dessous demande 4 secondes en 480p.
Authentification
Envoyez Authorization: Bearer YOUR_API_KEY pour les requêtes de création, d’état et de contenu. Utilisez la clé qui a créé la tâche. Ne placez jamais votre clé dans une URL.
Authorization: Bearer YOUR_API_KEYhttps://seedancelink.ioSans précision, la durée est de 5 secondes et la résolution de 720p. Ces exemples choisissent explicitement 4 secondes et 480p. Envoyez application/json et utilisez l’un des deux ID de modèle de la page des modèles.
Exécutez ces exemples curl dans le même terminal macOS/Linux ou Windows WSL. Le premier définit votre clé et l’adresse API du site. Gardez votre clé secrète.
Créer une tâche
Cet exemple demande une vidéo de 4 secondes. Conservez l’id renvoyé. Seedance 2.0 accepte 4–15 secondes, et Seedance 2.5, 4–30. Les deux acceptent 480p, 720p et 1080p.
API_KEY='YOUR_API_KEY'
API_BASE='https://seedancelink.io'
curl --fail-with-body --request POST "$API_BASE/api/v3/contents/generations/tasks" \
--header "Authorization: Bearer $API_KEY" \
--header "Content-Type: application/json" \
--data '{
"model": "seedance-2.0-933",
"content": [
{
"type": "text",
"text": "Un petit bateau traverse un lac calme au lever du soleil, éclairage cinématographique."
}
],
"duration": 4,
"resolution": "480p",
"ratio": "16:9"
}'Exemple de réponse
{
"id": "YOUR_TASK_ID",
"status": "queued"
}Conservez l’ID de tâche reçu dans la réponse ; utilisez-le aux deux étapes suivantes.
Consulter son état
Remplacez REPLACE_WITH_RESPONSE_ID par cet id. Vérifiez toutes les 15 secondes pendant l’attente ou l’exécution. Téléchargez au statut succeeded. Si le statut est failed ou needs_reconcile, arrêtez les vérifications ; pour needs_reconcile, contactez l’assistance. Ne soumettez pas automatiquement une nouvelle tâche.
Exemple de réponse
{
"id": "YOUR_TASK_ID",
"status": "succeeded"
}Consultez l’état environ toutes les 15 secondes. Téléchargez uniquement après succeeded.
Télécharger la vidéo
Utilisez la même clé que pour la création. Cet endpoint protégé exige votre clé Bearer ; ouvrir l’URL dans un navigateur ne suffit pas. curl suit les redirections HTTPS sans partager la clé avec d’autres hôtes.
États et facturation
queued- Acceptée et en attente.
running- Génération en cours.
succeeded- Terminée ; l’endpoint de contenu authentifié est prêt.
failed- La génération a échoué ; le montant réservé a été restitué.
needs_reconcile- L’envoi est incertain ; le montant reste réservé pour vérification.
Un devis avant la génération.
Secondes demandées × tarif de la résolution × multiplicateur applicable. Le montant du devis est réservé à l’envoi, débité en cas de réussite et restitué en cas d’échec.
Téléchargez avec la même clé
Après succeeded, utilisez content.video_url ou l’endpoint de contenu ci-dessous avec votre clé API. Un solde restant nul n’empêche pas de télécharger une tâche déjà payée.
Si l’envoi est incertain
Un reçu 202 avec needs_reconcile contient toujours un ID de tâche local. Conservez cet ID et consultez son état. Ne créez pas automatiquement une autre tâche : le montant initial reste réservé.