Generar descripción
Escriba una descripción a partir de una instrucción, o reescriba una que ya tenga, ajustada al límite de caracteres de la plataforma que indique.
Dos endpoints escriben el texto de sus publicaciones. Ambos consumen un crédito de descripción por llamada, salvo que haya conectado su propia clave de proveedor: en ese caso las llamadas pasan por su clave y no cuestan nada.
POST /api/v1/ai/captions
POST /api/v1/ai/captions
{
"prompt": "anunciar que nuestro planificador ya publica en Bluesky",
"platform": "LINKEDIN"
}| Campo | Obligatorio | Descripción |
|---|---|---|
| prompt | Sí | De qué debe hablar la descripción. Hasta 2000 caracteres |
| platform | No | Ajusta la descripción al límite de esa plataforma. Sin él, el tope es de 2200 caracteres |
{
"caption": "Bluesky se suma a la lista. Misma cola, mismo calendario, un sitio más donde aterrizan sus publicaciones."
}platform acepta TWITTER, BLUESKY, THREADS, PINTEREST, INSTAGRAM, TIKTOK, LINKEDIN, YOUTUBE y FACEBOOK. Indicarlo importa: una descripción escrita para LinkedIn llega a 3000 caracteres, la misma instrucción para X se corta en 280.
POST /api/v1/ai/captions/refine
POST /api/v1/ai/captions/refine
{
"prompt": "recórtalo a la mitad y quita los signos de exclamación",
"originalText": "¡Bluesky se suma a la lista! ¡Misma cola, mismo calendario!",
"platform": "BLUESKY"
}| Campo | Obligatorio | Descripción |
|---|---|---|
| prompt | Sí | Cómo debe cambiar la descripción |
| originalText | Sí | La descripción que se reescribe. Hasta 10000 caracteres |
| platform | No | La misma lista de arriba |
| partialText | No | Una descripción a medias para continuar, en lugar de reescribir |
La respuesta tiene la misma forma que la generación.
{
"caption": "Bluesky se suma a la lista. Misma cola, mismo calendario."
}Envíe partialText cuando alguien haya empezado a escribir y quiera que le redacten el resto. Omítalo cuando quiera reescribir todo.
Errores
Un 402 significa que el espacio de trabajo se quedó sin créditos de descripción. Conecte su propia clave de OpenAI o Anthropic en el panel y las llamadas dejarán de consumir créditos.
Ambos endpoints cuentan para el mismo límite de peticiones por clave que el resto de la API, y cada respuesta incluye RateLimit-Remaining para poder marcar el ritmo de un lote sin llegar a un 429.