Recraft
Recraft V4.1
recraft-v4.1/text-to-image
Производственная модель генерации дизайнерских ресурсов с нативным редактируемым выводом SVG-векторов, стабильно создающая изображения по коротким подсказкам, подходит для иконок, типографики и брендовых иллюстраций
Попробовать recraft-v4.1/text-to-image
Ввод
Работы
Все работыВывод
imageЦены
recraft-v4.1/text-to-image per image
| Цена за единицу | $0.050 |
|---|
Позиционирование и краткое описание
Recraft V4.1 — это модель генерации дизайн-активов, ориентированная на производство: она склонна выдавать готовые результаты, которые можно сразу пустить в дизайн-процесс, а не концепт-изображения для предварительного просмотра. Помимо обычных растровых изображений, она хорошо справляется с задачами по иконкам, типографике и брендовым иллюстрациям: короткий промпт даёт достаточно стабильную эстетику и композицию, а также поддерживает ограничение изображения параметрами цвета и фона. Подходит дизайн-командам и разработчикам, которым нужно массово выпускать маркетинговые материалы, UI-иллюстрации или векторную графику и подключать автоматизацию контента через единый интерфейс HiAPI.ai.
Ключевые особенности
- Генерация в логике дизайн-активов — ориентация на готовый результат, а не на атмосферный набросок; задачи по иконкам, типографике и иллюстрациям получаются более завершёнными, что снижает необходимость последующей перерисовки.
- Стабильный стиль даже при коротком промпте — краткого описания достаточно для получения достаточно точного направления эстетики и композиции, что снижает затраты на отладку промптов.
- Параметрическое ограничение палитры и фона — RGB-палитра и параметр цвета фона задают цвета изображения, что помогает соответствовать брендовым цветам и единому визуальному стилю.
- Шесть пресетов формата покрывают типовые макеты — доступны квадратные, вертикальные и горизонтальные пропорции; один вызов позволяет подобрать формат для соцсетей, веба и печати.
Описание возможностей
Генерация изображений по тексту: достаточно ввести текстовое описание длиной до десяти тысяч символов, чтобы получить изображение; поддерживаются реализм, иллюстрация, 3D-рендеринг и градиенты — удобно для прямого превращения творческого описания в пригодный материал.
Управление брендовыми цветами: можно передать набор RGB-цветов в качестве предпочтительной палитры и отдельно указать цвет фона, закрепляя брендовые цвета или визуальные стандарты серии в результате генерации и снижая затраты на подбор цветов для каждого изображения.
Выбор пресета формата: доступны шесть пресетов размера — square_hd, square, portrait_4_3, portrait_16_9, landscape_4_3, landscape_16_9; пропорция выбирается сразу под площадку размещения, что избавляет от последующей обрезки.
Пакетная генерация через API: вызов через единый интерфейс HiAPI.ai позволяет встроить генерацию в собственные инструменты и пакетные процессы; оплата за изображение, что подходит для автоматизированной генерации больших объёмов контента.
Сценарии применения
- Массовая генерация маркетинговых материалов для бренд-команд — введите тему кампании и брендовые цвета, чтобы массово выпускать рекламные изображения и материалы для соцсетей в едином стиле, сразу пригодные для размещения и контент-плана.
- Создание иллюстраций для интерфейсов дизайнерами UI/UX — с помощью короткого описания и заданного формата генерируйте изображения и иллюстрации для интерфейсов, получая визуальные активы, которые можно поместить на страницы продукта и в макеты.
- Автоматическая подборка изображений для контент-систем — программа собирает промпт по теме статьи и вызывает интерфейс, стабильно создавая иллюстрации для контент-платформы и сокращая ручной поиск и правку изображений.
- Исследование концепций и эксперименты со стилем — с помощью нескольких коротких промптов быстро подбирайте атмосферные изображения и направления стиля как визуальный референс на этапе предложения, а затем определяйте путь официальной разработки.
Ограничения и рекомендации по выбору
Модель ориентирована на дизайн-активы и исследование концепций и не покрывает все потребности в генерации изображений; результаты с типографикой и тонкой графикой рекомендуется проверять вручную перед официальной передачей. Параметры поддерживают только промпт, палитру, цвет фона и пресеты формата; редактирование маской, референсные изображения и локальная перерисовка не поддерживаются. Если требуется реалистичная фотография с высокой степенью свободы или сложное многораундовое редактирование, стоит оценить другие модели с более выраженным фокусом на универсальную генерацию и редактирование; если проект уже стандартизирован на старой версии, можно продолжить использовать существующую версию, чтобы снизить затраты на переход.
Новости
Смотреть changelog →- Новая модель Новая модель: recraft-v4.1-flash/text-to-image
- Новая модель Добавлена документация по генерации изображений recraft-v4.1-flash/text-to-image
Частые вопросы
Все частые вопросы →-
В чём разница между 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 — это предпочтительная палитра: изображение будет по возможности выдержано в этих цветах; если в промпте указан явно конфликтующий цвет, результат может смешать оба варианта.
Создать задачу генерации
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/text-to-image
routestringНеобязательноТекущее фиксированное значение: default
inputobjectОбязательно
Объект бизнес-параметров для recraft-v4.1/text-to-image и маршрута default — см. таблицу параметров ниже.
colorsarrayНеобязательно
Задает предпочтительную цветовую схему в виде массива RGB-объектов, каждый канал в диапазоне 0–255; структура элемента массива определяется полями b/g/r.
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_9background_colorobjectНеобязательно
Предпочтительный цвет фона в виде RGB-объекта, каждый канал в диапазоне 0–255; конкретные каналы определяются полями b/g/r.
bintegerОбязательноmin 0max 255Значение синего канала цвета фона, целое число, диапазон 0–255.
gintegerОбязательноmin 0max 255Значение зеленого канала цвета фона, целое число, диапазон 0–255.
rintegerОбязательноmin 0max 255Значение красного канала цвета фона, целое число, диапазон 0–255.
callbackobjectНеобязательно
Настройка уведомления о терминальном состоянии. Если не задана — обратных вызовов нет, опрашивайте задачу сами.
Укажите callback.url при создании, и HiAPI отправит POST вашему сервису в терминальном состоянии — опрос не нужен. Тело callback повторяет структуру деталей задачи; проверка подписи, повторы и идемпотентность описаны во введении единого асинхронного API.
urlstringОбязательноОбязательна при наличии callback. В терминальном состоянии на этот URL отправляется POST; это должна быть корректная http(s)-ссылка.
whenstringНеобязательноПо умолчанию: "final"Сейчас поддерживается только final — уведомление и при success, и при fail.
finalstoragestringНеобязательноПо умолчанию: "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/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/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/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"
} Получить детали задачи
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"
}
}
} Статьи
Все статьи →-
Руководство
kandinsky-6.0-pro/image-to-video в HiAPI: руководство по curl + Python
Как выполнить рабочий запрос генерации видео из изображения в HiAPI: от загрузки первого кадра до асинхронного опроса и финальной загрузки
-
Руководство
Как вызывать kling-4.0/image-to-video на HiAPI: curl, Python и опрос
-
Руководство
Как вызывать hailuo-2.3/text-to-video через API HiAPI: curl, Python и рабочие примеры запросов
-
Руководство
Как вызвать hailuo-2.3-fast/image-to-video через HiAPI API: практика с curl и Python
Первый рабочий запрос к быстрому и недорогому уровню генерации видео по изображению — от ID модели до загрузки MP4
-
Руководство
Как использовать kling-4.0/text-to-video через HiAPI API: curl, Python и рабочий пример запроса
Практическое руководство для разработчиков: кинематографичные промпты, синхронный звук, асинхронный опрос и скачивание результатов
-
Руководство
Использование Kandinsky 6.0 Pro для преобразования текста в видео на HiAPI: руководство по curl и Python
Практическая демонстрация с упором на запросы: построение вызова от промпта до видеоклипа, отправка запроса, опрос статуса завершения и скачивание результата
Похожие модели
Все модели →Тот же тип
-
Qwen Image 3.0 Alibaba $0.036 /изображение -
Google Virtual Try-On Google $0.107 /изображение -
Recraft Creative Upscale Recraft $0.357 /изображение -
Seedream 4.5 ByteDance $0.045 /изображение -
Seedream 5.0 ByteDance $0.025 /изображение -
Ideogram V3 Character Ideogram $0.090 /изображение -
FIBO 1.5 Bria $0.058 /изображение -
Krea 2 Medium Turbo Krea $0.021 /изображение -
Grok Imagine Image 2.0 xAI $0.052 /изображение -
Imagen 4 Google $0.030 /изображение -
BRIA Product Shot Bria $0.058 /изображение -
Ideogram V4 Ideogram $0.050 /изображение



