Passer au contenu principal
POST
Estimer un run
Estime un run pour un workspace LIVE. Il ne réserve ni ne dépense de crédits et n’exige aucun Idempotency-Key. L’endpoint exige tout de même une offre avec écriture et consomme le budget de limite de débit en écriture. 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
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.

Réponse

Renvoie 200 avec estimate. Si tous les modèles demandés sont exclus, la réponse reste 200, avec des compteurs et des crédits à zéro et les codes exclus dans unsupportedModels : Une estimation est un instantané. Lancer le run revalide les cibles et réserve les crédits ; son résultat peut différer si la disponibilité ou le solde change.

Requête et réponse synthétiques

Erreurs

Des cibles invalides ou trop nombreuses renvoient 400 INVALID_REQUEST ; des ressources inaccessibles renvoient 404 RESOURCE_NOT_FOUND. Un workspace non live, une sélection de prompts vide ou l’absence de modèle utilisable renvoie 409 CONFLICT. 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.