Документация · Референс
Сгенерировать изображение
POST/v1/images/generations
Генерация картинки по prompt в OpenAI-формате; ответ — data[].b64_json (default response_format=b64_json). Непустое поле image переключает запрос в режим редактирования (instruct-edit) — модель должна иметь capability image_input, иначе 400 unsupported_capability. Списание — после успешного ответа провайдера (по usage либо фикс-цене за картинку), при ошибке апстрима денег не берём; rate-limit — общий bucket 60 запросов в минуту на аккаунт.
Авторизация — заголовок Authorization: Bearer <API-ключ>, base URL — https://api.trackly.one/v1.
Тело запроса ImageGenerationRequest
Content-Type: application/json
| Поле | Тип | Описание |
|---|---|---|
image | array<ImageInput> | null | — |
mask | ImageInput | null | — |
modelобязательное | string | — |
n | integer | По умолчанию: 1 |
promptобязательное | string | — |
quality | string | null | — |
reference_images | array<ImageInput> | null | — |
response_format | "b64_json" | "url" | По умолчанию: "b64_json" |
size | string | null | — |
Схема ImageInput
Картинка, которую юзер передал во входе запроса.
Два варианта type: - url — внешний URL, провайдер (или мы) скачаем по запросу. - base64 — уже сырые байты в base64 (без data:image/...; префикса).
mime_type обязателен для base64 (нужен Gemini для inline_data), для url — опционально (можно определить из ответа).
| Поле | Тип | Описание |
|---|---|---|
dataобязательное | string | Длина 1–∞ символов |
mime_type | string | null | image/png, image/jpeg, image/webp |
typeобязательное | "url" | "base64" | — |
Схема ImageGenerationResponse
| Поле | Тип | Описание |
|---|---|---|
created | integer | — |
dataобязательное | array<ImageData> | — |
usage | ImageUsage | null | — |
Схема ImageData
Одна сгенерированная картинка.
| Поле | Тип | Описание |
|---|---|---|
b64_json | string | null | — |
revised_prompt | string | null | — |
url | string | null | — |
Схема ImageUsage
Usage для image-моделей. gpt-image даёт полный breakdown, gemini — только total_tokens, imagen — все нули.
| Поле | Тип | Описание |
|---|---|---|
input_tokens | integer | По умолчанию: 0 |
output_tokens | integer | По умолчанию: 0 |
total_tokens | integer | По умолчанию: 0 |
Ответы
| Код | Описание | Схема |
|---|---|---|
200 | Успешный ответ | ImageGenerationResponse |
422 | Ошибка валидации тела запроса или параметров | — |