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

# Lancer un run

> Lancez un run pour un workspace live, réservez les crédits prévus et démarrez la collecte asynchrone des réponses. Estimez d’abord le run pour voir son coût.

Crée un run pour un workspace `LIVE` et réserve le coût en crédits prévu. [Estimez le run](https://docs.qwairy.co/fr/developers/endpoints/runs/estimate.md) 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](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.

**Idempotency-Key** `string` *required*

Clé unique pour cette opération. Les réponses terminées sont rejouées pendant 24 heures.

**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 ; 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](https://docs.qwairy.co/fr/developers/endpoints/runs/get.md), ainsi que :

| Champ du run | Signification |
| - | - |
| `runId` | L’identifiant du run qui vient d’être créé |
| `promptCount`, `modelCount` | Dimensions des cibles utilisables |
| `unsupportedModels` | Codes de modèles demandés exclus du run |

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

```bash theme={null}
curl -i -X POST "https://www.qwairy.co/api/v1/brands/$BRAND_ID/runs" \
  -H "Authorization: Bearer $QWAIRY_API_TOKEN" \
  -H "Idempotency-Key: weekly-run-2026-09-01" \
  -H "Content-Type: application/json" \
  -d '{}'
```

```json theme={null}
{
  "run":{
    "runId":"55555555-0000-4000-8000-000000000000",
    "promptCount":12,
    "modelCount":2,
    "unsupportedModels":[]
  }
}
```

## Suivre l’avancement

[Obtenir un run](https://docs.qwairy.co/fr/developers/endpoints/runs/get.md) renvoie les détails de la planification. [Lister les runs](https://docs.qwairy.co/fr/developers/endpoints/runs/list.md) 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

| Statut | Code | Cause |
| - | - | - |
| 400 | `INVALID_REQUEST` | Cibles invalides ou plus de 50 prompts sélectionnés |
| 403 | `INSUFFICIENT_PLAN` | Un modèle demandé est un modèle premium non inclus dans votre offre |
| 404 | `RESOURCE_NOT_FOUND` | Workspace ou prompt demandé inaccessible |
| 409 | `CONFLICT` | Le workspace n’est pas live, aucune cible n’est utilisable, ou une cible a changé pendant la planification |
| 409 | `INSUFFICIENT_CREDITS` | Le run complet ne peut pas être financé |
| 409 | `IDEMPOTENCY_CONFLICT` | La même clé a été utilisée avec une requête différente |

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.