Gerar legenda
Escreva uma legenda a partir de uma instrução, ou reescreva uma existente, respeitando o limite de caracteres da plataforma indicada.
Dois endpoints escrevem o texto das suas publicações. Ambos consomem um crédito de legenda por chamada, a não ser que tenha ligado a sua própria chave de fornecedor: nesse caso as chamadas passam pela sua chave e não custam nada.
POST /api/v1/ai/captions
POST /api/v1/ai/captions
{
"prompt": "anunciar que o nosso agendador já publica no Bluesky",
"platform": "LINKEDIN"
}| Campo | Obrigatório | Descrição |
|---|---|---|
| prompt | Sim | Sobre o que a legenda deve falar. Até 2000 caracteres |
| platform | Não | Respeita o limite dessa plataforma. Sem ele, o teto é de 2200 caracteres |
{
"caption": "O Bluesky entrou na lista. Mesma fila, mesmo agendamento, mais um sítio onde as suas publicações aterram."
}platform aceita TWITTER, BLUESKY, THREADS, PINTEREST, INSTAGRAM, TIKTOK, LINKEDIN, YOUTUBE e FACEBOOK. Indicá-lo faz diferença: uma legenda escrita para o LinkedIn vai até 3000 caracteres, a mesma instrução para o X para nos 280.
POST /api/v1/ai/captions/refine
POST /api/v1/ai/captions/refine
{
"prompt": "corta para metade e tira os pontos de exclamação",
"originalText": "O Bluesky entrou na lista! Mesma fila, mesmo agendamento!",
"platform": "BLUESKY"
}| Campo | Obrigatório | Descrição |
|---|---|---|
| prompt | Sim | Como a legenda deve mudar |
| originalText | Sim | A legenda a reescrever. Até 10000 caracteres |
| platform | Não | A mesma lista acima |
| partialText | Não | Uma legenda começada para continuar, em vez de reescrever |
A resposta tem a mesma forma da geração.
{
"caption": "O Bluesky entrou na lista. Mesma fila, mesmo agendamento."
}Envie partialText quando alguém começou a escrever e quer que o resto seja redigido. Deixe-o de fora quando quiser reescrever tudo.
Erros
Um 402 significa que o espaço de trabalho ficou sem créditos de legenda. Ligue a sua própria chave da OpenAI ou da Anthropic no painel e as chamadas deixam de consumir créditos.
Ambos os endpoints contam para o mesmo limite de pedidos por chave que o resto da API, e cada resposta traz RateLimit-Remaining para poder marcar o ritmo de um lote sem chegar a um 429.