Reference API
Vue d ensemble API
Comprenez l authentification, la soumission, le suivi d etat et les webhooks de la Seedance 2.0 Open API.
La Seedance 2.0 Open API vous permet de soumettre des taches video asynchrones depuis votre produit, puis de recuperer le resultat une fois le traitement termine.
Base URL
https://www.seedance2.inkAuthentication
Toutes les requetes Open API utilisent un token Bearer cree depuis le tableau de bord Seedance.
Authorization: Bearer sd2_live_your_api_key{
"success": false,
"error": {
"code": "unauthorized",
"message": "Invalid API key"
}
}Flux d integration
- Creez une API Key dans le tableau de bord Seedance.
- Soumettez une tache avec
POST /api/open/v1/video/generations. - Conservez le
requestIdretourne. - Interrogez
GET /api/open/v1/video/generations/{requestId}jusqu a l etat final. - Utilisez un webhook si vous voulez recevoir une notification de fin.
Endpoints principaux
| Method | Endpoint | Description |
|---|---|---|
GET | /api/open/v1/models | Retourne les modeles disponibles, durees, ratios, resolutions et informations tarifaires. |
POST | /api/open/v1/video/generations | Cree une nouvelle tache de generation video. |
GET | /api/open/v1/video/generations/{requestId} | Consulte l etat de la tache et retourne l URL de sortie une fois prete. |
POST | /api/open/v1/video/generations/{requestId}/cancel | Annule une tache en attente ou en cours de traitement. |
Available Models
| Model | Best for | Supported durations | Resolutions |
|---|---|---|---|
seedance-2.0 | Highest quality, multimodal generation | 4-15 seconds | 480p, 720p, 1080p |
seedance-2.0-fast | Faster turnaround | 4-15 seconds | 480p, 720p, 1080p |
seedance-1.5-pro | Lower-cost fallback workloads | 5 or 10 seconds | 480p, 720p, 1080p |
Supported aspect ratios:
16:99:161:1
Valeurs de statut
| Status | Description |
|---|---|
queued | La requete a ete acceptee et attend dans la file. |
processing | La generation est en cours. |
succeeded | La tache est terminee avec succes et output.url est disponible. |
failed | La tache a echoue. Consultez error. |
cancelled | La tache a ete annulee avant la fin. |
Models Endpoint Example
curl https://www.seedance2.ink/api/open/v1/models{
"success": true,
"data": [
{
"id": "seedance-2.0",
"type": "video_generation",
"mode": "image_to_video",
"durations": [4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15],
"aspectRatios": ["16:9", "9:16", "1:1"],
"resolutions": ["480p", "720p", "1080p"],
"usdPerSecond": {
"480p": 0.05,
"720p": 0.1,
"1080p": 0.2
}
}
]
}Webhooks
Vous pouvez definir webhookUrl au niveau de la requete ou configurer une URL de rappel par defaut sur l API Key.
- Si les deux sont presentes,
webhookUrlde la requete a priorite. - Si un Webhook Secret est configure,
x-seedance-signatureest ajoute. - Les webhooks ne sont envoyes que lorsque la tache atteint un etat final.
x-seedance-signature: <hex_sha256_hmac>{
"success": true,
"requestId": "req_1234567890",
"status": "succeeded",
"output": {
"type": "video",
"url": "https://pub-your-bucket.r2.dev/open-api-results/req_1234567890.mp4"
},
"error": null
}Codes d erreur
| HTTP status | Error code | Description |
|---|---|---|
400 | invalid_request | Le corps de requete ne correspond pas au schema attendu. |
401 | unauthorized | L API Key est absente ou invalide. |
402 | insufficient_credits | Le compte ne dispose pas de credits suffisants. |
404 | not_found | La tache est introuvable pour l API Key actuelle. |
429 | rate_limited | La limite par minute ou le quota mensuel a ete depasse. |
500 | internal_error | Une erreur interne inattendue est survenue. |
Etapes suivantes
- Lire Texte vers video
- Lire Image vers video