GPT Image 1.5 API

Генерирует картинки по текстовому описанию и аккуратно редактирует ваши изображения по инструкции (например, заменить фон, предмет или стиль). Стоимость - 4 рубля за изображение, а при выборе высокого качества цена увеличивается.

Нейросеть

API документация

Общая документация Public API · API-ключ можно создать в настройках аккаунта

GPT Image 1.5 API

GPT Image 1.5 генерирует изображения по текстовому описанию и редактирует загруженные картинки по инструкции - например, заменяет фон, стиль или отдельные элементы.

Два режима работы:

Генерация из текста - нейросеть создаёт изображение целиком по описанию.
Редактирование изображений - нейросеть вносит правки в загруженные картинки, сохраняя детали, которые не нужно менять.

Режим определяется автоматически: если передать изображения в input_urls, нейросеть работает как редактор. Без изображений - генерирует с нуля.

Каждый вызов создаёт асинхронную операцию. После запуска нужно отдельно проверять статус по id.

Создание операции

Endpoint: POST /api/v1/operations
Авторизация: Authorization: Bearer brth_...
Выполнение асинхронное: запрос сразу возвращает id и стартовый статус операции.

Тело запроса

{
  "tool": "gpt-image-1-5",
  "input": {
    "...": "..."
  }
}

tool - slug нейросети, всегда "gpt-image-1-5".
input - параметры запуска. Все поля передаются напрямую внутри этого объекта.

Параметры

Параметр	Тип	Обязательный	Описание
`prompt`	`string`	Да	Текстовое описание: что нужно сгенерировать или как изменить изображение. Максимум 3000 символов.
`input_urls`	`string[] (url)`	Нет	Массив внешних URL изображений для редактирования. Если передать хотя бы одно изображение, нейросеть перейдёт в режим редактирования. Максимум файлов: 16. Допустимые расширения: `.jpg`, `.jpeg`, `.png`, `.webp`.
`aspect_ratio`	`enum`	Да	Соотношение сторон результата. Варианты: `1:1` (квадрат), `2:3` (вертикальное), `3:2` (горизонтальное).
`quality`	`enum`	Да	Качество генерации. Варианты: `medium` (среднее), `high` (высокое). Высокое качество лучше для мелких деталей, лиц и текста, но стоит дороже.

Примеры запросов

Генерация из текста

cURL

curl -X POST https://bratuha.ru/api/v1/operations \
  -H "Authorization: Bearer brth_ваш_ключ" \
  -H "Content-Type: application/json" \
  -d '{
  "tool": "gpt-image-1-5",
  "input": {
    "prompt": "Уютная кофейня на углу европейской улочки, утренний свет, акварельный стиль",
    "aspect_ratio": "3:2",
    "quality": "medium"
  }
}'

JavaScript / TypeScript

const response = await fetch('https://bratuha.ru/api/v1/operations', {
  method: 'POST',
  headers: {
    Authorization: 'Bearer brth_ваш_ключ',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    tool: 'gpt-image-1-5',
    input: {
      prompt: 'Уютная кофейня на углу европейской улочки, утренний свет, акварельный стиль',
      aspect_ratio: '3:2',
      quality: 'medium',
    },
  }),
})

const data = await response.json()

Python

import requests

response = requests.post(
    'https://bratuha.ru/api/v1/operations',
    headers={
        'Authorization': 'Bearer brth_ваш_ключ',
        'Content-Type': 'application/json',
    },
    json={
        'tool': 'gpt-image-1-5',
        'input': {
            'prompt': 'Уютная кофейня на углу европейской улочки, утренний свет, акварельный стиль',
            'aspect_ratio': '3:2',
            'quality': 'medium',
        },
    },
    timeout=30,
)

print(response.status_code)
print(response.json())

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

cURL

curl -X POST https://bratuha.ru/api/v1/operations \
  -H "Authorization: Bearer brth_ваш_ключ" \
  -H "Content-Type: application/json" \
  -d '{
  "tool": "gpt-image-1-5",
  "input": {
    "prompt": "Замени фон на вечернюю набережную с тёплым освещением, лицо и одежду не трогай",
    "input_urls": [
      "https://cdn.example.com/source-image-1.jpg"
    ],
    "aspect_ratio": "1:1",
    "quality": "high"
  }
}'

JavaScript / TypeScript

const response = await fetch('https://bratuha.ru/api/v1/operations', {
  method: 'POST',
  headers: {
    Authorization: 'Bearer brth_ваш_ключ',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    tool: 'gpt-image-1-5',
    input: {
      prompt: 'Замени фон на вечернюю набережную с тёплым освещением, лицо и одежду не трогай',
      input_urls: [
        'https://cdn.example.com/source-image-1.jpg',
      ],
      aspect_ratio: '1:1',
      quality: 'high',
    },
  }),
})

const data = await response.json()

Python

import requests

response = requests.post(
    'https://bratuha.ru/api/v1/operations',
    headers={
        'Authorization': 'Bearer brth_ваш_ключ',
        'Content-Type': 'application/json',
    },
    json={
        'tool': 'gpt-image-1-5',
        'input': {
            'prompt': 'Замени фон на вечернюю набережную с тёплым освещением, лицо и одежду не трогай',
            'input_urls': [
                'https://cdn.example.com/source-image-1.jpg',
            ],
            'aspect_ratio': '1:1',
            'quality': 'high',
        },
    },
    timeout=30,
)

print(response.status_code)
print(response.json())

Редактирование с несколькими изображениями

cURL

curl -X POST https://bratuha.ru/api/v1/operations \
  -H "Authorization: Bearer brth_ваш_ключ" \
  -H "Content-Type: application/json" \
  -d '{
  "tool": "gpt-image-1-5",
  "input": {
    "prompt": "Совмести эти два изображения в коллаж в стиле журнальной обложки, добавь заголовок BRATUHA",
    "input_urls": [
      "https://cdn.example.com/source-image-1.jpg",
      "https://cdn.example.com/source-image-2.jpg"
    ],
    "aspect_ratio": "2:3",
    "quality": "high"
  }
}'

JavaScript / TypeScript

const response = await fetch('https://bratuha.ru/api/v1/operations', {
  method: 'POST',
  headers: {
    Authorization: 'Bearer brth_ваш_ключ',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    tool: 'gpt-image-1-5',
    input: {
      prompt: 'Совмести эти два изображения в коллаж в стиле журнальной обложки, добавь заголовок BRATUHA',
      input_urls: [
        'https://cdn.example.com/source-image-1.jpg',
        'https://cdn.example.com/source-image-2.jpg',
      ],
      aspect_ratio: '2:3',
      quality: 'high',
    },
  }),
})

const data = await response.json()

Python

import requests

response = requests.post(
    'https://bratuha.ru/api/v1/operations',
    headers={
        'Authorization': 'Bearer brth_ваш_ключ',
        'Content-Type': 'application/json',
    },
    json={
        'tool': 'gpt-image-1-5',
        'input': {
            'prompt': 'Совмести эти два изображения в коллаж в стиле журнальной обложки, добавь заголовок BRATUHA',
            'input_urls': [
                'https://cdn.example.com/source-image-1.jpg',
                'https://cdn.example.com/source-image-2.jpg',
            ],
            'aspect_ratio': '2:3',
            'quality': 'high',
        },
    },
    timeout=30,
)

print(response.status_code)
print(response.json())

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

Ответ после создания

{
  "id": "op_uuid-123",
  "status": "queued",
  "tool": "gpt-image-1-5",
  "cost": 4,
  "balance_after": 495,
  "created_at": "2026-03-13T12:00:00Z"
}

Ответ после завершения

{
  "id": "op_uuid-123",
  "status": "completed",
  "tool": "gpt-image-1-5",
  "cost": 4,
  "created_at": "2026-03-13T12:00:00Z",
  "completed_at": "2026-03-13T12:00:18Z",
  "result": {
    "type": "image",
    "urls": [
      "https://storage.bratuha.ru/results/gpt-image-1-5/image-1.jpg"
    ]
  },
  "error_message": null
}

Проверка статуса

После создания операции сохраните id из ответа и проверяйте статус отдельным запросом:

GET /api/v1/operations/{id}

cURL

curl -H "Authorization: Bearer brth_ваш_ключ" \
  https://bratuha.ru/api/v1/operations/op_uuid-123

JavaScript / TypeScript

const status = await fetch(
  'https://bratuha.ru/api/v1/operations/op_uuid-123',
  {
    headers: { Authorization: 'Bearer brth_ваш_ключ' },
  },
)

const result = await status.json()

Формат результата

После завершения GPT Image 1.5 возвращает:

{
  "type": "image",
  "urls": [
    "https://storage.bratuha.ru/results/gpt-image-1-5/image-1.jpg"
  ]
}

type - всегда "image".
urls - массив с одной ссылкой на готовое изображение.

Если операция завершилась с ошибкой, result будет null, а текст ошибки вернётся в error_message.

Ценообразование

Цена зависит от выбранного качества:

Качество	Цена
Среднее (`medium`)	4 ₽
Высокое (`high`)	18 ₽

Цена не зависит от соотношения сторон, режима работы (генерация или редактирование) или количества загруженных изображений.
Высокое качество лучше подходит для картинок с мелкими деталями, лицами или читаемым текстом.

Ограничения и практические заметки

Генерация занимает от нескольких секунд до минуты. Рекомендуется проверять статус с интервалом 3-5 секунд.
Для input_urls разрешены только внешние http/https URL с расширениями .jpg, .jpeg, .png, .webp.
Форматы HEIC/HEIF, которые поддерживаются при загрузке файлов в UI, в Public API по URL не принимаются.
Конкретные и подробные промпты дают лучший результат. Чем точнее описание (кто, где, что делает, какой стиль), тем меньше сюрпризов.
При редактировании лучше явно указывать, что именно нужно изменить и что сохранить: "замени фон на пляж, лицо и одежду не трогай".
Можно загрузить до 16 изображений за один запрос - это полезно для коллажей, переноса стиля или работы с несколькими референсами.
POST /api/v1/operations не идемпотентен: повторный запрос создаёт новую операцию.
Все операции выполняются асинхронно: сначала вы получаете queued, затем проверяете статус по id.

GPT Image 1.5 API — Братуха.ру