Изменить стиль API

Изменить стиль API

«Изменить стиль» перерисовывает фотографию в выбранной манере: аниме, Pixar, Ghibli, «Симпсоны», масляная живопись, Ван Гог, киберпанк и ещё два десятка вариантов. Композиция, поза и узнаваемость человека сохраняются, меняются линии, цвета и фактура.

Подходит для аватарок «как из мультфильма», открыток, обложек постов и развлекательных функций в приложениях: пользователь присылает фото, выбирает стиль и получает картинку. Задание писать не нужно - достаточно ссылки на фото и названия стиля.

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

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

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

Сценарий один - стилизация одного изображения. Результат определяется только выбранным стилем style.

Тело запроса

{
  "tool": "change-style",
  "input": {
    "inputImage": "https://cdn.example.com/photo-1.jpg",
    "style": "Pixar"
  }
}

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

Параметры

Доступные значения style:

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

Стилизация фото

cURL

curl -X POST https://bratuha.ru/api/v1/operations \
  -H "Authorization: Bearer brth_ваш_ключ" \
  -H "Content-Type: application/json" \
  -d '{
  "tool": "change-style",
  "input": {
    "inputImage": "https://cdn.example.com/portrait-1.jpg",
    "style": "Pixar"
  }
}'

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: 'change-style',
    input: {
      inputImage: 'https://cdn.example.com/portrait-1.jpg',
      style: 'Pixar',
    },
  }),
})

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': 'change-style',
        'input': {
            'inputImage': 'https://cdn.example.com/portrait-1.jpg',
            'style': 'Pixar',
        },
    },
    timeout=30,
)

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

Одно фото в нескольких стилях

Один запуск - один стиль. Чтобы получить несколько вариантов, отправьте несколько запросов с тем же фото. Каждый запрос - отдельная операция и отдельная оплата.

cURL

for style in "Ghibli" "Van Gogh" "Comic Book"; do
  curl -X POST https://bratuha.ru/api/v1/operations \
    -H "Authorization: Bearer brth_ваш_ключ" \
    -H "Content-Type: application/json" \
    -d "{\"tool\": \"change-style\", \"input\": {\"inputImage\": \"https://cdn.example.com/family-photo.png\", \"style\": \"$style\"}}"
done

JavaScript / TypeScript

const styles = ['Ghibli', 'Van Gogh', 'Comic Book']

const operations = await Promise.all(
  styles.map(async (style) => {
    const response = await fetch('https://bratuha.ru/api/v1/operations', {
      method: 'POST',
      headers: {
        Authorization: 'Bearer brth_ваш_ключ',
        'Content-Type': 'application/json',
      },
      body: JSON.stringify({
        tool: 'change-style',
        input: {
          inputImage: 'https://cdn.example.com/family-photo.png',
          style,
        },
      }),
    })
    return response.json()
  }),
)

console.log(operations.map((operation) => operation.id))

Python

import requests

styles = ['Ghibli', 'Van Gogh', 'Comic Book']
operation_ids = []

for style in styles:
    response = requests.post(
        'https://bratuha.ru/api/v1/operations',
        headers={
            'Authorization': 'Bearer brth_ваш_ключ',
            'Content-Type': 'application/json',
        },
        json={
            'tool': 'change-style',
            'input': {
                'inputImage': 'https://cdn.example.com/family-photo.png',
                'style': style,
            },
        },
        timeout=30,
    )
    operation_ids.append(response.json()['id'])

print(operation_ids)

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

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

{
  "id": "op_uuid-123",
  "status": "queued",
  "tool": "change-style",
  "cost": 6,
  "balance_after": 494,
  "created_at": "2026-09-30T12:45:51.977589+00:00"
}

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

{
  "id": "op_uuid-123",
  "status": "completed",
  "tool": "change-style",
  "cost": 6,
  "created_at": "2026-09-30T12:45:51.977589+00:00",
  "completed_at": "2026-09-30T12:46:16.616945+00:00",
  "result": {
    "type": "image",
    "urls": [
      "https://storage.bratuha.ru/results/change-style/image-1.jpg"
    ]
  },
  "error_message": null
}

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

{
  "id": "op_uuid-123",
  "status": "failed",
  "tool": "change-style",
  "cost": 6,
  "created_at": "2026-09-30T12:45:51.977589+00:00",
  "completed_at": "2026-09-30T12:46:02.431870+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. Обычно результат готов за 20-30 секунд. Опрашивать одну операцию можно не чаще раза в секунду, разумный интервал - 3-5 секунд.

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

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

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

Пропорции исходного фото сохраняются, размер результата около 1 мегапикселя. Например, фото 768×1152 возвращается размером 816×1232.

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

Цена фиксированная - 6 ₽ за одно изображение. Стиль, размер и формат исходного фото на цену не влияют.

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

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

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