Images API - AI MEDIATOR | Генерация и редактирование изображений

Что такое Images API?

Images API позволяет генерировать новые изображения по текстовому описанию и редактировать существующие изображения с помощью масок. Доступные операции:

/v1/images/generations — генерация изображений по текстовому промпту
/v1/images/edits — редактирование изображений с использованием маски

Генерация изображений

Эндпоинт /v1/images/generations создаёт изображения по текстовому описанию.

Параметры запроса

Параметр	Тип	Описание
model	string	Название модели (например, `gpt-image-1`)
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-1",
        "prompt": "A cute baby sea otter",
        "n": 1,
        "size": "1024x1024",
        "quality": "medium"
    }'

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ.get('AI_MEDIATOR_API_KEY'),
    base_url="https://api.ai-mediator.ru/v1"
)

response = client.images.generate(
    model="gpt-image-1",
    prompt="A cute baby sea otter",
    n=1,
    size="1024x1024",
    quality="medium"
)

print(response.data[0].url)

Пример ответа

{
  "created": 1234567890,
  "data": [
    {
      "url": "https://...",
      "revised_prompt": "A cute baby sea otter floating on its back..."
    }
  ]
}

Редактирование изображений

Эндпоинт /v1/images/edits позволяет редактировать существующие изображения. Используйте маску для указания области, которую нужно изменить.

Параметры запроса

Параметр	Тип	Описание
model	string	Название модели (например, `gpt-image-1`)
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-1" \
    -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"

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ.get('AI_MEDIATOR_API_KEY'),
    base_url="https://api.ai-mediator.ru/v1"
)

response = client.images.edit(
    model="gpt-image-1",
    image=open("original_image.png", "rb"),
    mask=open("mask_image.png", "rb"),
    prompt="Add a beautiful sunset in the background",
    n=1,
    size="1024x1024"
)

print(response.data[0].url)

Пример ответа

{
  "created": 1234567890,
  "data": [
    {
      "url": "https://...",
      "revised_prompt": "Add a beautiful sunset in the background..."
    }
  ]
}

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

Для получения актуального списка доступных моделей генерации изображений используйте API:

curl -s https://api.ai-mediator.ru/v1/models \
    -H "Authorization: Bearer $AI_MEDIATOR_API_KEY" \
    | jq '.data[] | select(.id | contains("image"))'

Дополнительные ресурсы: