> ## 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 Vidéo - Régénération de séquence

> Régénérer une séquence spécifique d'une vidéo

# API Vidéo - Régénération de séquence

Régénère une séquence spécifique d'une vidéo existante. Utile pour corriger une séquence en erreur ou changer l'animation d'une séquence particulière.

<ParamField path="POST /api/video-editor/generate/sequence/{id}" />

## Authentification

Toutes les requêtes doivent inclure l'en-tête :

* `x-api-key: VOTRE_API_KEY`

## En-têtes

<ParamField header="x-api-key" type="string" required>
  Votre clé API IACrea
</ParamField>

<ParamField header="Content-Type" type="string" required>
  Doit être `application/json`
</ParamField>

## Paramètres d'URL

<ParamField path="id" type="string" required>
  Identifiant unique de la vidéo (retourné par `POST
      /api/video-editor/generate/video`)
</ParamField>

## Corps de requête

<ParamField body="sequenceId" type="string" required>
  Identifiant de la séquence à régénérer (retrouvable dans `generatedContent` de
  la réponse de `GET /api/video-editor/generate/video/{id}`)
</ParamField>

<ParamField body="sequence" type="object">
  Paramètres optionnels pour la nouvelle génération
</ParamField>

<ParamField body="sequence.url" type="string">
  Nouvelle URL d'image à utiliser (si différente de l'originale). Optionnel.
</ParamField>

<ParamField body="sequence.effect" type="string">
  Nouveau type d'animation à utiliser. Optionnel.
</ParamField>

## Réponses

### 200 — Régénération démarrée

<ResponseField name="status" type="string">
  Statut : `"START_GENERATION"`
</ResponseField>

<ResponseField name="generationId" type="string">
  Identifiant de la nouvelle génération pour cette séquence
</ResponseField>

<ResponseField name="creditsTotal" type="number">
  Nombre de crédits vidéo restants
</ResponseField>

<ResponseField name="creditsUsed" type="number">
  Nombre de crédits utilisés
</ResponseField>

### 400 — Erreur de validation

Renvoyé si l'`id` de la vidéo ou le `sequenceId` est invalide.

### 401 — Non autorisé

Renvoyé si `x-api-key` est manquant ou invalide.

### 404 — Non trouvé

Renvoyé si la vidéo ou la séquence n'existe pas.

### 500 — Erreur serveur

Erreur interne du serveur.

## Exemple de requête

```bash theme={null}
curl --request POST \
  --url 'https://iacrea.com/api/video-editor/generate/sequence/550e8400-e29b-41d4-a716-446655440000' \
  --header 'x-api-key: VOTRE_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "sequenceId": "660e8400-e29b-41d4-a716-446655440001",
    "sequence": {
      "url": "https://exemple.com/nouvelle-image.jpg",
      "effect": "CAMERA_PUSH_OUT"
    }
  }'
```

## Exemple de réponse

```json theme={null}
{
  "status": "START_GENERATION",
  "generationId": "770e8400-e29b-41d4-a716-446655440003",
  "creditsTotal": 47,
  "creditsUsed": 3
}
```

## Notes importantes

* La régénération d'une séquence réinitialise le statut de la vidéo à `"pending"` et annule le rendu final s'il était en cours
* Vous devrez utiliser `GET /api/video-editor/generate/video/{id}` pour suivre l'avancement de la nouvelle génération
* Si vous ne fournissez pas `sequence.url` ou `sequence.effect`, les valeurs originales seront réutilisées
* La régénération consomme des crédits vidéo supplémentaires