ImagineArt 2.0 API

ImagineArt 2.0 API

ImagineArt 2.0 рисует картинки по текстовому заданию и редактирует готовые изображения. Без исходников модель создаёт кадр с нуля в разрешении 2K, а если прислать от 1 до 4 картинок, меняет их по вашей инструкции: заменить предмет, поменять время года, добавить деталь, собрать сцену из нескольких снимков.

Подходит для иллюстраций к статьям и постам, баннеров в нестандартных пропорциях (есть даже 4:1 и 1:4), предметных фото и быстрых правок уже готовых картинок.

Режим выбирается сам: без image_urls - генерация по тексту, с image_urls - правка. Каждый вызов создаёт асинхронную операцию. Сохраните id из ответа и проверяйте по нему статус.

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

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

Сценарии:

• Генерация по тексту - только prompt и пропорции aspect_ratio.
• Правка одного изображения - image_urls с одной ссылкой и задание, что поменять.
• Правка по нескольким изображениям - в image_urls от 2 до 4 ссылок, в задании объясняете, что откуда взять.

Тело запроса

{
  "tool": "imagineart-2-0",
  "input": {
    "prompt": "...",
    "image_urls": [
      "https://cdn.example.com/source-image-1.jpg",
      "https://cdn.example.com/source-image-2.jpg"
    ],
    "aspect_ratio": "1:1"
  }
}

• tool - slug нейросети, всегда "imagineart-2-0".
• input - параметры запуска. Все поля передаются прямо внутри этого объекта, без дополнительной вложенности.
• image_urls нужен только для правки. Для генерации по тексту его просто не передавайте.

Параметры

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

Генерация по тексту

cURL

curl -X POST https://bratuha.ru/api/v1/operations \
  -H "Authorization: Bearer brth_ваш_ключ" \
  -H "Content-Type: application/json" \
  -d '{
  "tool": "imagineart-2-0",
  "input": {
    "prompt": "Уютный уголок для чтения у окна в дождливый день, тёплый свет лампы, плед и стопка книг, акварельный стиль",
    "aspect_ratio": "16:9"
  }
}'

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: 'imagineart-2-0',
    input: {
      prompt:
        'Уютный уголок для чтения у окна в дождливый день, тёплый свет лампы, плед и стопка книг, акварельный стиль',
      aspect_ratio: '16:9',
    },
  }),
})

const data = await response.json()
console.log(data.id, data.status)

Python

import requests

response = requests.post(
    'https://bratuha.ru/api/v1/operations',
    headers={
        'Authorization': 'Bearer brth_ваш_ключ',
        'Content-Type': 'application/json',
    },
    json={
        'tool': 'imagineart-2-0',
        'input': {
            'prompt': 'Уютный уголок для чтения у окна в дождливый день, тёплый свет лампы, плед и стопка книг, акварельный стиль',
            'aspect_ratio': '16:9',
        },
    },
    timeout=30,
)

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

Правка одного изображения

Летнее фото с дачи превращаем в зимнее. aspect_ratio можно передать любой из списка, результат всё равно повторит пропорции исходника.

cURL

curl -X POST https://bratuha.ru/api/v1/operations \
  -H "Authorization: Bearer brth_ваш_ключ" \
  -H "Content-Type: application/json" \
  -d '{
  "tool": "imagineart-2-0",
  "input": {
    "prompt": "Сделай эту сцену зимней: снег на заборе, скамейке и траве, изо рта у мужчины пар, рыжий кот остаётся на месте",
    "image_urls": [
      "https://cdn.example.com/dacha-summer.jpg"
    ],
    "aspect_ratio": "4:3"
  }
}'

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: 'imagineart-2-0',
    input: {
      prompt:
        'Сделай эту сцену зимней: снег на заборе, скамейке и траве, изо рта у мужчины пар, рыжий кот остаётся на месте',
      image_urls: ['https://cdn.example.com/dacha-summer.jpg'],
      aspect_ratio: '4:3',
    },
  }),
})

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': 'imagineart-2-0',
        'input': {
            'prompt': 'Сделай эту сцену зимней: снег на заборе, скамейке и траве, изо рта у мужчины пар, рыжий кот остаётся на месте',
            'image_urls': ['https://cdn.example.com/dacha-summer.jpg'],
            'aspect_ratio': '4:3',
        },
    },
    timeout=30,
)

print(response.json())

Правка по нескольким изображениям

Кружка с одного фото, кухонный стол с другого. Две ссылки - цена 9 ₽.

cURL

curl -X POST https://bratuha.ru/api/v1/operations \
  -H "Authorization: Bearer brth_ваш_ключ" \
  -H "Content-Type: application/json" \
  -d '{
  "tool": "imagineart-2-0",
  "input": {
    "prompt": "Поставь кружку со второго изображения на стол с первого изображения, рядом с тарелкой. Свет и тени как на первом изображении",
    "image_urls": [
      "https://cdn.example.com/kitchen-table.jpg",
      "https://cdn.example.com/ceramic-mug.png"
    ],
    "aspect_ratio": "1:1"
  }
}'

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: 'imagineart-2-0',
    input: {
      prompt:
        'Поставь кружку со второго изображения на стол с первого изображения, рядом с тарелкой. Свет и тени как на первом изображении',
      image_urls: [
        'https://cdn.example.com/kitchen-table.jpg',
        'https://cdn.example.com/ceramic-mug.png',
      ],
      aspect_ratio: '1:1',
    },
  }),
})

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': 'imagineart-2-0',
        'input': {
            'prompt': 'Поставь кружку со второго изображения на стол с первого изображения, рядом с тарелкой. Свет и тени как на первом изображении',
            'image_urls': [
                'https://cdn.example.com/kitchen-table.jpg',
                'https://cdn.example.com/ceramic-mug.png',
            ],
            'aspect_ratio': '1:1',
        },
    },
    timeout=30,
)

print(response.json())

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

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

{
  "id": "op_uuid-123",
  "status": "queued",
  "tool": "imagineart-2-0",
  "cost": 8,
  "balance_after": 492,
  "created_at": "2026-09-30T21:31:10.288316+00:00"
}

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

{
  "id": "op_uuid-123",
  "status": "completed",
  "tool": "imagineart-2-0",
  "cost": 8,
  "created_at": "2026-09-30T21:31:10.288316+00:00",
  "completed_at": "2026-09-30T21:31:54.23394+00:00",
  "result": {
    "type": "image",
    "urls": [
      "https://storage.bratuha.ru/results/imagineart-2-0/image-1.png"
    ]
  },
  "error_message": null
}

Ответ при ошибке

{
  "id": "op_uuid-123",
  "status": "failed",
  "tool": "imagineart-2-0",
  "cost": 8,
  "created_at": "2026-09-30T21:31:10.288316+00:00",
  "completed_at": "2026-09-30T21:32:02.517730+00:00",
  "result": null,
  "error_message": "Произошла ошибка, сервис временно недоступен. Попробуйте повторить запрос позже."
}

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

Сохраните id из ответа на создание и запрашивайте статус операции по нему:

GET /api/v1/operations/{id}

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

async function waitForResult(id: string) {
  while (true) {
    const response = await fetch(`https://bratuha.ru/api/v1/operations/${id}`, {
      headers: { Authorization: 'Bearer brth_ваш_ключ' },
    })
    const operation = await response.json()
    if (operation.status === 'completed' || operation.status === 'failed') {
      return operation
    }
    await new Promise((resolve) => setTimeout(resolve, 5000))
  }
}

Статус меняется с queued на processing, а затем на completed или failed. Обычно картинка готова за 40-60 секунд, но правка иногда занимает несколько минут. Опрашивать одну операцию можно не чаще раза в секунду, разумный интервал - 3-5 секунд.

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

{
  "type": "image",
  "urls": [
    "https://storage.bratuha.ru/results/imagineart-2-0/image-1.png"
  ]
}

• type - всегда "image".
• urls - массив из одной ссылки на PNG. Один запуск всегда даёт одну картинку, сколько бы изображений вы ни передали.

При генерации по тексту картинка создаётся в разрешении 2K в пропорциях aspect_ratio: например, при 16:9 получается 2816×1584 пикселей. При правке пропорции повторяют первое изображение, а размер модель выбирает сама и обычно увеличивает маленькие исходники: на пробе фото 640×480 вернулось картинкой 1760×1344.

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

Цена зависит только от числа ссылок в image_urls. Генерация по тексту и правка одного изображения стоят одинаково, каждое следующее изображение добавляет 1 ₽.

Пропорции и длина задания на цену не влияют. Стоимость списывается при создании операции и приходит в поле cost ответа.

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

• POST /api/v1/operations не идемпотентен: каждый повторный запрос создаёт новую оплаченную операцию. Если ответ потерялся, не повторяйте запрос вслепую.
• Все операции асинхронные: сначала приходит queued, результат забирается по id.
• Изображения передаются только ссылками http/https, которые открываются без авторизации. Форматы - JPG, JPEG, PNG или WebP, не больше 4 ссылок.
• При правке aspect_ratio не работает: чтобы получить другие пропорции, заранее обрежьте первое изображение или сгенерируйте картинку по тексту.
• Порядок ссылок важен: пропорции берутся с первого изображения, а в задании удобно ссылаться на «первое» и «второе» изображение.
• Правка меняет то, что вы попросили, но может сохранить часть исходной сцены. Если результат изменился слишком слабо, сформулируйте задание подробнее: не «сделай зиму», а что именно покрыть снегом и что оставить.
• Если операция завершилась ошибкой «сервис временно недоступен», запустите задание ещё раз чуть позже.