Recraft V4 API

Recraft V4 API

Recraft V4 рисует по текстовому заданию обычные картинки и векторную графику. Она хорошо справляется с дизайн-задачами: плакаты, обложки, логотипы, иконки, наклейки и макеты с надписями прямо в кадре, в том числе на русском. Входные изображения модель не принимает - только текст.

Что можно получить:

• Изображение - растровая картинка в формате WebP (text_to_image).
• Вектор - SVG-файл, который масштабируется без потери качества (text_to_svg).

Каждый режим доступен в двух версиях: обычной (standard) и Pro (pro). Pro прорабатывает детали тщательнее и стоит дороже.

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

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

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

Режим выбирается параметром generation_type, версия модели - параметром model_tier:

• text_to_image - растровое изображение, пропорции задаёт image_size_image;
• text_to_svg - векторная графика, пропорции задаёт image_size_svg.

Тело запроса

{
  "tool": "recraft-v4",
  "input": {
    "generation_type": "text_to_image",
    "model_tier": "standard",
    "prompt": "...",
    "image_size_image": "3:4"
  }
}

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

Параметры

Параметр пропорций, который не относится к выбранному режиму, не учитывается. Например, в режиме text_to_svg значение image_size_image ни на что не влияет.

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

Изображение

cURL

curl -X POST https://bratuha.ru/api/v1/operations \
  -H "Authorization: Bearer brth_ваш_ключ" \
  -H "Content-Type: application/json" \
  -d '{
  "tool": "recraft-v4",
  "input": {
    "generation_type": "text_to_image",
    "model_tier": "standard",
    "prompt": "Плакат для книжного магазина: стопка книг и чашка чая на подоконнике, за окном дождь. Сверху крупная надпись «Читай осенью». Плоская иллюстрация, тёплые цвета.",
    "image_size_image": "3:4"
  }
}'

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: 'recraft-v4',
    input: {
      generation_type: 'text_to_image',
      model_tier: 'standard',
      prompt: 'Плакат для книжного магазина: стопка книг и чашка чая на подоконнике, за окном дождь. Сверху крупная надпись «Читай осенью». Плоская иллюстрация, тёплые цвета.',
      image_size_image: '3:4',
    },
  }),
})

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': 'recraft-v4',
        'input': {
            'generation_type': 'text_to_image',
            'model_tier': 'standard',
            'prompt': 'Плакат для книжного магазина: стопка книг и чашка чая на подоконнике, за окном дождь. Сверху крупная надпись «Читай осенью». Плоская иллюстрация, тёплые цвета.',
            'image_size_image': '3:4',
        },
    },
    timeout=30,
)

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

Вектор (SVG)

Результат придёт файлом .svg - его можно масштабировать для визитки или большого баннера без потери качества.

cURL

curl -X POST https://bratuha.ru/api/v1/operations \
  -H "Authorization: Bearer brth_ваш_ключ" \
  -H "Content-Type: application/json" \
  -d '{
  "tool": "recraft-v4",
  "input": {
    "generation_type": "text_to_svg",
    "model_tier": "standard",
    "prompt": "Наклейка для ноутбука: рыжая лиса в больших наушниках спит, свернувшись клубком, над ней надпись «Не беспокоить». Плоский стиль, толстая белая обводка, четыре цвета.",
    "image_size_svg": "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: 'recraft-v4',
    input: {
      generation_type: 'text_to_svg',
      model_tier: 'standard',
      prompt: 'Наклейка для ноутбука: рыжая лиса в больших наушниках спит, свернувшись клубком, над ней надпись «Не беспокоить». Плоский стиль, толстая белая обводка, четыре цвета.',
      image_size_svg: '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': 'recraft-v4',
        'input': {
            'generation_type': 'text_to_svg',
            'model_tier': 'standard',
            'prompt': 'Наклейка для ноутбука: рыжая лиса в больших наушниках спит, свернувшись клубком, над ней надпись «Не беспокоить». Плоский стиль, толстая белая обводка, четыре цвета.',
            'image_size_svg': '1:1',
        },
    },
    timeout=30,
)

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

Версия Pro

Любой режим можно запустить в версии Pro - достаточно передать "model_tier": "pro".

cURL

curl -X POST https://bratuha.ru/api/v1/operations \
  -H "Authorization: Bearer brth_ваш_ключ" \
  -H "Content-Type: application/json" \
  -d '{
  "tool": "recraft-v4",
  "input": {
    "generation_type": "text_to_image",
    "model_tier": "pro",
    "prompt": "Рекламный плакат кофейни: бумажный стакан тыквенного латте на деревянном столе у окна, рядом маленькие тыквы и осенние листья. Сверху крупная надпись «Тыквенный латте». Тёплый вечерний свет.",
    "image_size_image": "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: 'recraft-v4',
    input: {
      generation_type: 'text_to_image',
      model_tier: 'pro',
      prompt: 'Рекламный плакат кофейни: бумажный стакан тыквенного латте на деревянном столе у окна, рядом маленькие тыквы и осенние листья. Сверху крупная надпись «Тыквенный латте». Тёплый вечерний свет.',
      image_size_image: '16:9',
    },
  }),
})

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': 'recraft-v4',
        'input': {
            'generation_type': 'text_to_image',
            'model_tier': 'pro',
            'prompt': 'Рекламный плакат кофейни: бумажный стакан тыквенного латте на деревянном столе у окна, рядом маленькие тыквы и осенние листья. Сверху крупная надпись «Тыквенный латте». Тёплый вечерний свет.',
            'image_size_image': '16:9',
        },
    },
    timeout=30,
)

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

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

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

{
  "id": "op_uuid-123",
  "status": "queued",
  "tool": "recraft-v4",
  "cost": 7,
  "balance_after": 493,
  "created_at": "2026-09-30T19:50:36.764854+00:00"
}

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

{
  "id": "op_uuid-123",
  "status": "completed",
  "tool": "recraft-v4",
  "cost": 7,
  "created_at": "2026-09-30T19:50:36.764854+00:00",
  "completed_at": "2026-09-30T19:51:02.490825+00:00",
  "result": {
    "type": "image",
    "urls": [
      "https://storage.bratuha.ru/results/recraft-v4/image-1.webp"
    ]
  },
  "error_message": null
}

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

{
  "id": "op_uuid-123",
  "status": "completed",
  "tool": "recraft-v4",
  "cost": 15,
  "created_at": "2026-09-30T19:55:10.114532+00:00",
  "completed_at": "2026-09-30T19:55:41.871204+00:00",
  "result": {
    "type": "file",
    "files": [
      {
        "url": "https://storage.bratuha.ru/results/recraft-v4/vector-1.svg",
        "name": "result"
      }
    ]
  },
  "error_message": null
}

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

{
  "id": "op_uuid-123",
  "status": "failed",
  "tool": "recraft-v4",
  "cost": 7,
  "created_at": "2026-09-30T19:50:36.764854+00:00",
  "completed_at": "2026-09-30T19:50:49.520117+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-40 секунд. Опрашивать одну операцию можно не чаще раза в секунду, разумный интервал - 3-5 секунд.

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

Форма result зависит от режима.

Для text_to_image:

{
  "type": "image",
  "urls": [
    "https://storage.bratuha.ru/results/recraft-v4/image-1.webp"
  ]
}

• type - "image".
• urls - массив с одной ссылкой на картинку в формате WebP.

Размер картинки зависит от пропорций и одинаков для standard и pro:

Для text_to_svg:

{
  "type": "file",
  "files": [
    {
      "url": "https://storage.bratuha.ru/results/recraft-v4/vector-1.svg",
      "name": "result"
    }
  ]
}

• type - "file".
• files - массив с одним SVG-файлом: url - ссылка на файл, name - служебное имя.

Если ваш код обрабатывает оба режима, проверяйте result.type: у изображения ссылки лежат в urls, у вектора - в files[].url.

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

Цена фиксирована за один запуск и зависит от режима и версии модели. Длина задания и пропорции на цену не влияют.

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

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

• POST /api/v1/operations не идемпотентен: каждый повторный запрос создаёт новую оплаченную операцию. Если ответ потерялся, не повторяйте запрос вслепую.
• Все операции асинхронные: сначала приходит queued, результат забирается по id.
• Модель работает только с текстом - ссылки на изображения не принимаются.
• Один запуск - один результат. Нужно несколько вариантов - отправьте несколько запросов.
• Задания проходят модерацию. Если запрос её не прошёл, операция завершится со статусом failed и сообщением «Ваш запрос не прошел модерацию.»
• Для надписей в кадре берите нужный текст в кавычки и прямо пишите, что других надписей быть не должно - так модель реже добавляет лишний текст.
• Вектор лучше всего подходит для логотипов, иконок, наклеек и типографики. Для фотореалистичных сцен берите text_to_image.