Authentification
Authentifiez les requêtes et comprenez le comportement des crédits.
Clés API
Envoyez la clé API du workspace comme bearer token.
Authorization: Bearer vt_live_...
Les clés sont liées à une organisation avec un plan payant actif.
Headers
Authorization: Bearer vt_live_...
Content-Type: application/json
Idempotency-Key: optional-retry-key
Utilisez Idempotency-Key pour les retries de générations payantes.
Crédits
Les crédits sont calculés avec les mêmes règles côté serveur que dans l'app.
Les endpoints payants débitent les crédits avant la mise en file.
Si le workspace n'a pas assez de crédits, l'API retourne 402 insufficient_credits et aucun job n'est créé.
Si la file échoue après un débit, les crédits sont remboursés avant la réponse d'erreur.
Scopes
Utilisez les scopes de lecture pour catalogue, assets, statut et lectures éditeur.
Utilisez les scopes d'écriture pour génération, uploads, création de références et modifications éditeur.