Passer au contenu principal
POST
/
v1
/
videos
/
generations
seedance-2.0 API
curl --request POST \
  --url https://api.evolink.ai/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "seedance-2.0",
  "prompt": "@Image1 as first frame, a cinematic drone shot over a coastal city at golden hour",
  "image_urls": [
    "https://example.com/ref1.jpg",
    "https://example.com/ref2.jpg"
  ],
  "video_urls": [
    "https://example.com/reference.mp4"
  ],
  "audio_urls": [
    "https://example.com/reference.mp3"
  ],
  "duration": 10,
  "quality": "1080p",
  "aspect_ratio": "16:9",
  "generate_audio": true
}
'
{
  "created": 1761313744,
  "id": "task-unified-1761313744-vux2jw0k",
  "model": "seedance-2.0",
  "object": "video.generation.task",
  "progress": 0,
  "status": "pending",
  "task_info": {
    "can_cancel": true,
    "estimated_time": 165,
    "video_duration": 8
  },
  "type": "video",
  "usage": {
    "billing_rule": "per_call",
    "credits_reserved": 8,
    "user_group": "default"
  }
}
Ce modèle n’est pas encore disponible. Les paramètres de l’API peuvent être ajustés avant la publication officielle. Veuillez vous référer au comportement réel après le lancement.

Autorisations

​
Authorization
string
header
requis

##Toutes les API nécessitent une authentification Bearer Token##

Obtenir une clé API :

Visitez la Page de gestion des clés API pour obtenir votre clé API

Ajouter à l'en-tête de requête :

Authorization: Bearer YOUR_API_KEY

Corps

application/json
​
model
enum<string>
défaut:seedance-2.0
requis

Nom du modèle de génération vidéo

Options disponibles:
seedance-2.0
Exemple:

"seedance-2.0"

​
prompt
string
requis

Prompt décrivant la vidéo que vous souhaitez générer, limité à 2000 tokens. Utilisez les tags @-référence pour attribuer des rôles aux fichiers téléchargés

Tags @-référence :

  • @Image1, @Image2... → images de image_urls (dans l'ordre)
  • @Video1, @Video2... → vidéos de video_urls (dans l'ordre)
  • @Audio1, @Audio2... → audios de audio_urls (dans l'ordre)
  • Exemple : @Image1 as first frame, replicate @Video1 camera movement, @Audio1 for BGM rhythm
Maximum string length: 2000
Exemple:

"@Image1 as first frame, a cinematic drone shot over a coastal city at golden hour"

​
image_urls
string<uri>[]

Liste d'URLs d'images de référence pour la génération image-vers-vidéo et multimodale

Note :

  • Maximum 9 images par requête
  • Taille maximale : 30MB par image
  • Formats de fichiers pris en charge : .jpeg, .png, .webp, .bmp, .tiff, .gif
  • Limite totale d'entrée mixte : 12 fichiers toutes modalités confondues
  • Les téléchargements de visages humains réalistes ne sont pas pris en charge et seront automatiquement rejetés
  • Les URLs des images doivent être directement accessibles par le serveur
Maximum array length: 9
Exemple:
["https://example.com/image.jpg"]
​
video_urls
string<uri>[]

Liste d'URLs de vidéos de référence pour l'édition vidéo-vers-vidéo et le système de @-référence

Note :

  • Maximum 3 vidéos par requête, durée totale 2–15 secondes
  • Taille maximale : 50MB par vidéo
  • Formats de fichiers pris en charge : .mp4, .mov
  • Plage de pixels : 409 600 (480p) – 927 408 (720p)
  • L'utilisation de références vidéo augmentera le coût
  • Les téléchargements de visages humains réalistes ne sont pas pris en charge et seront automatiquement rejetés
  • Les URLs doivent être directement accessibles par le serveur
Maximum array length: 3
Exemple:
["https://example.com/reference.mp4"]
​
audio_urls
string<uri>[]

Liste d'URLs audio de référence pour la génération pilotée par l'audio via le système de @-référence

Note :

  • Maximum 3 pistes audio par requête, durée totale ≤ 15 secondes
  • Taille maximale : 15MB par audio
  • Formats de fichiers pris en charge : .mp3, .wav
  • Aligne les coupes, l'énergie du mouvement et les transitions sur le beat et le rythme
  • Les URLs doivent être directement accessibles par le serveur
Maximum array length: 3
Exemple:
["https://example.com/reference.mp3"]
​
duration
integer

Spécifie la durée de la vidéo générée (en secondes), par défaut 5 secondes

Note :

  • Prend en charge toute valeur entière entre 4 et 15 secondes
  • La facturation d'une requête est basée sur la valeur de duration ; des durées plus longues entraînent des coûts plus élevés
Plage requise: 4 <= x <= 15
​
quality
enum<string>

Résolution vidéo, par défaut 720p

Note :

  • 480p : Résolution inférieure, tarification réduite
  • 720p : Définition standard, tarification standard, c'est la valeur par défaut
  • 1080p : Haute définition, tarification supérieure
Options disponibles:
480p,
720p,
1080p
Exemple:

"720p"

​
aspect_ratio
string

Rapport d'aspect vidéo

Valeurs prises en charge :

  • 16:9 (paysage), 9:16 (portrait), 1:1 (carré), 4:3, 3:4, 21:9 (ultra-large), adaptive
  • Valeur par défaut : 16:9
Exemple:

"16:9"

​
generate_audio
boolean
défaut:true

Indique s'il faut générer de l'audio, l'activation augmentera le coût, par défaut true

Options :

  • true : La vidéo produite par le modèle inclut un audio synchronisé. Seedance 2.0 peut générer automatiquement des voix, des effets sonores et de la musique de fond correspondants en fonction des prompts textuels et du contenu visuel. Il est recommandé de placer les dialogues entre guillemets doubles pour optimiser la génération audio. Exemple : L'homme a arrêté la femme et a dit : "Souviens-toi, tu ne dois jamais pointer la lune avec ton doigt."
  • false : La vidéo produite par le modèle est muette
Exemple:

true

​
callback_url
string<uri>

URL de rappel HTTPS après l'achèvement de la tâche

Moment du rappel :

  • Déclenché lorsque la tâche est terminée, échouée ou annulée
  • Envoyé après la confirmation de la facturation

Restrictions de sécurité :

  • Seul le protocole HTTPS est pris en charge
  • Les rappels vers les adresses IP du réseau interne sont interdits (127.0.0.1, 10.x.x.x, 172.16-31.x.x, 192.168.x.x, etc.)
  • La longueur de l'URL ne doit pas dépasser 2048 caractères

Mécanisme de rappel :

  • Délai d'expiration : 10 secondes
  • Maximum de 3 tentatives après échec (les tentatives ont lieu après 1/2/4 secondes suivant l'échec)
  • Le format du corps de réponse du rappel est cohérent avec le format de réponse de l'API de consultation de tâche
  • Un code de statut 2xx retourné par l'URL de rappel est considéré comme réussi ; les autres codes de statut déclencheront des tentatives
Exemple:

"https://your-domain.com/webhooks/video-task-completed"

Réponse

Tâche de génération vidéo créée avec succès

​
created
integer

Horodatage de création de la tâche

Exemple:

1761313744

​
id
string

ID de tâche

Exemple:

"task-unified-1761313744-vux2jw0k"

​
model
string

Nom du modèle réellement utilisé

Exemple:

"seedance-2.0"

​
object
enum<string>

Type spécifique de la tâche

Options disponibles:
video.generation.task
​
progress
integer

Pourcentage de progression de la tâche (0-100)

Plage requise: 0 <= x <= 100
Exemple:

0

​
status
enum<string>

Statut de la tâche

Options disponibles:
pending,
processing,
completed,
failed
Exemple:

"pending"

​
task_info
object

Informations détaillées de la tâche vidéo

​
type
enum<string>

Type de sortie de la tâche

Options disponibles:
text,
image,
audio,
video
Exemple:

"video"

​
usage
object

Informations d'utilisation et de facturation