> ## Documentation Index
> Fetch the complete documentation index at: https://docs.qwairy.co/llms.txt
> Use this file to discover all available pages before exploring further.

# 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.

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](https://docs.qwairy.co/fr/developers/writing-data.md) pour l’idempotence, les requêtes conditionnelles et la gestion des erreurs.

**Authorization** `string` *required*

Jeton bearer de votre équipe.

**brandId** `string` *required*

Identifiant du workspace. Le workspace doit appartenir à l’équipe du jeton.

**promptIds** `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.

**modelIds** `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` :

| 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 |

Une estimation est un instantané. [Lancer le run](https://docs.qwairy.co/fr/developers/endpoints/runs/manage.md) 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

```bash theme={null}
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 '{}'
```

```json theme={null}
{
  "estimate": {
    "promptCount": 12,
    "modelCount": 2,
    "answerCount": 24,
    "estimatedCredits": 48,
    "availableCredits": 1200,
    "sufficientCredits": true,
    "unsupportedModels": []
  }
}
```

## 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](https://docs.qwairy.co/fr/developers/errors.md) 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.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.