Passer au contenu principal

​
POST Generate New Sequence

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.
​
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

​
x-api-key
string
requis
Votre clé API IACrea
​
Content-Type
string
requis
Doit être application/json

​
Paramètres d’URL

​
id
string
requis
Identifiant unique de la vidéo (retourné par POST /api/video-editor/generate/video)

​
Corps de requête

​
sequenceId
string
requis
Identifiant de la séquence à régénérer (retrouvable dans generatedContent de la réponse de GET /api/video-editor/generate/video/{id})
​
sequence
object
Paramètres optionnels pour la nouvelle génération
​
sequence.url
string
Nouvelle URL d’image à utiliser (si différente de l’originale). Optionnel.
​
sequence.effect
string
Nouveau type d’animation à utiliser. Optionnel.

​
Réponses

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

​
status
string
Statut : "START_GENERATION"
​
generationId
string
Identifiant de la nouvelle génération pour cette séquence
​
creditsTotal
number
Nombre de crédits vidéo restants
​
creditsUsed
number
Nombre de crédits utilisés

​
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

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

{
  "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