Passer au contenu principal
POST
/
v1
/
videos
/
generations
doubao-seedance-1.0-pro-fast API
curl --request POST \
  --url https://api.evolink.ai/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "doubao-seedance-1.0-pro-fast",
  "prompt": "A cat playing piano"
}
'
{
  "created": 1761313744,
  "id": "task-unified-1761313744-vux2jw0k",
  "model": "doubao-seedance-1.0-pro-fast",
  "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"
  }
}

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:doubao-seedance-1.0-pro-fast
requis

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

Options disponibles:
doubao-seedance-1.0-pro-fast
Exemple:

"doubao-seedance-1.0-pro-fast"

​
prompt
string
requis

Prompt décrivant la vidéo que vous souhaitez générer, limité à 2000 tokens

Maximum string length: 2000
Exemple:

"A cat playing piano"

​
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 2 et 12 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: 2 <= x <= 12
​
quality
enum<string>

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

Note :

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

"1080p"

​
aspect_ratio
string

Rapport d'aspect vidéo

Mode texte-vers-vidéo :

  • Valeur par défaut : 16:9
  • Valeurs prises en charge : 16:9 (paysage), 9:16 (portrait), 1:1 (carré), 4:3, 3:4, 21:9 (ultra-large)

Mode image-vers-vidéo (lors de l'utilisation de image_urls) :

  • Valeur par défaut : adaptive
  • Valeurs prises en charge : En plus des 6 rapports ci-dessus, prend également en charge keep_ratio (conserver le rapport d'aspect original) et adaptive (adaptatif)
Exemple:

"16:9"

​
image_urls
string<uri>[]

Liste d'URLs d'images de référence pour la fonctionnalité image-vers-vidéo

Note :

  • Nombre d'images prises en charge par requête : 1 image
  • Taille de l'image : Ne dépassant pas 10MB
  • Formats de fichiers pris en charge : .jpg, .jpeg, .png, .webp
  • Les URLs des images doivent être directement consultables par le serveur, ou l'URL doit déclencher un téléchargement direct lors de l'accès (généralement ces URLs se terminent par des extensions d'image comme .png, .jpg)
Maximum array length: 1
Exemple:
["https://example.com/image.jpg"]
​
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:

"doubao-seedance-1.0-pro-fast"

​
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