​
API Création de Vidéos

Le service de création de vidéos vous permet de transformer vos images statiques en animations dynamiques grâce à l’intelligence artificielle.

​
Générer une vidéo

​
POST /api/animation/v2/generate

​
Paramètres de la requête

​
user_id
string
required
L’identifiant unique de l’utilisateur (UUID) que vous pouvez récupérer dans votre Espace Développeur
​
image_urls
array
required
Tableau d’URLs des images à animer. Actuellement, la première image du tableau est utilisée pour la création de la vidéo.
​
option
string
required
Type d’animation souhaité. Valeurs possibles: “ZOOM_IN”, “ZOOM_OUT”, “PAN_RIGHT”, “PAN_LEFT”, “PAN_UP”, “PAN_DOWN”, “CAMERA_PUSH_OUT”, “AUTO_EFFECTS”, “AUTO_REVERSE”
​
prompt
string
Description textuelle pour guider le style visuel de l’animation. Utilisé uniquement si l’option n’est pas “AUTO_EFFECTS” ou “AUTO_REVERSE”. Pour ces options automatiques, le prompt est généré automatiquement par l’IA.
​
format
string
Format d’orientation de la vidéo. Valeurs possibles: “portrait” (format 768x1280) ou toute autre valeur pour le format paysage (1280x768). Par défaut, le format paysage est utilisé.
​
webhook
string
URL du webhook pour recevoir une notification lorsque la génération est terminée

​
Réponse

​
generation_id
string
L’identifiant unique de la génération (UUID) à utiliser avec l’API de récupération
​
remaining_videos
number
Le nombre de crédits vidéos restants pour l’utilisateur
​
project_id
string
L’identifiant unique du projet (UUID)

​
Exemple de requête

curl --request POST \
--url 'https://iacrea.com/api/animation/v2/generate' \
--header 'x-api-key: VOTRE_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
  "user_id": "uuid",
  "image_urls": ["https://exemple.com/image.jpg"],
  "option": "ZOOM_OUT",
  "prompt": "Élégant salon moderne",
  "format": "portrait"
}'

​
Exemple de réponse

{
  "generation_id": "uuid",
  "remaining_videos": 10,
  "project_id": "uuid"
}

​
Types d’animations disponibles

OptionDescription
ZOOM_INEffet de zoom avant vers l’intérieur de l’image
ZOOM_OUTEffet de zoom arrière s’éloignant de l’image
PAN_RIGHTDéplacement de la caméra vers la droite
PAN_LEFTDéplacement de la caméra vers la gauche
PAN_UPDéplacement de la caméra vers le haut
PAN_DOWNDéplacement de la caméra vers le bas
CAMERA_PUSH_OUTMouvement fluide combinant zoom et déplacement
AUTO_EFFECTSGénération automatique du prompt par l’IA pour créer une animation optimale
AUTO_REVERSEGénération automatique du prompt par l’IA pour créer une animation en sens inverse

​
Récupérer une vidéo

​
POST /api/animation/v2/get

​
Paramètres de la requête

​
user_id
string
required
L’identifiant unique de l’utilisateur (UUID) que vous pouvez récupérer dans votre Espace Développeur
​
generation_id
string
required
L’identifiant unique de la génération (UUID) retourné par l’API de génération

​
Réponse

​
status
string
État de la génération: “STARTING”, “IN_PROGRESS”, “SUCCEEDED”, “FAILED”
​
urls
array
Tableau contenant les URLs des vidéos générées (présent seulement si status=“SUCCEEDED”)

​
Exemple de requête

curl --request POST \
--url 'https://iacrea.com/api/animation/v2/get' \
--header 'x-api-key: VOTRE_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
  "user_id": "uuid",
  "generation_id": "uuid"
}'

​
Exemple de réponse

{
  "status": "SUCCEEDED",
  "urls": ["https://url-de-video-generée.mp4"]
}

​
États possibles de la génération

StatusDescription
STARTINGLa génération est en cours d’initialisation
IN_PROGRESSLa vidéo est en cours de création
SUCCEEDEDLa génération est terminée avec succès
FAILEDUne erreur s’est produite lors de la génération
Note importante: En cas de statut “FAILED”, vos crédits vidéos sont automatiquement remboursés.