switch_heading

Documentation Seedance 1.5 API

Guide complet pour intégrer l'API de génération vidéo Seedance 1.5 dans vos applications.

API v1 · 1.5 Base URL: https://seedanceapi.org/v1

Démarrage rapide

bash

1	curl -X POST 'https://seedanceapi.org/v1/generate' \
2	-H 'Authorization: Bearer YOUR_API_KEY' \
3	-H 'Content-Type: application/json' \
4	-d '{
5	"prompt": "A cinematic shot of mountains at sunrise with flowing clouds",
6	"aspect_ratio": "16:9",
7	"resolution": "720p",
8	"duration": "8"
9	}'

Authentification

Toutes les requêtes API nécessitent une authentification avec un jeton Bearer dans l'en-tête Authorization.

Important: Vous pouvez obtenir votre clé API depuis la page API Keys dans votre tableau de bord. → Obtenir votre clé API

http

1	Authorization: Bearer YOUR_API_KEY

Tarification

480p

480p Résolution

Génération rapide, idéale pour les aperçus et brouillons

Durée	Sans audio	Avec audio
4s	8 credits	14 credits
8s	14 credits	28 credits
12s	19 credits	38 credits

720p

720p Résolution

Sortie haute qualité, recommandée pour la production

Durée	Sans audio	Avec audio
4s	14 credits	28 credits
8s	28 credits	56 credits
12s	42 credits	84 credits

Points de terminaison API

POST/v1/generateGénérer une nouvelle vidéo

Créer une nouvelle tâche de génération vidéo avec le modèle Seedance 1.5. Supporte texte-vers-vidéo et image-vers-vidéo.

Corps de la requête

Body ParametersJSON

prompt:string

Description textuelle de la vidéo à générer (max 2000 caractères)

aspect_ratio:optional string

Ratio d'aspect de sortie. Supportés : 1:1, 16:9, 9:16, 4:3, 3:4, 21:9, 9:21 Defaults to 1:1.

resolution:optional string

Résolution vidéo : 480p ou 720p Defaults to 720p.

duration:optional string

Durée de la vidéo en secondes : 4, 8 ou 12 Defaults to 8.

generate_audio:optional boolean

Activer la génération audio IA pour la vidéo Defaults to false.

fixed_lens:optional boolean

Fixer la caméra pour réduire le flou de mouvement Defaults to false.

image_urls:optional string[]

Tableau d'URLs d'images de référence pour image-vers-vidéo (max 1)

callback_url:optional string

URL webhook pour les notifications de statut asynchrones. Doit être accessible publiquement.

Texte vers vidéo

json

1	{
2	"prompt": "A majestic eagle soaring through golden sunset clouds over ocean waves",
3	"aspect_ratio": "16:9",
4	"resolution": "720p",
5	"duration": "8"
6	}

Image vers vidéo

json

1	{
2	"prompt": "The character slowly turns and smiles at the camera",
3	"image_urls": [
4	"https://example.com/my-image.jpg"
5	],
6	"aspect_ratio": "16:9",
7	"resolution": "720p",
8	"duration": "4"
9	}

Avec génération audio

json

1	{
2	"prompt": "A peaceful river flowing through a forest with birds singing",
3	"aspect_ratio": "16:9",
4	"resolution": "720p",
5	"duration": "8",
6	"generate_audio": true,
7	"fixed_lens": true
8	}

Réponses

Task created successfully

1	{
2	"code": 200,
3	"message": "success",
4	"data": {
5	"task_id": "seed15abc123def456pro",
6	"status": "IN_PROGRESS"
7	}
8	}

GET/v1/statusObtenir le statut de la tâche

Vérifier le statut d'une tâche de génération vidéo et récupérer le résultat une fois terminée.

Paramètres de requête

Body ParametersJSON

task_id:string

L'ID unique de tâche retourné par l'endpoint generate

Exemple de requête

bash

1	curl -X GET 'https://seedanceapi.org/v1/status?task_id=seed15abc123def456pro' \
2	-H 'Authorization: Bearer YOUR_API_KEY'

💡 Tip: Le champ response dans l'API de statut est un tableau d'URLs vidéo. Accédez directement à data.response[0] pour obtenir l'URL vidéo.

javascript

1	// Extract video URL from response
2	const videoUrl = data.response[0];

Réponses

1	{
2	"code": 200,
3	"message": "success",
4	"data": {
5	"task_id": "seed15abc123def456pro",
6	"status": "SUCCESS",
7	"consumed_credits": 28,
8	"created_at": "2026-02-07T10:30:00Z",
9	"request": {
10	"prompt": "A majestic eagle soaring through golden sunset clouds",
11	"aspect_ratio": "16:9",
12	"resolution": "720p",
13	"duration": "8"
14	},
15	"response": [
16	"https://cdn.example.com/videos/seed15abc123def456pro.mp4"
17	],
18	"error_message": null
19	}
20	}

Bac à sable API

Testez l'API directement depuis votre navigateur. Remplacez YOUR_API_KEY par votre véritable clé API.

Aire de jeux APIPOST

URL de base

Point de terminaison

En-têtes

Corps de la requête

Codes d'erreur

Status	Code	Description
400 Mauvaise requête	`INVALID_PROMPT`	Le prompt est invalide ou vide
400 Mauvaise requête	`INVALID_ASPECT_RATIO`	Ratio d'aspect non supporté
400 Mauvaise requête	`INVALID_RESOLUTION`	La résolution doit être 480p ou 720p
400 Mauvaise requête	`INVALID_DURATION`	La durée doit être 4, 8 ou 12 secondes
400 Mauvaise requête	`TOO_MANY_IMAGES`	Maximum 1 URL d'image autorisée dans le tableau image_urls
401 Non autorisé	`INVALID_API_KEY`	Clé API manquante ou invalide
402	`INSUFFICIENT_CREDITS`	Crédits insuffisants pour cette opération
404 Introuvable	`TASK_NOT_FOUND`	ID de tâche introuvable ou n'appartient pas à votre compte
500 Erreur interne du serveur	`INTERNAL_ERROR`	Erreur serveur, veuillez réessayer plus tard

switch_heading