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

requis

L’identifiant unique de l’utilisateur (UUID) que vous pouvez récupérer dans votre Espace Développeur

image_urls

array

requis

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

requis

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

Option	Description
ZOOM_IN	Effet de zoom avant vers l’intérieur de l’image
ZOOM_OUT	Effet de zoom arrière s’éloignant de l’image
PAN_RIGHT	Déplacement de la caméra vers la droite
PAN_LEFT	Déplacement de la caméra vers la gauche
PAN_UP	Déplacement de la caméra vers le haut
PAN_DOWN	Déplacement de la caméra vers le bas
CAMERA_PUSH_OUT	Mouvement fluide combinant zoom et déplacement
AUTO_EFFECTS	Génération automatique du prompt par l’IA pour créer une animation optimale
AUTO_REVERSE	Gé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

requis

L’identifiant unique de l’utilisateur (UUID) que vous pouvez récupérer dans votre Espace Développeur

generation_id

string

requis

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

Status	Description
STARTING	La génération est en cours d’initialisation
IN_PROGRESS	La vidéo est en cours de création
SUCCEEDED	La génération est terminée avec succès
FAILED	Une 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.

Documentation API

Endpoints

API Création de Vidéos

API Création de Vidéos

Générer une vidéo

Paramètres de la requête

Réponse

Exemple de requête

Exemple de réponse

Types d’animations disponibles

Récupérer une vidéo

Paramètres de la requête

Réponse

Exemple de requête

Exemple de réponse

États possibles de la génération

​API Création de Vidéos

​Générer une vidéo

​Paramètres de la requête

​Réponse

​Exemple de requête

​Exemple de réponse

​Types d’animations disponibles

​Récupérer une vidéo

​Paramètres de la requête

​Réponse

​Exemple de requête

​Exemple de réponse

​États possibles de la génération

API Création de Vidéos

Générer une vidéo

Paramètres de la requête

Réponse

Exemple de requête

Exemple de réponse

Types d’animations disponibles

Récupérer une vidéo

Paramètres de la requête

Réponse

Exemple de requête

Exemple de réponse

États possibles de la génération