# API Z Image Полная справка API для генерации text-to-image Z Image. ## Варианты модели Этот API поддерживает один вариант модели: | Модель | ID | Описание | |-------|-----|-------------| | **Z Image** | `z-image` | Быстрая генерация text-to-image | ## Краткое сравнение | Возможность | Z Image | |---------|---------| | Ввод | Текстовый промпт | | Вывод | Одно сгенерированное изображение | | Соотношения сторон | Поддерживается несколько соотношений | | Разрешение | Выводится из значений соотношения width/height | | `seed` | Необязательно | ### Поддерживаемые соотношения сторон Пара `width:height` должна быть одной из: `1:1`, `3:2`, `2:3`, `3:4`, `4:3`, `9:16`, `16:9`, `9:21` ## Z Image (Text-to-Image) ### Эндпоинт ``` POST /api/v1/image/task ``` ### Параметры запроса #### Обязательные | Параметр | Тип | Описание | |-----------|------|-------------| | `model_name` | string | Должно быть `"z-image"` | | `prompt` | string | Промпт для генерации изображения | | `width` | number | Значение соотношения ширины (например, `16` для `16:9`) | | `height` | number | Значение соотношения высоты (например, `9` для `16:9`) | #### Необязательные | Параметр | Тип | Описание | |-----------|------|-------------| | `seed` | number | Случайное зерно в диапазоне `[0, 2147483647]`. Используйте `null` или `0` для случайной генерации. | ### Пример запроса ```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; ``` ## Формат ответа Ответ на отправку: ```json { "code": 0, "message": "success", "data": { "task_id": "{task_id}", "response_url": "https://api.flaq.ai/api/v1/image/{task_id}", "task_status": "submitted" } } ``` Опрос через `GET /api/v1/image/{task_id}`. Статусы задачи: `submitted`, `processing`, `succeed`, `failed`. Успешные ответы опроса предоставляют URL сгенерированных изображений в `data.task_result.images[].url`. ## Рекомендации - Используйте значения соотношения, а не пиксельные размеры, для `width` и `height`. - Делайте промпты описательными, но сфокусированными на объекте, освещении и композиции. - Используйте фиксированный `seed`, когда нужны воспроизводимые генерации при тестировании.