Создаёт изображения с чёткими надписями — до 4K и с прозрачным фоном — и меняет загруженные картинки по заданию, в том числе только в закрашенной области. Цена зависит от качества и размера: создание 2K — 1,20–15 ₽, 4K — 9–30 ₽, правка — 1,20–33 ₽, правка картинки больше 2K — до 90 ₽ за изображение.
Общая документация Public API · API-ключ можно создать в настройках аккаунта
Ideogram V4.6 рисует изображения по текстовому описанию и правит готовые картинки по заданию. Её сильная сторона - аккуратный читаемый текст прямо на изображении, поэтому модель берут для постеров, баннеров, обложек, логотипов, наклеек и карточек товаров. Готовый результат бывает в 2K или 4K, а логотип или наклейку можно сразу получить на прозрачном фоне.
Каждый запрос создаёт асинхронную операцию: сразу приходит id и статус queued, а ссылки на готовые изображения нужно забрать отдельным запросом по этому id.
POST /api/v1/operationsAuthorization: Bearer brth_...id, стартовый статус и стоимость операции.Режим задаёт поле generation_type:
create - новое изображение по тексту, image_urls не нужен;edit - правка: первое изображение из image_urls меняется по prompt, остальные (до 4) служат образцами стиля, предмета или персонажа. С маской (use_mask: true и mask_url) меняется только закрашенная область.За один запуск можно получить от 1 до 4 изображений - их число задаёт num_images.
{
"tool": "ideogram-v4-6",
"input": {
"...": "..."
}
}
tool - slug нейросети, всегда "ideogram-v4-6".input - параметры запуска, все поля передаются прямо внутри этого объекта.aspect_ratio, resolution и prompt_expansion_mode - при создании, image_urls, use_mask, mask_url, edit_precision и edit_aspect_ratio - при правке. Поля чужого режима можно не передавать, они ни на что не влияют.| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
generation_type | enum | Да | create - создать изображение по тексту, edit - изменить загруженное. Для правки передавайте edit обязательно: без него ссылки из image_urls не учитываются. |
prompt | string | Да | Что нарисовать или что изменить. От 3 до 10000 символов. Надпись, которая должна появиться на изображении, пишите в кавычках. |
image_urls | string[] | Только для edit | Внешние http/https ссылки на .jpg, .jpeg, .png или .webp, от 1 до 5 штук. Первая ссылка - изображение для правки, остальные - образцы. |
quality | enum | Нет | Качество и цена: very_low, low, medium, high. Если не передать - medium. Цены - в разделе «Ценообразование». |
num_images | number | Нет | Сколько изображений сделать за запуск: от 1 до 4. Цена умножается на это число. Если не передать - 1. |
aspect_ratio | enum | Нет | Только для create. Соотношение сторон: 1:1, 4:3, 3:4, 3:2, 2:3, 16:9, 9:16. Если не передать - 1:1. |
resolution | enum | Нет | Только для create. 2k (например 2048×2048 для 1:1) или 4k (4096×4096 для 1:1, 4096×2304 для 16:9). С quality: "very_low" всегда получается 2K. Если не передать - 2k. |
prompt_expansion_mode | enum | Нет | Только для create. on - модель дополнит описание деталями перед генерацией, off - будет следовать только вашему тексту. Если не передать - on. |
use_mask | boolean | Нет | Только для edit, не больше 4 ссылок в image_urls. true - менять только область из mask_url. |
mask_url | string | При use_mask: true | Ссылка на PNG-маску того же размера, что первое изображение. Чёрное - область правки, белое - остаётся как есть. С маской образцов не больше 3, а edit_aspect_ratio не учитывается. |
edit_precision | enum | Нет | Только для edit. regular - обычная правка по заданию, high - всё, что вы не просили менять, остаётся точно как на исходнике, пропорции и размер берутся из исходного изображения. Если не передать - regular. |
edit_aspect_ratio | enum | Нет | Только для edit с edit_precision: "regular" и без маски. auto - пропорции исходного изображения, или 1:1, 4:3, 3:4, 3:2, 2:3, 16:9, 9:16. Если не передать - auto. |
transparent_background | boolean | Нет | true - изображение PNG без фона, удобно для логотипов, наклеек и значков. Работает при создании и при правке с edit_precision: "regular". Если не передать - false. |
curl -X POST https://bratuha.ru/api/v1/operations \
-H "Authorization: Bearer brth_ваш_ключ" \
-H "Content-Type: application/json" \
-d '{
"tool": "ideogram-v4-6",
"input": {
"generation_type": "create",
"prompt": "Афиша джазового вечера: саксофонист в луче прожектора на тёмно-синем фоне, сверху крупная надпись \"ДЖАЗ У РЕКИ\", внизу мелко \"суббота, 20:00\"",
"quality": "high",
"aspect_ratio": "2:3",
"resolution": "4k",
"prompt_expansion_mode": "on",
"num_images": 2
}
}'
const response = await fetch('https://bratuha.ru/api/v1/operations', {
method: 'POST',
headers: {
Authorization: 'Bearer brth_ваш_ключ',
'Content-Type': 'application/json',
},
body: JSON.stringify({
tool: 'ideogram-v4-6',
input: {
generation_type: 'create',
prompt:
'Афиша джазового вечера: саксофонист в луче прожектора на тёмно-синем фоне, сверху крупная надпись "ДЖАЗ У РЕКИ", внизу мелко "суббота, 20:00"',
quality: 'high',
aspect_ratio: '2:3',
resolution: '4k',
prompt_expansion_mode: 'on',
num_images: 2,
},
}),
})
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': 'ideogram-v4-6',
'input': {
'generation_type': 'create',
'prompt': 'Афиша джазового вечера: саксофонист в луче прожектора на тёмно-синем фоне, сверху крупная надпись "ДЖАЗ У РЕКИ", внизу мелко "суббота, 20:00"',
'quality': 'high',
'aspect_ratio': '2:3',
'resolution': '4k',
'prompt_expansion_mode': 'on',
'num_images': 2,
},
},
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": "ideogram-v4-6",
"input": {
"generation_type": "create",
"prompt": "Логотип пекарни: круглая эмблема с колосом и надписью \"ХЛЕБНАЯ ЛАВКА\", тёплые коричневые тона, плоский стиль",
"quality": "medium",
"aspect_ratio": "1:1",
"transparent_background": true,
"prompt_expansion_mode": "off"
}
}'
const response = await fetch('https://bratuha.ru/api/v1/operations', {
method: 'POST',
headers: {
Authorization: 'Bearer brth_ваш_ключ',
'Content-Type': 'application/json',
},
body: JSON.stringify({
tool: 'ideogram-v4-6',
input: {
generation_type: 'create',
prompt:
'Логотип пекарни: круглая эмблема с колосом и надписью "ХЛЕБНАЯ ЛАВКА", тёплые коричневые тона, плоский стиль',
quality: 'medium',
aspect_ratio: '1:1',
transparent_background: true,
prompt_expansion_mode: 'off',
},
}),
})
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': 'ideogram-v4-6',
'input': {
'generation_type': 'create',
'prompt': 'Логотип пекарни: круглая эмблема с колосом и надписью "ХЛЕБНАЯ ЛАВКА", тёплые коричневые тона, плоский стиль',
'quality': 'medium',
'aspect_ratio': '1:1',
'transparent_background': True,
'prompt_expansion_mode': 'off',
},
},
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": "ideogram-v4-6",
"input": {
"generation_type": "edit",
"prompt": "Замени надпись на вывеске кафе на \"ЛЕТНЯЯ ВЕРАНДА\", остальное не меняй",
"image_urls": [
"https://cdn.example.com/source-image-1.jpg"
],
"quality": "medium",
"edit_precision": "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: 'ideogram-v4-6',
input: {
generation_type: 'edit',
prompt: 'Замени надпись на вывеске кафе на "ЛЕТНЯЯ ВЕРАНДА", остальное не меняй',
image_urls: ['https://cdn.example.com/source-image-1.jpg'],
quality: 'medium',
edit_precision: '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': 'ideogram-v4-6',
'input': {
'generation_type': 'edit',
'prompt': 'Замени надпись на вывеске кафе на "ЛЕТНЯЯ ВЕРАНДА", остальное не меняй',
'image_urls': ['https://cdn.example.com/source-image-1.jpg'],
'quality': 'medium',
'edit_precision': '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": "ideogram-v4-6",
"input": {
"generation_type": "edit",
"prompt": "Поставь на стол в кадре кружку со второго изображения, сохрани свет и ракурс исходной сцены",
"image_urls": [
"https://cdn.example.com/source-image-1.jpg",
"https://cdn.example.com/reference-image-2.png"
],
"quality": "low",
"edit_precision": "regular",
"edit_aspect_ratio": "16:9",
"num_images": 3
}
}'
const response = await fetch('https://bratuha.ru/api/v1/operations', {
method: 'POST',
headers: {
Authorization: 'Bearer brth_ваш_ключ',
'Content-Type': 'application/json',
},
body: JSON.stringify({
tool: 'ideogram-v4-6',
input: {
generation_type: 'edit',
prompt: 'Поставь на стол в кадре кружку со второго изображения, сохрани свет и ракурс исходной сцены',
image_urls: [
'https://cdn.example.com/source-image-1.jpg',
'https://cdn.example.com/reference-image-2.png',
],
quality: 'low',
edit_precision: 'regular',
edit_aspect_ratio: '16:9',
num_images: 3,
},
}),
})
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': 'ideogram-v4-6',
'input': {
'generation_type': 'edit',
'prompt': 'Поставь на стол в кадре кружку со второго изображения, сохрани свет и ракурс исходной сцены',
'image_urls': [
'https://cdn.example.com/source-image-1.jpg',
'https://cdn.example.com/reference-image-2.png',
],
'quality': 'low',
'edit_precision': 'regular',
'edit_aspect_ratio': '16:9',
'num_images': 3,
},
},
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": "ideogram-v4-6",
"input": {
"generation_type": "edit",
"prompt": "В закрашенной области поставь вазу с подсолнухами",
"image_urls": [
"https://cdn.example.com/source-image-1.jpg"
],
"use_mask": true,
"mask_url": "https://cdn.example.com/mask-1.png",
"quality": "medium",
"edit_precision": "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: 'ideogram-v4-6',
input: {
generation_type: 'edit',
prompt: 'В закрашенной области поставь вазу с подсолнухами',
image_urls: ['https://cdn.example.com/source-image-1.jpg'],
use_mask: true,
mask_url: 'https://cdn.example.com/mask-1.png',
quality: 'medium',
edit_precision: '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': 'ideogram-v4-6',
'input': {
'generation_type': 'edit',
'prompt': 'В закрашенной области поставь вазу с подсолнухами',
'image_urls': ['https://cdn.example.com/source-image-1.jpg'],
'use_mask': True,
'mask_url': 'https://cdn.example.com/mask-1.png',
'quality': 'medium',
'edit_precision': 'high',
},
},
timeout=30,
)
print(response.status_code)
print(response.json())
{
"id": "op_uuid-123",
"status": "queued",
"tool": "ideogram-v4-6",
"cost": 60,
"balance_after": 440,
"created_at": "2026-11-20T12:00:00Z"
}
{
"id": "op_uuid-123",
"status": "completed",
"tool": "ideogram-v4-6",
"cost": 60,
"created_at": "2026-11-20T12:00:00Z",
"completed_at": "2026-11-20T12:00:40Z",
"result": {
"type": "image",
"urls": [
"https://storage.bratuha.ru/results/ideogram-v4-6/image-1.png",
"https://storage.bratuha.ru/results/ideogram-v4-6/image-2.png"
]
},
"error_message": null
}
{
"id": "op_uuid-123",
"status": "failed",
"tool": "ideogram-v4-6",
"cost": 60,
"created_at": "2026-11-20T12:00:00Z",
"completed_at": "2026-11-20T12:00:12Z",
"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()
В обоих режимах приходят изображения - столько, сколько указано в num_images:
{
"type": "image",
"urls": [
"https://storage.bratuha.ru/results/ideogram-v4-6/image-1.png"
]
}
type - всегда "image".urls - массив ссылок на готовые изображения, от 1 до 4.transparent_background: true приходит PNG с прозрачным фоном.Если операция завершилась с ошибкой, result будет null, а причина придёт в error_message.
Цена считается за одно изображение и умножается на num_images. Она зависит от режима, quality и, при создании, от resolution:
| Режим | very_low | low | medium | high |
|---|---|---|---|---|
create, 2k | 1,20 ₽ | 4,50 ₽ | 9 ₽ | 15 ₽ |
create, 4k | - | 9 ₽ | 18 ₽ | 30 ₽ |
edit, исходник до 2K | 1,20 ₽ | 4,50 ₽ | 9 ₽ | 33 ₽ |
edit, исходник больше 2K | 1,20 ₽ | 9 ₽ | 30 ₽ | 90 ₽ |
very_low всегда даёт 2K, поэтому цена с ним одна - 1,20 ₽ за изображение.quality не передан, считается medium.edit_aspect_ratio: результат всегда 2K.Примеры:
create, high, 4k, num_images: 2 - 2 × 30 = 60 ₽;create, medium, 2k, одно изображение - 9 ₽;edit, low, num_images: 3 - 3 × 4,50 = 13,50 ₽.Точная сумма приходит в поле cost ответа на создание операции.
Idempotency-Key: повтор того же запроса в течение 24 часов вернёт исходную операцию без повторного списания. Без этого заголовка повтор создаёт новую операцию и снова списывает деньги.max_price в теле запроса, чтобы сервер отклонил запуск дороже согласованной суммы до списания.queued, затем проверяйте статус по id раз в 3-5 секунд.http/https ссылками на .jpg, .jpeg, .png или .webp, не больше 5 ссылок в image_urls. Локальные адреса, localhost и приватные IP не подходят.edit_aspect_ratio при обычной точности - в 2K). Чтобы платить по тарифу 2K, загружайте исходник не больше 4 194 304 точек.edit_precision: "high" пропорции и размер берутся из исходного изображения, edit_aspect_ratio и transparent_background в этом случае не учитываются.edit_precision: "high" меняет только закрашенную область, остальные пиксели и размер остаются как у исходника.prompt_expansion_mode: "off".validation_error.