Ceci est une traduction fournie par commodité. La référence technique faisant autorité est la version anglaise ; en cas de divergence, le texte anglais prévaut.
Authentification
Chaque requête nécessite une clé d'API, envoyée dans l'un ou l'autre en-tête :
Créez une clé depuis le panneau Clés d'API de votre tableau de bord. La clé en clair est affichée exactement une fois, à la création — si vous la perdez, révoquez-la et générez-en une nouvelle. Vous pouvez avoir jusqu'à 10 clés actives à la fois ; toutes partagent un seul solde de crédits.
Crédits et tarifs
Chaque fichier coûte 1 crédit par seconde de durée traitée, 3 crédits minimum — un clip de 2 secondes coûte quand même le plancher de 3 crédits, un clip de 10 secondes coûte 10. Les crédits sont déduits lors de la soumission du travail (avant le début du traitement), en fonction de la durée du fichier lui-même, et non d'un tarif forfaitaire par fichier. Une requête par lot facture chaque fichier du lot d'avance — si votre solde ne couvre pas le lot entier, rien n'y est créé. Si un fichier s'avère illisible, le crédit de ce fichier est remboursé automatiquement.
| Forfait | Crédits | Prix |
|---|---|---|
| Pack de crédits — Micro | 15 (n'expirent jamais) | $1.99 |
| Pack de crédits — Light | 150 (n'expirent jamais) | $9.99 |
| Pack de crédits — Heavy | 900 (n'expirent jamais) | $39.99 |
| Plus Trimestriel | 2 700 / trimestre | 79,99 $/trim |
| Pro Mensuel | 3 000 / mois | 79,99 $/mois |
| Pro Annuel | 36 000 / an | 799,99 $/an |
Les crédits résident sur votre compte, pas sur une clé individuelle — chaque clé que vous créez puise dans le même pool. Vérifiez votre solde à tout moment avec GET /api/account (authentification par session du tableau de bord, pas par clé d'API).
Soumettre un fichier — POST /api/v1/jobs
Données de formulaire multipart :
| Champ | Valeurs | Notes |
|---|---|---|
file | requis | .gif, .mp4, .mov, .webm |
method | auto (par défaut) · fast · rembg | fast utilise le remplissage par diffusion au lieu de la segmentation par IA — plus rapide, fonctionne mieux sur les arrière-plans de couleur unie |
tolerance | 8–32 (par défaut 16) | utilisé uniquement par method=fast |
crop | true (par défaut) · false | rognage automatique sur la boîte englobante du sujet |
pad | 0–50 px (par défaut 12) | marge conservée autour du rognage |
canvasW / canvasH | px | taille du canevas de sortie ; omettre pour conserver la taille d'origine |
anchor | center (par défaut) · bottom | placement du sujet lors de la mise à l'échelle sur un canevas |
outputFormat | gif (par défaut) · apng · webm · mp4 | voir la note ci-dessous sur mp4 |
bgColor | transparent (par défaut) · #rrggbb | requis pour mp4 |
trim | true · false (par défaut) | rogne automatiquement les images inactives de début/fin — sources GIF uniquement |
La sortie mp4 n'a pas de canal alpha, elle n'a donc de sens qu'avec un bgColor uni — demander mp4 avec un arrière-plan transparent revient automatiquement à gif.
Réponse 202 :
Interroger le statut — GET /api/v1/jobs/:id
previewUrl apparaît dès qu'un aperçu est disponible ; downloadUrl uniquement lorsque status est done. Un travail n'est visible que pour la clé d'API qui l'a créé — toute autre clé obtient un 404.
Aperçu et téléchargement
GET /api/v1/jobs/:id/preview et GET /api/v1/jobs/:id/download diffusent le fichier directement, authentifiés de la même manière que tout autre appel — pas de jeton de téléchargement distinct.
Lots — POST /api/v1/batches
Les mêmes champs que POST /api/v1/jobs, mais répétez le champ file une fois par fichier (jusqu'à 20 fichiers par requête). Un seul jeu d'options s'applique à chaque fichier du lot.
GET /api/v1/batches/:id renvoie { "id", "status": "processing | partial | done", "jobs": [...] } avec chaque entrée dans le même format que GET /api/v1/jobs/:id.
Erreurs
| Statut | Corps | Signification |
|---|---|---|
401 | { "error": "unauthorized" } | clé d'API manquante, invalide ou révoquée |
402 | { "error": "insufficient_credits", "creditsRemaining" } | crédits insuffisants — aucun travail n'a été créé |
400 | { "error": "bad_request" } | aucun fichier valide, ou corps multipart mal formé |
422 | { "error": "unreadable_file" } | impossible d'analyser le fichier — aucun crédit facturé |
404 | { "error": "not_found" } | le travail/lot n'existe pas, ou appartient à une autre clé |
429 | { "error": "rate_limited" } | trop de requêtes — voir l'en-tête Retry-After |
Limites de débit
Les requêtes sont limitées en débit par clé d'API. Si vous êtes limité, la réponse inclut un en-tête Retry-After (secondes) — attendez ce délai avant de réessayer. Besoin d'une limite plus élevée pour une intégration en production ? contactez-nous depuis votre tableau de bord.