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.