Exécutions
Une exécution est une seule demande de génération. Lorsque vous appelez l'API, Runbase crée une exécution, l'envoie au modèle d'IA sous-jacent et renvoie le résultat lorsqu'il est prêt.
Chaque exécution suit un cycle de vie :
POST /api/v1/runs → pending → processing → succeeded (or failed)
Statuts des exécutions
| Statut | Signification |
|---|---|
pending | En file d'attente, en attente qu'un worker la prenne en charge |
processing | Génération en cours chez le fournisseur d'IA |
succeeded | Génération terminée — output.urls contient le résultat |
failed | Échec de la génération — error décrit ce qui a mal tourné |
Asynchrone par conception
Toute génération est asynchrone. Lorsque vous créez une exécution, l'API répond immédiatement avec status: "pending" et un identifiant d'exécution. Vous interrogez ensuite GET /api/v1/runs/:id jusqu'à ce que le statut soit succeeded ou failed.
Le délai de traitement varie selon le modèle, la charge du fournisseur et la complexité de l'entrée :
- Les modèles d'image se terminent généralement plus vite que les modèles vidéo
- Les modèles vidéo dépendent fortement de la durée, de la résolution et du temps de file d'attente du fournisseur
Coût et remboursements
Le coût est débité de votre balance lorsque l'exécution est créée, et non lorsqu'elle se termine. Cela réserve les fonds à l'avance.
Si l'exécution échoue, le coût total est automatiquement remboursé sur votre balance. Vous ne payez jamais pour les générations échouées.
Modèles
Runbase est une passerelle unifiée vers des modèles provenant de plusieurs fournisseurs. Chaque modèle a un identifiant unique au format provider/model-name (par exemple, openai/gpt-image-2, bytedance/seedance-2).
Tous les modèles partagent la même API à deux endpoints :
POST /api/v1/runs— créer une exécution avec un identifiant de modèle et une entréeGET /api/v1/runs/:id— vérifier le statut et récupérer les résultats
Le schéma d'entrée varie selon le modèle (différents paramètres pour le prompt, la taille, la qualité, image_urls, etc.), mais l'enveloppe de requête/réponse est toujours la même.
Authentification
Chaque requête API nécessite une clé API dans l'en-tête Authorization sous forme de Bearer token. Les clés commencent par sk- et peuvent être créées dans le tableau de bord. Voir Authentification pour plus de détails.
Balance
Runbase utilise une balance prépayée. Vous rechargez votre balance, et chaque exécution y est débitée en fonction du prix du modèle. Voir Facturation pour plus de détails.