Générer des suggestions de prompts
curl --request POST \
--url https://www.qwairy.co/api/v1/brands/{brandId}/prompt-suggestions/runs \
--header 'Authorization: <authorization>' \
--header 'Content-Type: application/json' \
--header 'Idempotency-Key: <idempotency-key>' \
--data '
{
"source": "<string>",
"keywordId": "<string>",
"refill": true
}
'import requests
url = "https://www.qwairy.co/api/v1/brands/{brandId}/prompt-suggestions/runs"
payload = {
"source": "<string>",
"keywordId": "<string>",
"refill": True
}
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({source: '<string>', keywordId: '<string>', refill: true})
};
fetch('https://www.qwairy.co/api/v1/brands/{brandId}/prompt-suggestions/runs', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"id": "<string>",
"status": "<string>",
"source": "<string>",
"keywordId": {},
"recommendations": {},
"createdAt": "<string>",
"completedAt": {}
}Suggestions de prompts
Générer des suggestions de prompts
Lancez une génération Prompt Studio pour un workspace ou un Topic. Elle ne consomme aucun crédit client, renvoie 202 et est limitée par workspace sur 24 heures.
POST
https://www.qwairy.co
/
api
/
v1
/
brands
/
{brandId}
/
prompt-suggestions
/
runs
Générer des suggestions de prompts
curl --request POST \
--url https://www.qwairy.co/api/v1/brands/{brandId}/prompt-suggestions/runs \
--header 'Authorization: <authorization>' \
--header 'Content-Type: application/json' \
--header 'Idempotency-Key: <idempotency-key>' \
--data '
{
"source": "<string>",
"keywordId": "<string>",
"refill": true
}
'import requests
url = "https://www.qwairy.co/api/v1/brands/{brandId}/prompt-suggestions/runs"
payload = {
"source": "<string>",
"keywordId": "<string>",
"refill": True
}
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({source: '<string>', keywordId: '<string>', refill: true})
};
fetch('https://www.qwairy.co/api/v1/brands/{brandId}/prompt-suggestions/runs', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"id": "<string>",
"status": "<string>",
"source": "<string>",
"keywordId": {},
"recommendations": {},
"createdAt": "<string>",
"completedAt": {}
}Lance une génération de Prompt Studio. La requête renvoie
Consultez Codes d’erreur pour les erreurs d’authentification, d’offre, d’idempotence et de serveur. Un jeton sans accès en écriture renvoie
202 avec la génération et un en-tête Location. Interrogez Obtenir une génération de suggestions, ou abonnez un webhook d’intégration à prompt_suggestions.ready et prompt_suggestions.failed.
La génération ne consomme aucun crédit client. Elle est limitée à 3 générations de workspace et 10 générations de Topic par workspace sur 24 heures glissantes. Une génération de workspace et une génération par Topic peuvent être en cours simultanément. Une requête portant sur le même périmètre déjà en cours renvoie 409 RESOURCE_BUSY.
Nécessite une offre Business, Agency Business ou Enterprise active, et un jeton d’API dont l’accès en écriture a été activé par un Propriétaire ou un Manager. Consultez Écrire des données pour l’activation, l’idempotence, les requêtes conditionnelles et la gestion des erreurs.
Clé unique pour cette opération, 255 caractères au maximum. Les réponses terminées sont rejouées pendant 24 heures.
Réponse
Renvoie202 avec la génération.
Requête et réponse synthétiques
curl -X POST "https://www.qwairy.co/api/v1/brands/$BRAND_ID/prompt-suggestions/runs" \
-H "Authorization: Bearer $QWAIRY_API_TOKEN" \
-H "Idempotency-Key: suggestions-001" \
-H "Content-Type: application/json" \
-d '{"source":"manual"}'
{
"id": "bbbbbbbb-0000-4000-8000-000000000000",
"status": "PENDING",
"source": "manual",
"keywordId": null,
"recommendations": null,
"createdAt": "2026-10-12T09:00:00.000Z",
"completedAt": null
}
Erreurs
| Statut | Code | Cause |
|---|---|---|
400 | INVALID_REQUEST | keywordId est absent avec source: topic, ou une valeur est invalide |
404 | RESOURCE_NOT_FOUND | Le workspace ou le Topic est absent ou inaccessible |
409 | RESOURCE_BUSY | Une génération est en cours pour ce périmètre ; error.details.suggestionRunId l’identifie |
409 | QUOTA_EXCEEDED | Le quota glissant est épuisé ; error.details.resetsAt indique sa réinitialisation lorsqu’elle est connue |
409 | CONFLICT | Un Topic nécessite un lot existant, ou aucun Topic suivi n’a besoin de nouvelles suggestions |
403 API_KEY_READ_ONLY. Sur 429, respectez Retry-After. Si le limiteur d’écriture est indisponible ou si les écritures sont suspendues, la requête renvoie 503 SERVICE_UNAVAILABLE et rien ne change.
