Generar imagen
Ponga una imagen en cola a partir de una instrucción de texto y consulte el resultado. Devuelve un identificador de trabajo al instante en lugar de mantener la conexión abierta.
Una imagen tarda entre 10 y 40 segundos, demasiado para mantener abierta una petición HTTP. Por eso la generación son dos llamadas: iniciar un trabajo y luego consultarlo.
POST /api/v1/ai/images
POST /api/v1/ai/images
{
"prompt": "una bicicleta roja apoyada en una pared amarilla, luz suave de la mañana",
"aspectRatio": "16:9",
"model": "premium"
}| Campo | Obligatorio | Descripción |
|---|---|---|
| prompt | Sí | Qué dibujar. Hasta 2000 caracteres |
| aspectRatio | No | 1:1 (por defecto), 16:9, 9:16, 3:2, 2:3, 4:5, 5:4, 21:9, 9:21 |
| model | No | standard (por defecto) o premium |
| quality | No | LOW, MEDIUM o HIGH |
| sessionId | No | Agrupa imágenes relacionadas. Sin él se crea una sesión nueva |
| referenceImages | No | Hasta 5 URL de imágenes públicas para orientar el resultado |
{
"jobId": "generate-image-8f2a1c40-6d3b-4e91-b7c2-0a5d9e13f846",
"sessionId": "b31c7a44-2f19-4c85-9d60-7e2af4c81b93",
"status": "queued"
}Guarde el sessionId y páselo en la siguiente llamada para mantener juntas un conjunto de imágenes, igual que una conversación guarda sus mensajes. Sin él, cada imagen abre su propia sesión.
GET /api/v1/ai/images/{jobId}
GET /api/v1/ai/images/generate-image-8f2a1c40-6d3b-4e91-b7c2-0a5d9e13f846
{
"jobId": "generate-image-8f2a1c40-6d3b-4e91-b7c2-0a5d9e13f846",
"sessionId": "b31c7a44-2f19-4c85-9d60-7e2af4c81b93",
"status": "completed",
"imageUrl": "https://cdn.adaptlypost.com/ai-images/ai-studio-4c81b93.png",
"imageId": "d7e44a10-93bc-4f27-8ae5-1b06c2f4d938",
"error": null
}| Estado | Significado |
|---|---|
queued | Esperando a un worker |
generating | El modelo está dibujando |
processing | Subiendo el resultado |
completed | imageUrl está lista |
failed | error dice por qué |
Consulte cada 3 o 5 segundos. Más rápido solo gasta su límite de peticiones.
imageUrl apunta al CDN y puede ir directamente en los mediaUrls de una publicación, así que generar y programar es: crear la imagen, consultar hasta completed, y luego crear una publicación con esa URL.
Créditos
Los créditos se cobran al empezar la generación y se devuelven automáticamente si falla, así que un trabajo fallido no cuesta nada. Con su propia clave de OpenAI o Google conectada, las imágenes pasan por su clave y no consumen créditos. premium y standard cuestan cantidades distintas.