Документация · Референс
Отредактировать изображение
POST/v1/images/edits
OpenAI-совместимое редактирование картинок: принимает и multipart/form-data (как client.images.edit() в SDK — файлы image, опционально mask), и application/json с base64-картинками (то же тело, что у generations с полем image). Суммарный размер файлов — не больше 20 МБ. Модель должна иметь capability image_input, иначе 400 unsupported_capability; биллинг и rate-limit — как у /v1/images/generations (списание после успеха, 60 запросов в минуту).
Авторизация — заголовок Authorization: Bearer <API-ключ>, base URL — https://api.trackly.one/v1.
Тело запроса ImageGenerationRequest
Content-Type: multipart/form-data или application/json
JSON-вариант — то же тело, что у /v1/images/generations, с непустым полем image (base64 или URL). Multipart-вариант (как client.images.edit() в SDK): файлы в полях image (можно несколько, принимается и image[]) и опционально mask, остальные поля — обычные form-поля. Суммарный размер файлов — до 20 МБ.
| Поле | Тип | Описание |
|---|---|---|
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 |