Recraft

Recraft V4.1

recraft-v4.1-flash/text-to-image

Производственная модель генерации дизайнерских ресурсов с нативным редактируемым выводом SVG-векторов, стабильно создающая изображения по коротким подсказкам, подходит для иконок, типографики и брендовых иллюстраций

recraft-v4.1-flash/text-to-image recraft-v4.1/text-to-image

Попробовать recraft-v4.1-flash/text-to-image

Ввод

Colors

Работы

Все работы

Вывод

image

Заполните параметры и сгенерируйте — результаты появятся здесь.

Апокалиптическая теплица: концепт-арт сцены Recraft V4.1

Стиль Концепт-арт · Построение мира · Научная фантастика

Промпт

Широкоформатный кинематографичный концепт-арт: огромный заброшенный геодезический купол теплицы, вновь захваченный буйно разросшейся растительностью, одинокая фигура в потрёпанном экзоскелетном костюме стоит на ржавом настиле, сквозь треснувшие стеклянные панели виден силуэт городского скайлайна, подсвеченного грозой; искусственные лампы для растений всё ещё отбрасывают бирюзово-зелёные блики сквозь листву, воздух наполнен туманом и парящей пылью, сдержанная цветовая гамма построена на бирюзово-зелёных, ржаво-красных и холодных бетонно-серых тонах, светотень с мягкими плавными градиентами, опоры купола передают гладкую объёмность, близкую к 3D-рендеру, сочетая живописность с качеством дизайна, готовым к производству, горизонтальная композиция 16:9, сильная глубина от переднего перила до дальнего скайлайна, насыщенный атмосферный свет, без текста

Скопируйте полный промпт и адаптируйте под свою задачу.

Теги

Цены

recraft-v4.1-flash/text-to-image per image

Цена за единицу	$0.010

Краткое описание

Recraft V4.1 Flash — это быстрый вариант в серии Recraft V4.1, ориентированный на генерацию изображений по тексту. Он вызывается через единый интерфейс HiAPI.ai: достаточно ввести текстовый запрос, чтобы получить изображение. Модель продолжает дизайнерскую направленность серии, показывает высокую степень готовности в задачах иллюстраций, иконок и брендовой визуализации, а также позволяет получать достаточно стабильные результаты по коротким запросам. Подходит разработчикам и дизайн-командам, которым нужна пакетная генерация изображений и встраивание этапа генерации в автоматизированные контент-процессы.

Ключевые особенности

Ориентация на дизайн-активы — в отличие от универсальных моделей изображений, сильнее ориентирована на производственные дизайн-результаты: иконки, иллюстрации и брендовую визуализацию, а не только на визуальные превью.
Стабильный результат по короткому запросу — краткое описание даёт достаточно ясную композицию и эстетическое направление, снижая нагрузку на prompt engineering с многократной настройкой параметров.
Опциональное управление палитрой и цветом фона — поддерживается указание предпочтительной цветовой схемы и цвета фона через значения RGB, что помогает сохранять единый стиль серии материалов across several images.
Несколько предустановленных соотношений и размеров — доступны шесть предустановок размеров в квадратном, 4:3 и 16:9 форматах, как горизонтальных, так и вертикальных, что покрывает типовые макеты: изображения для соцсетей, вертикальные постеры и баннеры.

Описание возможностей

Генерация изображений по тексту: достаточно ввести текстовый запрос, чтобы получить изображение; запрос может содержать до десяти тысяч символов и описывать объект, стиль и детали сцены — подходит для подключения к автоматизированным процессам генерации.

Управление цветовой схемой и цветом фона: можно указать предпочтительную палитру и цвет фона через объект RGB, чтобы пакетно сгенерированные материалы соответствовали единому визуальному стандарту.

Предустановки размеров вывода: встроены несколько предустановок размеров для квадратного формата и обоих соотношений — горизонтального и вертикального; при вызове макет выбирается сразу под место размещения, без последующей обрезки.

Сценарии применения

Пакетная генерация серийных материалов для брендовых и маркетинговых команд — массовое создание изображений для кампаний и рекламных материалов с единой палитрой и предустановками размеров, сразу под рекламные места и контент-план.
Интерфейсные иллюстрации и графика в UI/UX-дизайне — генерация интерфейсных иллюстраций и декоративной графики по краткому описанию; такие материалы можно использовать в дизайн-макетах, продуктовых страницах и прототипах.
Этап подбора изображений в контентных автоматизированных конвейерах — подключение вызова генерации к системе публикации для автоматического создания иллюстраций по статье или информации о товаре, что снижает объём ручной работы с каждым изображением.

Ограничения и рекомендации по выбору

Модель ориентирована на дизайн-активы и концептуальные исследования и не покрывает все потребности в генерации изображений; результаты, особенно цветовую схему и композицию, рекомендуется проверять вручную перед официальной передачей. Если нужен более качественный единичный результат, можно рассмотреть версию той же серии без приставки Flash. Этот вариант делает акцент на скорости генерации, поэтому для сценариев с предельной детализацией и сложной реалистичностью его следует оценивать осторожно.

Новости

Смотреть changelog →

Новая модель Новая модель: recraft-v4.1-flash/text-to-image Nov 3, 2026
Новая модель Добавлена документация по генерации изображений recraft-v4.1-flash/text-to-image Oct 16, 2026

Частые вопросы

Все частые вопросы →

В чём разница между Recraft V4.1 и V4.1 Flash?

V4.1 уделяет больше внимания деталям и завершённости, а Flash работает быстрее и подходит для массовых пробных вариантов.
Какие размеры поддерживаются?

Для image_size доступны шесть вариантов: square_hd (по умолчанию), square, portrait_4_3, portrait_16_9, landscape_4_3, landscape_16_9.
Как указать цветовую схему?

Через API передайте colors (массив объектов RGB) и background_color (один объект RGB), значения каждого канала — от 0 до 255. В онлайн-Playground эти два параметра пока недоступны.
Строго ли соблюдаются параметры цветовой палитры?

colors — это предпочтительная палитра: изображение будет по возможности выдержано в этих цветах; если в промпте указан явно конфликтующий цвет, результат может смешать оба варианта.

Создать задачу генерации

POST https://api.hiapi.ai/v1/tasks

Заголовки

AuthorizationstringОбязательно

API-ключ аккаунта. Обязателен в каждом запросе. Пример: Bearer YOUR_HIAPI_API_KEY. Получить API-ключ

Content-TypestringНеобязательно

Тело запроса всегда разбирается как JSON; при отправке принимается только application/json (charset опционален) — любое иное значение возвращает 415. Пример: application/json.

Idempotency-KeystringНеобязательно

Ключ идемпотентности, до 255 байт. Повторные запросы с тем же ключом того же аккаунта создают задачу лишь один раз; реплеи возвращают исходный taskId.

Ключ идемпотентности

При сетевых таймаутах или автоповторах клиента один и тот же ключ создаёт задачу только один раз, без двойного списания (область = аккаунт API-ключа). Рекомендуется бизнес-уникальный идентификатор (напр. "order-42"); реплеи возвращают исходный taskId, ключ истекает через 24 часа после первого запроса. Полная матрица сценариев — во введении единого асинхронного API.

Тело запроса

modelstringОбязательно

Текущее фиксированное значение: recraft-v4.1-flash/text-to-image

routestringНеобязательно

Текущее фиксированное значение: default

inputobjectОбязательно

Объект бизнес-параметров для recraft-v4.1-flash/text-to-image и маршрута default — см. таблицу параметров ниже.

colorsarrayНеобязательно

Предпочтительная цветовая палитра — массив объектов RGB-цветов, каждый объект содержит значения каналов от 0 до 255; используется для ограничения основной цветовой гаммы генерируемого изображения.

Array [ object ]

Элементы массива

bintegerОбязательноmin 0max 255

Значение синего канала отдельного цвета в палитре — целое число от 0 до 255.

gintegerОбязательноmin 0max 255

Значение зелёного канала отдельного цвета в палитре — целое число от 0 до 255.

rintegerОбязательноmin 0max 255

Значение красного канала отдельного цвета в палитре — целое число от 0 до 255.

promptstringОбязательноminLength 1maxLength 10000

Текстовое описание изображения для генерации, то есть промпт.

image_sizestringНеобязательноПо умолчанию: "square_hd"

Пресет размера выходного изображения — название пресета в виде строки, по умолчанию square_hd.

Варианты:square_hdsquareportrait_4_3portrait_16_9landscape_4_3landscape_16_9

background_colorobjectНеобязательно

Предпочтительный цвет фона — объект RGB-цвета, значения каждого канала от 0 до 255.

bintegerОбязательноmin 0max 255

Значение синего канала цвета фона — целое число от 0 до 255.

gintegerОбязательноmin 0max 255

Значение зелёного канала цвета фона — целое число от 0 до 255.

rintegerОбязательноmin 0max 255

Значение красного канала цвета фона — целое число от 0 до 255.

callbackobjectНеобязательно

Настройка уведомления о терминальном состоянии. Если не задана — обратных вызовов нет, опрашивайте задачу сами.

Обратные вызовы (Webhook)

Укажите callback.url при создании, и HiAPI отправит POST вашему сервису в терминальном состоянии — опрос не нужен. Тело callback повторяет структуру деталей задачи; проверка подписи, повторы и идемпотентность описаны во введении единого асинхронного API.

urlstringОбязательно

Обязательна при наличии callback. В терминальном состоянии на этот URL отправляется POST; это должна быть корректная http(s)-ссылка.

whenstringНеобязательноПо умолчанию: "final"

Сейчас поддерживается только final — уведомление и при success, и при fail.

Варианты:final

storagestringНеобязательноПо умолчанию: "temp"

Уровень хранения артефактов: temp (по умолчанию, ~7 дней) или persistent (долгосрочно, оплата по объёму). При нехватке баланса или превышении лимита — тихое понижение до temp; фактический уровень виден в ответе деталей задачи.

Варианты:temppersistent

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

# Отправляет асинхронную задачу; сразу возвращает taskId (не ждёт генерации)
curl -X POST "https://api.hiapi.ai/v1/tasks" \
  -H "Authorization: Bearer $HIAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "recraft-v4.1-flash/text-to-image",
  "input": {
    "prompt": "…",
    "image_size": "square_hd"
  }
}'

const res = await fetch("https://api.hiapi.ai/v1/tasks", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.HIAPI_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    model: "recraft-v4.1-flash/text-to-image",
    input: {
      "prompt": "…",
      "image_size": "square_hd"
    }
  }),
});
const task = await res.json();
// { code: 200, message: "success", data: { taskId } }

import os, requests

res = requests.post(
    "https://api.hiapi.ai/v1/tasks",
    headers={"Authorization": f"Bearer {os.environ['HIAPI_API_KEY']}"},
    json={
        "model": "recraft-v4.1-flash/text-to-image",
        "input": {
          "prompt": "…",
          "image_size": "square_hd"
        }
    },
)
print(res.json())  # { code, message, data: { taskId } }

200 OK

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR"
  }
}

400 Bad Request

{
  "code": 400,
  "message": "invalid request",
  "data": null,
  "error_code": "INVALID_REQUEST"
}

Получить детали задачи

GET https://api.hiapi.ai/v1/tasks/:id

Поля ответа

taskIdstringОбязательно

Идентификатор задачи, всегда с префиксом tk-hiapi-.

modelstringОбязательно

Полное разрешённое имя модели. Задачи, отправленные с параметром route, возвращают base@route (напр. gpt-image-2/text-to-image@ext); иначе совпадает с переданным именем.

routestringНеобязательно

Присутствует только при явном параметре route; повторяет переданное значение.

statusstringОбязательно

Статус задачи.

Значения статуса

queued В очереди, ещё не начата. handling Обрабатывается. archiving Обработка завершена, готовятся артефакты. success Терминальное: завершено, артефакты доступны (возвращается output). fail Терминальное: ошибка (возвращается error). После отправки следите за status: success и fail — терминальные, остальные нет. Опрашивайте каждые 1–3 с до терминального состояния. При успехе скачайте артефакты из output[].url и перенесите до expireAt; для длительного хранения укажите storage: "persistent" при создании.

creatednumberОбязательно

Время создания задачи (Unix-секунды).

completednumberОбязательно

Unix-секунды терминального состояния; до этого — 0.

outputarrayНеобязательно

Только при status == success. Список артефактов — всегда массив; одна задача может вернуть несколько type сразу (напр. video + first_frame).

Array [ object ]

Элементы массива

urlstringОбязательно

URL артефакта, доступен для скачивания напрямую.

typestringОбязательно

Текущие возможные значения: video, image, audio, first_frame, last_frame, thumbnail; список может расширяться.

expireAtnumberОбязательно

Unix-секунды доступности артефакта; скачайте или перенесите до истечения.

errorobjectНеобязательно

Только при status == fail.

codestringОбязательно

Бизнес-код ошибки.

messagestringОбязательно

Описание ошибки.

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

Успех

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR",
    "model": "happyhorse-1-0",
    "status": "success",
    "created": 1777282033,
    "completed": 1777282099,
    "output": [
      {
        "url": "https://cdn.hiapi.ai/tasks/.../video.mp4",
        "type": "video",
        "expireAt": 1777886899
      }
    ]
  }
}

Обработка (не финальное)

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-...",
    "model": "happyhorse-1-0",
    "status": "archiving",
    "created": 1777282033,
    "completed": 0
  }
}

Ошибка

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-...",
    "model": "happyhorse-1-0",
    "status": "fail",
    "created": 1777282033,
    "completed": 1777282099,
    "error": {
      "code": "TASK_FAILED",
      "message": "task failed"
    }
  }
}