# API de Z Image Referencia completa de la API para la generación de texto a imagen Z Image. ## Variantes del modelo Esta API admite una variante del modelo: | Modelo | ID | Descripción | |-------|-----|-------------| | **Z Image** | `z-image` | Generación rápida de texto a imagen | ## Comparación rápida | Función | Z Image | |---------|---------| | Entrada | Prompt de texto | | Salida | Una sola imagen generada | | Relaciones de aspecto | Varias relaciones compatibles | | Resolución | Derivada de los valores de proporción width/height | | `seed` | Opcional | ### Relaciones de aspecto compatibles El par `width:height` debe ser uno de los siguientes: `1:1`, `3:2`, `2:3`, `3:4`, `4:3`, `9:16`, `16:9`, `9:21` ## Z Image (Texto a imagen) ### Punto de conexión ``` POST /api/v1/image/task ``` ### Parámetros de la solicitud #### Obligatorios | Parámetro | Tipo | Descripción | |-----------|------|-------------| | `model_name` | string | Debe ser `"z-image"` | | `prompt` | string | Prompt de generación de imágenes | | `width` | number | Valor de la proporción de ancho (por ejemplo, `16` para `16:9`) | | `height` | number | Valor de la proporción de alto (por ejemplo, `9` para `16:9`) | #### Opcionales | Parámetro | Tipo | Descripción | |-----------|------|-------------| | `seed` | number | Semilla aleatoria en el rango `[0, 2147483647]`. Usa `null` o `0` para generación aleatoria. | ### Solicitud de ejemplo ```javascript const response = await fetch('https://api.flaq.ai/api/v1/image/task', { method: 'POST', headers: { 'Authorization': 'Bearer YOUR_API_KEY', 'Content-Type': 'application/json' }, body: JSON.stringify({ model_name: 'z-image', prompt: 'A cinematic portrait of a traveler standing on a cliff at golden hour', width: 16, height: 9, seed: 0 }) }); const { data } = await response.json(); const taskId = data.task_id; ``` ## Formato de respuesta Respuesta de envío: ```json { "code": 0, "message": "success", "data": { "task_id": "{task_id}", "response_url": "https://api.flaq.ai/api/v1/image/{task_id}", "task_status": "submitted" } } ``` Consulta con `GET /api/v1/image/{task_id}`. Estados de la tarea: `submitted`, `processing`, `succeed`, `failed`. Las respuestas de sondeo correctas exponen las URL de las imágenes generadas en `data.task_result.images[].url`. ## Buenas prácticas - Usa valores de proporción, no dimensiones en píxeles, para `width` y `height`. - Mantén los prompts descriptivos pero centrados en el sujeto, la iluminación y la composición. - Usa un `seed` fijo cuando quieras generaciones reproducibles durante las pruebas.