POST

/v1/images/generations

API Reference

POST /v1/images/generations

OpenAI-совместимый эндпоинт для генерации и редактирования изображений.

Требуется авторизация. Списание — за каждое сгенерированное изображение (см. цену модели в каталоге).

Пример curl

bash

curl https://api.zukko.pro/v1/images/generations \
  -H "Authorization: Bearer fetch_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai-gpt-image-2-text-to-image",
    "prompt": "A cinematic travel poster for Kyoto in autumn",
    "size": "1024x1024",
    "quality": "high"
  }'

Запрос — text-to-image

JSON

bash

{
  "model": "openai-gpt-image-2-text-to-image",
  "prompt": "A cinematic travel poster for Kyoto in autumn",
  "size": "1024x1024",
  "quality": "high"
}

Запрос — edit

Для edit / reference моделей передайте входные картинки в images: публичные URL или data URL (data:image/png;base64,...).

JSON

bash

{
  "model": "openai-gpt-image-2-edit",
  "prompt": "Make the sky sunset orange",
  "images": [
    "https://example.com/photo.jpg"
  ]
}

Параметры

Параметр

Тип

Обязательный

Описание

model

string

Да

ID image-модели (см. список ниже)

prompt

string

Да

Текстовое описание изображения или правки

images

array

Условно

URL или data URL входных картинок (обязательно для edit / reference)

size

string

Нет

Размер для GPT Image, например 1024x1024

quality

string

Нет

Качество для GPT Image: low | medium | high

integer

Нет

Количество изображений (если поддерживает модель)

aspect_ratio

string

Нет

Соотношение сторон для Nano Banana, например 1:1

resolution

string

Нет

Разрешение для Nano Banana: 1k | 2k | 4k

Ответ

JSON

bash

{
  "created": 1735689600,
  "model": "openai-gpt-image-2-text-to-image",
  "data": [
    {
      "url": "https://cdn.example.com/outputs/result.png"
    }
  ]
}

Поля ответа

Поле

Тип

Описание

created

integer

Unix-timestamp создания ответа

model

string

ID модели Zukko, которой выполнили запрос

data

array

Массив результатов

data[].url

string

URL готового изображения

data[].b64_json

string

Base64 PNG/JPEG, если запрошен b64 формат

Доступные модели

model

Режим

Название

openai-gpt-image-2-text-to-image

text-to-image

GPT Image 2

openai-gpt-image-2-edit

edit

GPT Image 2 Edit

openai-gpt-image-1.5-text-to-image

text-to-image

GPT Image 1.5

openai-gpt-image-1.5-edit

edit

GPT Image 1.5 Edit

nano-banana-2-text-to-image-developer

text-to-image

Nano Banana 2 Developer

nano-banana-2-text-to-image

text-to-image

Nano Banana 2

nano-banana-2-edit-developer

edit

Nano Banana 2 Edit

nano-banana-2-reference-to-image-developer

reference

Nano Banana 2 Reference

nano-banana-2-lite-text-to-image-developer

text-to-image

Nano Banana 2 Lite

nano-banana-2-lite-edit-developer

edit

Nano Banana 2 Lite Edit

Ошибки

401 — нет или неверный API-ключ
402 insufficient_balance — недостаточно средств
400 — нет prompt или images для edit-модели
404 model_not_found — неизвестный id модели

POST /v1/chat/completions

POST /v1/messages