Passer au contenu principal
POST
/
v1
/
videos
/
generations
Sora-2-Preview API
curl --request POST \
  --url https://api.evolink.ai/v1/videos/generations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "sora-2-preview",
  "prompt": "A cat playing piano"
}
'
{
  "created": 1757169743,
  "id": "task-unified-1757169743-7cvnl5zw",
  "model": "sora-2-preview",
  "object": "video.generation.task",
  "progress": 0,
  "status": "pending",
  "task_info": {
    "can_cancel": true,
    "estimated_time": 300,
    "video_duration": 9
  },
  "type": "video",
  "usage": {
    "billing_rule": "per_call",
    "credits_reserved": 7,
    "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
string
défaut:sora-2-preview
requis

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

Exemple:

"sora-2-preview"

​
prompt
string
requis

Prompt décrivant la vidéo à générer, max 5000 tokens

Maximum string length: 5000
Exemple:

"A cat playing piano"

​
aspect_ratio
enum<string>

Rapport d'aspect vidéo. 1280x720 génère une vidéo en paysage, 720x1280 génère une vidéo en portrait

Options disponibles:
1280x720,
720x1280,
16:9,
9:16
Exemple:

"16:9"

​
duration
integer

Durée de la vidéo (secondes), par défaut 4

Note :

  • Prend uniquement en charge 4, 8, 12 secondes
  • Une durée plus longue coûte plus cher
Exemple:

4

​
image_urls
string<uri>[]

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

Note :

  • Les images de personnes réelles ne sont pas prises en charge
  • Maximum 1 image par requête
  • Taille maximale : 10MB
  • Formats : .jpg, .jpeg, .png, .webp
  • Les dimensions en pixels de l'image doivent correspondre exactement au aspect_ratio sélectionné (par ex., si aspect_ratio est 1280x720, l'image téléchargée doit être exactement de 1280x720 pixels)
  • L'URL de l'image doit être directement accessible par le serveur, ou déclencher un téléchargement lors de l'accès (généralement des URLs se terminant par des extensions d'image comme .png, .jpg)
Maximum array length: 1
Exemple:
["http://example.com/image1.jpg"]
​
callback_url
string<uri>

URL de rappel HTTPS pour 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é :

  • Protocole HTTPS uniquement
  • Adresses IP privées non autorisées (127.0.0.1, 10.x.x.x, 172.16-31.x.x, 192.168.x.x, etc.)
  • Longueur maximale de l'URL : 2048 caractères

Mécanisme de rappel :

  • Délai d'expiration : 10 secondes
  • Maximum 3 tentatives en cas d'échec (à intervalles de 1s/2s/4s)
  • Le format de réponse correspond à l'API de consultation de tâche
  • Code de statut 2xx = succès, les autres codes déclenchent une nouvelle tentative
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:

1757169743

​
id
string

ID de tâche

Exemple:

"task-unified-1757169743-7cvnl5zw"

​
model
string

Nom du modèle utilisé

Exemple:

"sora-2-preview"

​
object
enum<string>

Type de tâche

Options disponibles:
video.generation.task
​
progress
integer

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
​
type
enum<string>

Type de sortie

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

"video"

​
usage
object