Lancer un run
curl --request POST \
--url https://www.qwairy.co/api/v1/brands/{brandId}/runs \
--header 'Authorization: <authorization>' \
--header 'Content-Type: application/json' \
--header 'Idempotency-Key: <idempotency-key>' \
--data '
{
"promptIds": [
"<string>"
],
"modelIds": [
"<string>"
]
}
'import requests
url = "https://www.qwairy.co/api/v1/brands/{brandId}/runs"
payload = {
"promptIds": ["<string>"],
"modelIds": ["<string>"]
}
headers = {
"Authorization": "<authorization>",
"Idempotency-Key": "<idempotency-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {
Authorization: '<authorization>',
'Idempotency-Key': '<idempotency-key>',
'Content-Type': 'application/json'
},
body: JSON.stringify({promptIds: ['<string>'], modelIds: ['<string>']})
};
fetch('https://www.qwairy.co/api/v1/brands/{brandId}/runs', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));Configurer les données
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.
POST
https://www.qwairy.co
/
api
/
v1
/
brands
/
{brandId}
/
runs
Lancer un run
curl --request POST \
--url https://www.qwairy.co/api/v1/brands/{brandId}/runs \
--header 'Authorization: <authorization>' \
--header 'Content-Type: application/json' \
--header 'Idempotency-Key: <idempotency-key>' \
--data '
{
"promptIds": [
"<string>"
],
"modelIds": [
"<string>"
]
}
'import requests
url = "https://www.qwairy.co/api/v1/brands/{brandId}/runs"
payload = {
"promptIds": ["<string>"],
"modelIds": ["<string>"]
}
headers = {
"Authorization": "<authorization>",
"Idempotency-Key": "<idempotency-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {
Authorization: '<authorization>',
'Idempotency-Key': '<idempotency-key>',
'Content-Type': 'application/json'
},
body: JSON.stringify({promptIds: ['<string>'], modelIds: ['<string>']})
};
fetch('https://www.qwairy.co/api/v1/brands/{brandId}/runs', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));Crée un run pour un workspace
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.
Consultez Codes d’erreur pour les erreurs d’authentification, d’offre, d’idempotence et de serveur. Sur
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.
Clé unique pour cette opération. Les réponses terminées sont rejouées pendant 24 heures.
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 ; 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
Renvoie202 Accepted avec un en-tête Location pointant vers Obtenir un run, 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 |
Requête et réponse synthétiques
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 '{}'
{
"run":{
"runId":"55555555-0000-4000-8000-000000000000",
"promptCount":12,
"modelCount":2,
"unsupportedModels":[]
}
}
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
| 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 |
429, respectez Retry-After ; les écritures peuvent renvoyer 503 SERVICE_UNAVAILABLE si le limiteur d’écriture est indisponible.
