Générer une légende
Rédigez une légende à partir d'une consigne, ou réécrivez-en une existante, en respectant la limite de caractères de la plateforme indiquée.
Deux endpoints rédigent le texte de vos publications. Chaque appel consomme un crédit de légende, sauf si vous avez connecté votre propre clé de fournisseur : les appels passent alors par votre clé et ne coûtent rien.
POST /api/v1/ai/captions
POST /api/v1/ai/captions
{
"prompt": "annoncer que notre planificateur publie maintenant sur Bluesky",
"platform": "LINKEDIN"
}| Champ | Requis | Description |
|---|---|---|
| prompt | Oui | Ce que la légende doit dire. Jusqu'à 2000 caractères |
| platform | Non | Respecte la limite de cette plateforme. Sans elle, le plafond est de 2200 caractères |
{
"caption": "Bluesky rejoint la liste. Même file, même planning, un endroit de plus où vos publications atterrissent."
}platform accepte TWITTER, BLUESKY, THREADS, PINTEREST, INSTAGRAM, TIKTOK, LINKEDIN, YOUTUBE et FACEBOOK. Le préciser compte : une légende écrite pour LinkedIn va jusqu'à 3000 caractères, la même consigne pour X s'arrête à 280.
POST /api/v1/ai/captions/refine
POST /api/v1/ai/captions/refine
{
"prompt": "réduis de moitié et enlève les points d'exclamation",
"originalText": "Bluesky rejoint la liste ! Même file, même planning !",
"platform": "BLUESKY"
}| Champ | Requis | Description |
|---|---|---|
| prompt | Oui | Comment la légende doit changer |
| originalText | Oui | La légende à réécrire. Jusqu'à 10000 caractères |
| platform | Non | Même liste que ci-dessus |
| partialText | Non | Une légende commencée à poursuivre, plutôt qu'à réécrire |
La réponse a la même forme que pour la génération.
{
"caption": "Bluesky rejoint la liste. Même file, même planning."
}Envoyez partialText quand quelqu'un a commencé à écrire et veut que la suite soit rédigée. Omettez-le pour faire réécrire l'ensemble.
Erreurs
Un 402 signifie que l'espace de travail n'a plus de crédits de légende. Connectez votre propre clé OpenAI ou Anthropic dans le tableau de bord et les appels cessent de consommer des crédits.
Les deux endpoints comptent dans la même limite de débit par clé que le reste de l'API, et chaque réponse porte RateLimit-Remaining pour cadencer un lot sans déclencher de 429.