Passer au contenu principal
POST
Générer des suggestions de prompts
Lance une génération de Prompt Studio. La requête 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.
string
requis
Jeton bearer de votre équipe.
string
requis
Clé unique pour cette opération, 255 caractères au maximum. Les réponses terminées sont rejouées pendant 24 heures.
string
requis
Identifiant du workspace. Le workspace doit appartenir à l’équipe du jeton.
string
défaut:"manual"
manual pour tout le workspace, ou topic pour un seul Topic.
string
Identifiant du Topic. Obligatoire lorsque source vaut topic.
boolean
défaut:"false"
Ajoute des suggestions au lot actuel au lieu de repartir de zéro.

Réponse

Renvoie 202 avec la génération.
string
Identifiant de la génération
string
PENDING, RUNNING, COMPLETED ou FAILED
string
manual, onboarding, topic ou profile
string | null
Topic ciblé par la génération, lorsque source vaut topic
integer | null
Nombre de suggestions recommandées, une fois connu
string
Date de création au format ISO 8601
string | null
Date de fin au format ISO 8601, ou null tant que la génération est en cours

Requête et réponse synthétiques

Erreurs

Consultez Codes d’erreur pour les erreurs d’authentification, d’offre, d’idempotence et de serveur. Un jeton sans accès en écriture renvoie 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.