Passer au contenu principal
POST
Lancer un run
Crée un run pour un workspace LIVE et réserve le coût en crédits prévu. Estimez le run d’abord pour examiner les cibles utilisables et le coût. La création du run revalide les deux. Nécessite une offre Business, Agency Business ou Enterprise active. Utilisez un jeton d’API dont l’accès en écriture est activé. Consultez Écrire des données pour l’idempotence, les requêtes conditionnelles et la gestion des erreurs.
string
requis
Jeton bearer de votre équipe.
string
requis
Clé unique pour cette opération. Les réponses terminées sont rejouées pendant 24 heures.
string
requis
Identifiant du workspace. Le workspace doit appartenir à l’équipe du jeton.
string[]
Jusqu’à 50 UUID de prompts actifs. Omettez-le pour sélectionner tous les prompts actifs. Si cela dépasse 50, sélectionnez explicitement un ensemble plus petit.
string[]
Jusqu’à 20 codes de modèles Qwairy. Omettez-le ou envoyez [] pour utiliser les modèles de suivi sélectionnés du workspace ; les prompts qui ont leurs propres modèles les gardent. Les modèles premium exigent une offre qui les inclut, et les sélections premium enregistrées que votre offre n’inclut plus sont ignorées, comme dans le dashboard.

Réponse

Renvoie 202 Accepted avec un en-tête Location pointant vers Obtenir un run, ainsi que : La génération est asynchrone. La combinaison prompt/modèle utilisable est planifiée de façon atomique ; un solde insuffisant ou une modification simultanée des cibles rejette la requête.

Requête et réponse synthétiques

Suivre l’avancement

Obtenir un run renvoie les détails de la planification. Lister les runs inclut le statut global, le décompte des résultats et l’avancement. Il n’existe pas d’endpoint public d’annulation, de nouvelle tentative ou de remboursement.

Erreurs

Consultez Codes d’erreur pour les erreurs d’authentification, d’offre, d’idempotence et de serveur. Sur 429, respectez Retry-After ; les écritures peuvent renvoyer 503 SERVICE_UNAVAILABLE si le limiteur d’écriture est indisponible.