Создаёт изображения по описанию и редактирует загруженные: меняет детали по заданию или объединяет до 10 картинок в одну сцену. FLUX 3 — от 7 ₽ за изображение, быстрая Klein — от 2 ₽.
Общая документация Public API · API-ключ можно создать в настройках аккаунта
FLUX 3 Image рисует изображения по текстовому описанию и правит готовые картинки по заданию. Модель хорошо держит композицию и надписи, а в режиме правки умеет собрать одну сцену из нескольких изображений: например, поставить товар с одного фото в интерьер с другого. Её берут для рекламных макетов, карточек товаров, обложек и иллюстраций.
Есть две модели: основная FLUX 3 и быстрая FLUX 3 Klein - она в несколько раз дешевле, умеет то же создание и правку, но без поиска в интернете. Модель выбирается параметром flux_model.
Режим выбирается сам по запросу:
image_urls не передан или пустой. Модель рисует новое изображение по prompt.image_urls есть хотя бы одна ссылка (до 10). Модель меняет изображения по prompt или объединяет их в одну картинку.Каждый запрос создаёт асинхронную операцию: сразу приходит id и статус queued, а готовое изображение нужно забрать отдельным запросом по этому id.
POST /api/v1/operationsAuthorization: Bearer brth_...id и стартовый статус операции.Режимы:
image_urls;image_urls;image_urls.{
"tool": "flux-3-image",
"input": {
"...": "..."
}
}
tool - slug нейросети, всегда "flux-3-image".input - параметры запуска, все поля передаются прямо внутри этого объекта.aspect_ratio - при создании, edit_aspect_ratio - при правке. Поле чужого режима можно не передавать, оно ни на что не влияет.| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
flux_model | enum | Нет | Модель: flux-3 - основная, klein - быстрая и дешёвая, без grounding. Если не передать - flux-3. |
prompt | string | Да | Что нарисовать или что изменить. От 3 до 5000 символов. В правке на изображения можно ссылаться по номеру: @image1, @image2 - номер совпадает с порядком ссылок в image_urls. |
image_urls | string[] | Нет | Внешние http/https ссылки на изображения .jpg, .jpeg, .png, .webp, до 10 штук. Без ссылок - создание, со ссылками - правка. |
aspect_ratio | enum | Нет | Только при создании. auto - модель подберёт пропорции по prompt (если не сможет - 1:1), или соотношение сторон: 21:9, 2:1, 16:9, 3:2, 7:5, 4:3, 5:4, 1:1, 4:5, 3:4, 5:7, 2:3, 9:16, 1:2, 9:21. Если не передать - 1:1. |
edit_aspect_ratio | enum | Нет | Только при правке. auto - пропорции первого изображения, или любое соотношение из списка aspect_ratio. Если не передать - auto. |
resolution | enum | Нет | Размер готового изображения: 1k - около 1 Мп, 1.5k - около 2 Мп, 2k - около 4 Мп, 4k - около 16 Мп. Цена зависит от размера и модели - см. «Ценообразование». Если не передать - 1k. |
grounding | boolean | Нет |
curl -X POST https://bratuha.ru/api/v1/operations \
-H "Authorization: Bearer brth_ваш_ключ" \
-H "Content-Type: application/json" \
-d '{
"tool": "flux-3-image",
"input": {
"prompt": "Уютная мастерская часовщика вечером: мастер в очках склонился над карманными часами, тёплый свет настольной лампы, на стене вывеска \"ВРЕМЯ ЕСТЬ\"",
"aspect_ratio": "16:9",
"resolution": "1k"
}
}'
const response = await fetch('https://bratuha.ru/api/v1/operations', {
method: 'POST',
headers: {
Authorization: 'Bearer brth_ваш_ключ',
'Content-Type': 'application/json',
},
body: JSON.stringify({
tool: 'flux-3-image',
input: {
prompt: 'Уютная мастерская часовщика вечером: мастер в очках склонился над карманными часами, тёплый свет настольной лампы, на стене вывеска "ВРЕМЯ ЕСТЬ"',
aspect_ratio: '16:9',
resolution: '1k',
},
}),
})
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': 'flux-3-image',
'input': {
'prompt': 'Уютная мастерская часовщика вечером: мастер в очках склонился над карманными часами, тёплый свет настольной лампы, на стене вывеска "ВРЕМЯ ЕСТЬ"',
'aspect_ratio': '16:9',
'resolution': '1k',
},
},
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": "flux-3-image",
"input": {
"prompt": "Перекрась флакон духов в изумрудное полупрозрачное стекло с золотой крышкой. Форму, положение флакона, лицо и позу человека не меняй",
"image_urls": [
"https://cdn.example.com/source-image-1.jpg"
],
"edit_aspect_ratio": "auto",
"resolution": "2k"
}
}'
const response = await fetch('https://bratuha.ru/api/v1/operations', {
method: 'POST',
headers: {
Authorization: 'Bearer brth_ваш_ключ',
'Content-Type': 'application/json',
},
body: JSON.stringify({
tool: 'flux-3-image',
input: {
prompt: 'Перекрась флакон духов в изумрудное полупрозрачное стекло с золотой крышкой. Форму, положение флакона, лицо и позу человека не меняй',
image_urls: ['https://cdn.example.com/source-image-1.jpg'],
edit_aspect_ratio: 'auto',
resolution: '2k',
},
}),
})
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': 'flux-3-image',
'input': {
'prompt': 'Перекрась флакон духов в изумрудное полупрозрачное стекло с золотой крышкой. Форму, положение флакона, лицо и позу человека не меняй',
'image_urls': ['https://cdn.example.com/source-image-1.jpg'],
'edit_aspect_ratio': 'auto',
'resolution': '2k',
},
},
timeout=30,
)
print(response.status_code)
print(response.json())
Номер в @image1, @image2 - это порядок ссылки в image_urls.
curl -X POST https://bratuha.ru/api/v1/operations \
-H "Authorization: Bearer brth_ваш_ключ" \
-H "Content-Type: application/json" \
-d '{
"tool": "flux-3-image",
"input": {
"prompt": "Поставь кресло с @image2 в гостиную с @image1 у окна, сохрани свет и ракурс комнаты",
"image_urls": [
"https://cdn.example.com/source-image-1.jpg",
"https://cdn.example.com/reference-image-2.png"
],
"edit_aspect_ratio": "4:3",
"resolution": "1.5k",
"grounding": false
}
}'
const response = await fetch('https://bratuha.ru/api/v1/operations', {
method: 'POST',
headers: {
Authorization: 'Bearer brth_ваш_ключ',
'Content-Type': 'application/json',
},
body: JSON.stringify({
tool: 'flux-3-image',
input: {
prompt: 'Поставь кресло с @image2 в гостиную с @image1 у окна, сохрани свет и ракурс комнаты',
image_urls: [
'https://cdn.example.com/source-image-1.jpg',
'https://cdn.example.com/reference-image-2.png',
],
edit_aspect_ratio: '4:3',
resolution: '1.5k',
grounding: false,
},
}),
})
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': 'flux-3-image',
'input': {
'prompt': 'Поставь кресло с @image2 в гостиную с @image1 у окна, сохрани свет и ракурс комнаты',
'image_urls': [
'https://cdn.example.com/source-image-1.jpg',
'https://cdn.example.com/reference-image-2.png',
],
'edit_aspect_ratio': '4:3',
'resolution': '1.5k',
'grounding': False,
},
},
timeout=30,
)
print(response.status_code)
print(response.json())
Та же правка или создание за 2 ₽ в 1k: передайте "flux_model": "klein".
curl -X POST https://bratuha.ru/api/v1/operations \
-H "Authorization: Bearer brth_ваш_ключ" \
-H "Content-Type: application/json" \
-d '{
"tool": "flux-3-image",
"input": {
"flux_model": "klein",
"prompt": "Вывеска маленькой кофейни «Утро» на кирпичной стене, зимнее утро, пар из чашки на подоконнике, фотореализм",
"aspect_ratio": "16:9",
"resolution": "1k"
}
}'
const response = await fetch('https://bratuha.ru/api/v1/operations', {
method: 'POST',
headers: {
Authorization: 'Bearer brth_ваш_ключ',
'Content-Type': 'application/json',
},
body: JSON.stringify({
tool: 'flux-3-image',
input: {
flux_model: 'klein',
prompt: 'Вывеска маленькой кофейни «Утро» на кирпичной стене, зимнее утро, пар из чашки на подоконнике, фотореализм',
aspect_ratio: '16:9',
resolution: '1k',
},
}),
})
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': 'flux-3-image',
'input': {
'flux_model': 'klein',
'prompt': 'Вывеска маленькой кофейни «Утро» на кирпичной стене, зимнее утро, пар из чашки на подоконнике, фотореализм',
'aspect_ratio': '16:9',
'resolution': '1k',
},
},
timeout=30,
)
print(response.status_code)
print(response.json())
{
"id": "op_uuid-123",
"status": "queued",
"tool": "flux-3-image",
"cost": 7,
"balance_after": 493,
"created_at": "2026-10-06T12:00:00Z"
}
{
"id": "op_uuid-123",
"status": "completed",
"tool": "flux-3-image",
"cost": 7,
"created_at": "2026-10-06T12:00:00Z",
"completed_at": "2026-10-06T12:00:20Z",
"result": {
"type": "image",
"urls": [
"https://storage.bratuha.ru/results/flux-3-image/image-1.png"
]
},
"error_message": null
}
{
"id": "op_uuid-123",
"status": "failed",
"tool": "flux-3-image",
"cost": 7,
"created_at": "2026-10-06T12:00:00Z",
"completed_at": "2026-10-06T12:00:08Z",
"result": null,
"error_message": "Не удалось сгенерировать изображение по этому запросу"
}
Сохраните 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()
В обоих режимах приходит одно изображение:
{
"type": "image",
"urls": [
"https://storage.bratuha.ru/results/flux-3-image/image-1.png"
]
}
type - всегда "image".urls - массив с одной ссылкой на готовое изображение.Если операция завершилась с ошибкой, result будет null, а причина придёт в error_message.
Цена за одно изображение зависит от модели и resolution и одинакова для создания и правки:
resolution | flux-3 | klein |
|---|---|---|
1k | 7 ₽ | 2 ₽ |
1.5k | 10 ₽ | 2 ₽ |
2k | 15 ₽ | 2 ₽ |
4k | 70 ₽ | 5 ₽ |
flux_model и resolution, считается FLUX 3 в 1k - 7 ₽.1k удобно для перебора идей, 1.5k и 2k - для финального варианта, 4k - для печати и крупных макетов. Изображение 4k готовится до нескольких минут.Idempotency-Key: повтор того же запроса в течение 24 часов вернёт исходную операцию без повторного списания. Без заголовка повтор создаёт новую операцию и списывает деньги ещё раз.max_price в теле запроса, чтобы сервер отклонил запуск дороже согласованной суммы до списания.queued, затем проверяйте статус по id раз в 2-3 секунды.http/https ссылками на .jpg, .jpeg, .png или .webp, не больше 10 ссылок в image_urls.edit_aspect_ratio: "auto" результат получает пропорции первого изображения, поэтому главное изображение ставьте первым.prompt в кавычках.validation_error.true - перед генерацией модель поищет сведения и картинки в интернете: полезно для реальных мест, товаров, логотипов и свежих событий, но генерация дольше. Только для flux-3, у klein параметр не передавайте. Если не передать - false. |