> ## Documentation Index
> Fetch the complete documentation index at: https://docs.iacrea.com/llms.txt
> Use this file to discover all available pages before exploring further.

# API Création de Vidéos

> Documentation de l'API pour le service de création de vidéos

# 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

<ParamField path="POST /api/animation/v2/generate" />

### Paramètres de la requête

<ParamField body="user_id" type="string" required>
  L'identifiant unique de l'utilisateur (UUID) que vous pouvez récupérer dans votre Espace Développeur
</ParamField>

<ParamField body="image_urls" type="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.
</ParamField>

<ParamField body="option" type="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"
</ParamField>

<ParamField body="prompt" type="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.
</ParamField>

<ParamField body="format" type="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é.
</ParamField>

<ParamField body="webhook" type="string">
  URL du webhook pour recevoir une notification lorsque la génération est terminée
</ParamField>

### Réponse

<ResponseField name="generation_id" type="string">
  L'identifiant unique de la génération (UUID) à utiliser avec l'API de récupération
</ResponseField>

<ResponseField name="remaining_videos" type="number">
  Le nombre de crédits vidéos restants pour l'utilisateur
</ResponseField>

<ResponseField name="project_id" type="string">
  L'identifiant unique du projet (UUID)
</ResponseField>

### Exemple de requête

```bash theme={null}
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

```json theme={null}
{
  "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

<ParamField path="POST /api/animation/v2/get" />

### Paramètres de la requête

<ParamField body="user_id" type="string" required>
  L'identifiant unique de l'utilisateur (UUID) que vous pouvez récupérer dans votre Espace Développeur
</ParamField>

<ParamField body="generation_id" type="string" required>
  L'identifiant unique de la génération (UUID) retourné par l'API de génération
</ParamField>

### Réponse

<ResponseField name="status" type="string">
  État de la génération: "STARTING", "IN\_PROGRESS", "SUCCEEDED", "FAILED"
</ResponseField>

<ResponseField name="urls" type="array">
  Tableau contenant les URLs des vidéos générées (présent seulement si status="SUCCEEDED")
</ResponseField>

### Exemple de requête

```bash theme={null}
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

```json theme={null}
{
  "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.