Гайды

Как подключить API Recraft: первый запрос

22 октября 2026 · 9 минут чтения

Проверка фактов

Юлия Найпак

Методист по автоматизации. Сверяет паспорт инструмента с документацией вендора.

Автор Р

Редакция

Коллектив авторов, редакторов и иллюстраторов статей на сайте блога онлайн-университета «Зерокодер». Пишем…

Черновик готовит редакция с помощью ИИ. За стандарт издания отвечает главный редактор — Валерий Курземнек.

Материал редакции Зерокодера. Счёт по выдаче снят собственным прогоном 22 октября 2026 года; цитаты источников приведены дословно. Обновлено: октябрь 2026.

Как подключить API Recraft: первый запрос строится вокруг одного действия — вы кладёте токен в переменную окружения и отправляете POST на адрес генерации изображений. Recraft API даёт программный доступ к моделям генерации и редактирования изображений и векторов, как описывает назначение сервиса страница recraft.ai/api. Дальше разберём условия доступа, порядок первого запроса, учебный пример и диагностику ошибок. Мы скачали подборку результатов веб-поиска по запросу «Как подключить API Recraft: первый запрос»: текст отдали 9 из 9.

Что даёт API Recraft и где проходят границы продукта

Страница recraft.ai/api описывает API как способ встроить генерацию и редактирование изображений в свои продукты, внутренние инструменты и автоматизированные конвейеры. Один унифицированный интерфейс закрывает растровые изображения, векторы и правки через inpainting. Среди заявленных возможностей — изображения, векторы, вывод в высоком разрешении и пакетные операции; inpainting, outpainting, удаление фона и редактирование естественным языком; более сотни готовых стилей для единообразия визуальной системы; генерация с низкой задержкой и асинхронные задачи для больших объёмов.

Границы стоит держать в голове с самого начала. API — это программный слой: вы работаете не кнопками в браузере, а HTTP-запросами из своего кода. Документация recraft.ai перечисляет отдельные семейства операций: создание стиля из референсных изображений, image-to-image, inpainting и outpainting, замену и удаление фона, векторизацию, апскейл, улучшение деталей, стирание области и ремикс. Каждая операция вызывается своим эндпоинтом, и первый запрос удобнее строить на самой простой из них — генерации изображения по текстовому описанию.

Сценарии, под которые API рассчитан, страница recraft.ai/api называет прямо: генерация визуалов внутри продукта для клиентов или авторов, автоматическая иллюстрация и генерация иконок для контент-команд, творческие эксперименты и A/B-тесты, быстрая подготовка вариаций для рекламы и кампаний. Для корпоративных сценариев заявлены большие объёмы генерации, приоритетный вывод, контроль стиля и бренда, а также интеграция MCP для подключения генерации к существующим системам.

Отдельно про доступность из России: страница recraft.ai/api и справочник не описывают региональные условия работы. Для планирования интеграции этот вопрос стоит уточнять у вендора до старта разработки.

Условия доступа и где смотреть актуальные требования

Доступ к API строится на токене. Справочник recraft.ai в разделе начала работы показывает переменную окружения RECRAFT_API_TOKEN, в которую кладётся ваш ключ, и заголовок Authorization: Bearer RECRAFT_API_TOKEN в каждом запросе. Токен — единственный идентификатор вызова, поэтому его хранение в коде и в репозитории создаёт риск утечки.

Источник актуальных требований — справочник API на recraft.ai. Его раздел Pricing and Limits and sizes собирает цены, размеры, лимиты промптов и ограничения по частоте запросов; раздел Endpoints перечисляет каждую операцию с её параметрами; раздел Clients and SDKs описывает работу через обычный HTTP или библиотеку OpenAI для Python. Там же есть раздел Use with AI tools про llms.txt, Markdown-страницы и навык Claude Code.

Способов отправки запроса документация называет несколько. Первый — любой HTTP-клиент: curl, requests, fetch. Второй — библиотека OpenAI для Python с указанием базового адреса https://external.api.recraft.ai/v1 и вашего токена в качестве ключа. Для Node.js документация приводит пример на встроенном fetch, работающий как ES-модуль.

Оплата устроена по кредитам: страница recraft.ai/api сообщает, что использование API тарифицируется по кредитам, списываемым за запрос, а цена зависит от операции и типа вывода. Конкретные тарифы живут на странице цен API, и их стоит сверять перед запуском регулярных задач.

Порядок действий: от токена до первого изображения

Первый запрос удобно разбить на четыре шага. Сначала положите токен в переменную окружения командой export RECRAFT_API_TOKEN=your_token, как в разделе начала работы справочника recraft.ai; знак равенства пишется без пробелов, иначе оболочка не присвоит значение. Держите токен вне кода: так он не попадает в историю репозитория.

Второй шаг — выберите эндпоинт. Для генерации изображения по тексту справочник указывает POST https://external.api.recraft.ai/v1/images/generations. Рядом документация приводит отдельные адреса для растрового и векторного вывода: POST .../images/generations/raster и POST .../images/generations/vector. Для первого запуска достаточно общего адреса генерации.

Третий шаг — соберите тело запроса. Минимально оно состоит из поля prompt с текстовым описанием. Документация показывает пример с описанием гоночной машины на трассе. Если нужен вектор, добавьте поле model со значением вроде recraftv4_1_vector, как это делает раздел introduction.

Четвёртый шаг — отправьте запрос и прочитайте ответ. Пример на curl из справочника выглядит так: адрес генерации, заголовок авторизации с токеном, заголовок типа содержимого и тело с промптом. Ответ приходит в JSON с полями created, credits и массивом data, где лежат image_id и url. Ссылку из data[0].url можно открыть и посмотреть результат.

Порядок одинаков для всех языков. В Python документация предлагает либо requests.post с заголовком авторизации, либо клиент OpenAI с базовым адресом Recraft. В Node.js — fetch с методом POST и телом в JSON. Логика везде одна: токен в заголовке, промпт в теле, ссылка на изображение в ответе.

Учебный пример и критерии самостоятельной проверки

Возьмём задачу, которую легко проверить глазами: сгенерировать плоскую векторную иллюстрацию лисы в зимнем лесу. Документация recraft.ai приводит похожий пример с промптом про красную лису в заснеженном лесу в плоском векторном стиле и моделью recraftv4_1_vector. Такой запрос возвращает векторный файл, пригодный для дальнейшей работы.

Промпт для первого запуска:

Сгенерируй плоскую векторную иллюстрацию: [ваш объект] в стиле [ваш стиль], палитра [ваши цвета], фон [ваше описание фона]. Верни векторный файл, пригодный для печати и веба.

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

Критерии проверки первого запроса:

• ответ пришёл со статусом успеха и содержит массив data с полем url;
• ссылка открывается и отдаёт изображение;
• в ответе видно поле credits — оно показывает, сколько кредитов списал запрос;
• стиль результата совпадает с описанием в промпте;
• для векторного запроса файл открывается в редакторе векторов.

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

Смежные варианты запросов и что выбирать по задаче

Документация recraft.ai перечисляет несколько семейств операций, и выбор зависит от задачи. Для генерации с нуля подходит POST /images/generations. Для правки существующего изображения есть POST /images/imageToImage. Для работы со стилем — POST /styles, создающий переиспользуемый стиль из референсных изображений. Список своих стилей отдаёт GET /styles, удаление — DELETE /styles/{id}.

Отдельная группа — управление цветом. Документация показывает передачу палитры через поле controls с массивом цветов в формате RGB и весом каждого цвета, а также фоновый цвет. Тот же приём работает при создании стиля: палитра передаётся вместе с референсными изображениями. Это удобно, когда нужно удержать фирменные цвета в серии иллюстраций.

Для проверки токена удобен запрос к /users/me: он возвращает данные пользователя и подтверждает, что авторизация настроена. Документация приводит примеры на requests, на клиенте OpenAI и на curl.

Типичные проблемы и проверяемые способы диагностики

Первая частая проблема — ошибка авторизации. Проверьте, что токен лежит в переменной окружения и подставляется в заголовок Authorization с префиксом Bearer. Документация показывает формат Authorization: Bearer RECRAFT_API_TOKEN; если переменная пуста, заголовок уйдёт без ключа.

Вторая — неверный адрес. Базовый адрес из справочника: https://external.api.recraft.ai/v1. Если указать другой хост или забыть версию, запрос не дойдёт до нужного эндпоинта. Сверяйте адрес с разделом Endpoints.

Третья — ошибка в теле запроса. Поле prompt обязательно для генерации. Для векторного вывода нужен параметр model. Документация показывает, что ответ приходит с полями created, credits и data; если массив data пуст, проверьте тело запроса.

Четвёртая — превышение лимитов. Раздел Pricing and Limits and sizes собирает ограничения по частоте и размеры. Справочник в разделе Clients and SDKs уточняет, что каждый запрос синхронный: соединение держится открытым, пока изображения не готовы, идентификаторов задач для опроса и вебхуков нет. Для больших объёмов он советует отправлять запросы параллельно в пределах лимитов частоты или просить несколько изображений за один запрос параметром n. Таймаут HTTP-клиента там же предлагают задавать явно и с запасом под самую медленную модель.

Пятая — расхождение результата с ожиданием. Проверьте, что стиль и палитра описаны в промпте, а для векторного вывода выбран соответствующий эндпоинт или модель. Документация показывает передачу палитры через controls и через palette при создании стиля.

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

Для чего вообще нужен API Recraft?

Страница recraft.ai/api описывает API как программный доступ к моделям генерации и редактирования изображений и векторов. Его встраивают в продукты, внутренние инструменты и автоматизированные конвейеры. Сценарии включают генерацию визуалов для клиентов, автоматическую иллюстрацию для контент-команд, A/B-тесты и подготовку рекламных вариаций.

Какие возможности доступны через API?

Страница recraft.ai/api перечисляет генерацию изображений и векторов, редактирование по промпту, удаление фона, inpainting и outpainting и пакетные задачи. Отдельно есть создание переиспользуемых стилей из референсов. Полный список операций собран в справочнике API.

Как устроена оплата использования API?

Страница recraft.ai/api сообщает, что использование тарифицируется по кредитам, списываемым за запрос. Цена зависит от операции и типа вывода. Полные условия собраны на странице цен API.

Можно ли получать векторы и готовые к производству файлы?

Да. Страница recraft.ai/api указывает, что API поддерживает векторный вывод и растровые изображения в высоком разрешении, пригодные для производственных задач, включая иконки и иллюстрации. Для векторного вывода есть отдельный эндпоинт и модель.

Как Recraft справляется с большими объёмами?

Страница recraft.ai/api называет пакетную генерацию и приоритетный вывод для высоких нагрузок. Справочник уточняет, что каждый запрос синхронный, поэтому большие объёмы набирают параллельными запросами в пределах лимитов частоты или несколькими изображениями в одном запросе. Для корпоративных сценариев заявлены контроль стиля и бренда и интеграция MCP.

Полезные материалы по теме: лучшая нейросеть для дизайнеров, ИИ для изображений, нейросеть для фотокарточек.