Генерирует картинки по текстовому описанию и аккуратно редактирует ваши изображения по инструкции (например, заменить фон, предмет или стиль). Стоимость - 4 рубля за изображение, а при выборе высокого качества цена увеличивается.
Общая документация Public API · API-ключ можно создать в настройках аккаунта
GPT Image 1.5 генерирует изображения по текстовому описанию и редактирует загруженные картинки по инструкции - например, заменяет фон, стиль или отдельные элементы.
Два режима работы:
Режим определяется автоматически: если передать изображения в input_urls, нейросеть работает как редактор. Без изображений - генерирует с нуля.
Каждый вызов создаёт асинхронную операцию. После запуска нужно отдельно проверять статус по id.
POST /api/v1/operationsAuthorization: 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 -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"
}
}'
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()
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 -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"
}
}'
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()
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 -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"
}
}'
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()
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 -H "Authorization: Bearer brth_ваш_ключ" \
https://bratuha.ru/api/v1/operations/op_uuid-123
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 ₽ |
input_urls разрешены только внешние http/https URL с расширениями .jpg, .jpeg, .png, .webp.HEIC/HEIF, которые поддерживаются при загрузке файлов в UI, в Public API по URL не принимаются.POST /api/v1/operations не идемпотентен: повторный запрос создаёт новую операцию.queued, затем проверяете статус по id.