Estimer un run
curl --request POST \
--url https://www.qwairy.co/api/v1/brands/{brandId}/runs/estimate \
--header 'Authorization: <authorization>' \
--header 'Content-Type: application/json' \
--data '
{
"promptIds": [
"<string>"
],
"modelIds": [
"<string>"
]
}
'import requests
url = "https://www.qwairy.co/api/v1/brands/{brandId}/runs/estimate"
payload = {
"promptIds": ["<string>"],
"modelIds": ["<string>"]
}
headers = {
"Authorization": "<authorization>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: '<authorization>', 'Content-Type': 'application/json'},
body: JSON.stringify({promptIds: ['<string>'], modelIds: ['<string>']})
};
fetch('https://www.qwairy.co/api/v1/brands/{brandId}/runs/estimate', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));Configurer les données
Estimer un run
Estimez les cibles utilisables et le coût en crédits d’un run pour un workspace live, sans le lancer, réserver de crédits ni envoyer d’Idempotency-Key.
POST
https://www.qwairy.co
/
api
/
v1
/
brands
/
{brandId}
/
runs
/
estimate
Estimer un run
curl --request POST \
--url https://www.qwairy.co/api/v1/brands/{brandId}/runs/estimate \
--header 'Authorization: <authorization>' \
--header 'Content-Type: application/json' \
--data '
{
"promptIds": [
"<string>"
],
"modelIds": [
"<string>"
]
}
'import requests
url = "https://www.qwairy.co/api/v1/brands/{brandId}/runs/estimate"
payload = {
"promptIds": ["<string>"],
"modelIds": ["<string>"]
}
headers = {
"Authorization": "<authorization>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: '<authorization>', 'Content-Type': 'application/json'},
body: JSON.stringify({promptIds: ['<string>'], modelIds: ['<string>']})
};
fetch('https://www.qwairy.co/api/v1/brands/{brandId}/runs/estimate', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));Estime un run pour un workspace
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.
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.
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.
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
Renvoie200 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 :
| Champ | Signification |
|---|---|
promptCount, modelCount, answerCount | Nombre de cibles utilisables |
estimatedCredits | Coût total des combinaisons prompt/modèle utilisables |
availableCredits | Solde observé au moment de l’estimation |
sufficientCredits | Indique si ce solde couvre le coût estimé |
unsupportedModels | Codes demandés exclus car inconnus, désactivés, indisponibles ou non pris en charge dans le pays du workspace |
Requête et réponse synthétiques
curl -X POST "https://www.qwairy.co/api/v1/brands/$BRAND_ID/runs/estimate" \
-H "Authorization: Bearer $QWAIRY_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{}'
{
"estimate": {
"promptCount": 12,
"modelCount": 2,
"answerCount": 24,
"estimatedCredits": 48,
"availableCredits": 1200,
"sufficientCredits": true,
"unsupportedModels": []
}
}
Erreurs
Des cibles invalides ou trop nombreuses renvoient400 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.
