Генерация и редактирование изображений
Images API позволяет генерировать новые изображения по текстовому описанию и редактировать существующие изображения с помощью масок. Доступные операции:
Эндпоинт /v1/images/generations создаёт изображения по текстовому описанию.
| Параметр | Тип | Описание |
|---|---|---|
| model | string | Название модели (например, gpt-image-2) |
| prompt | string | Текстовое описание изображения |
| n | integer | Количество изображений (по умолчанию 1) |
| size | string | Размер изображения: 1024x1024, 1024x1536, 1536x1024 и др. |
| quality | string | Качество: low, medium, high |
curl -X POST https://api.ai-mediator.ru/v1/images/generations \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $AI_MEDIATOR_API_KEY" \
-d '{
"model": "gpt-image-2",
"prompt": "A cute baby sea otter",
"n": 1,
"size": "1024x1024",
"quality": "medium"
}' {
"created": 1234567890,
"data": [
{
"b64_json": "iVBORw0KGgoAAAANSUhEUgAA..."
}
]
}
Эндпоинт /v1/images/edits позволяет редактировать существующие изображения.
Используйте маску для указания области, которую нужно изменить.
| Параметр | Тип | Описание |
|---|---|---|
| model | string | Название модели (например, gpt-image-2) |
| image | file | Исходное изображение (PNG, до 4MB) |
| mask | file | Маска с прозрачными областями для редактирования (PNG) |
| prompt | string | Описание желаемых изменений |
| n | integer | Количество вариантов (по умолчанию 1) |
| size | string | Размер результата |
| quality | string | Качество: low, medium, high |
Маска изображения: Создайте PNG-файл того же размера, что и исходное изображение. Прозрачные (alpha = 0) области маски указывают, где модель должна внести изменения.
curl -X POST https://api.ai-mediator.ru/v1/images/edits \
-H "Authorization: Bearer $AI_MEDIATOR_API_KEY" \
-F "model=gpt-image-2" \
-F "image=@original_image.png" \
-F "mask=@mask_image.png" \
-F "prompt=Add a beautiful sunset in the background" \
-F "n=1" \
-F "size=1024x1024" \
-F "quality=medium" {
"created": 1234567890,
"data": [
{
"b64_json": "iVBORw0KGgoAAAANSUhEUgAA..."
}
]
}
Генерацию через /v1/images/generations поддерживают модели OpenAI
gpt-image-2, gpt-image-2.5-sunburst,
gpt-image-2.5-flare и модели Google
gemini-nano-banana-2.1, gemini-3-pro-image,
gemini-3.1-flash-lite-image. Изображение возвращается в поле
b64_json.
Актуальный список моделей по вашему ключу можно получить через API:
curl -s https://api.ai-mediator.ru/v1/models \
-H "Authorization: Bearer $AI_MEDIATOR_API_KEY" \
| jq '.data[] | select(.id | test("image|banana"))' Дополнительные ресурсы: