# Recraft API
> Картинки Recraft и настоящий вектор SVG по описанию, версии V4.1 и V4.1 Pro. Правка вашей картинки: замена и стирание области по маске, расширение кадра, замена фона. Ещё похожие варианты, перевод в вектор, удаление фона и апскейл.
Разработчик: Recraft
Ключ модели в API: `recraft`
## Подключение в три шага
1. [Получите ключ](https://api.cyhub.ai/docs/connection.md?lang=ru): Ключ создаётся в кабинете после подтверждения почты. Один ключ открывает все модели.
2. [Узнайте цену](https://api.cyhub.ai/docs/generations.md?lang=ru): POST /v1/price считает стоимость запуска заранее, деньги при этом не списываются.
3. [Запустите задачу и заберите результат](https://api.cyhub.ai/docs/tasks.md?lang=ru): POST /v1/tasks ставит задачу, GET /v1/tasks/{id} показывает её статус и файлы.
## Готовый код
Замените YOUR_API_KEY своим ключом. Код ставит задачу и ждёт результата. В cURL второй запрос повторяйте, подставив вместо TASK_ID поле id из ответа первого, пока status не станет succeeded.
```bash
curl -X POST "https://api.cyhub.ai/v1/tasks" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
--data '{
"model": "recraft",
"settings": {
"mode": "text_to_image",
"prompt": "Деревянная вывеска кофейни с надписью «Утро», тёплый вечерний свет",
"engine": "v4_1",
"aspect_ratio": "3:2"
}
}'
curl "https://api.cyhub.ai/v1/tasks/TASK_ID" \
-H "Authorization: Bearer YOUR_API_KEY"
```
```python
import time
import requests
API = "https://api.cyhub.ai/v1"
HEADERS = {"Authorization": "Bearer YOUR_API_KEY"}
body = {
"model": "recraft",
"settings": {
"mode": "text_to_image",
"prompt": "Деревянная вывеска кофейни с надписью «Утро», тёплый вечерний свет",
"engine": "v4_1",
"aspect_ratio": "3:2",
},
}
response = requests.post(f"{API}/tasks", json=body, headers=HEADERS, timeout=60)
response.raise_for_status()
task = response.json()
while task["status"] in ("queued", "running"):
time.sleep(5)
task = requests.get(f"{API}/tasks/{task['id']}", headers=HEADERS, timeout=30).json()
print(task["status"], task["result"])
```
```javascript
const API = "https://api.cyhub.ai/v1";
const HEADERS = { Authorization: "Bearer YOUR_API_KEY", "Content-Type": "application/json" };
const body = {
"model": "recraft",
"settings": {
"mode": "text_to_image",
"prompt": "Деревянная вывеска кофейни с надписью «Утро», тёплый вечерний свет",
"engine": "v4_1",
"aspect_ratio": "3:2"
}
};
async function main() {
let response = await fetch(`${API}/tasks`, { method: "POST", headers: HEADERS, body: JSON.stringify(body) });
if (!response.ok) throw new Error(await response.text());
let task = await response.json();
while (task.status === "queued" || task.status === "running") {
await new Promise((resolve) => setTimeout(resolve, 5000));
response = await fetch(`${API}/tasks/${task.id}`, { headers: HEADERS });
task = await response.json();
}
console.log(task.status, task.result);
}
main();
```
[Получить ключ](https://cyhub.ai/cabinet/keys)
## Цена до запуска
Цены на 15.10.2026: от 1 ₽. Точную цену своих настроек покажет POST /v1/price.
Отправьте те же настройки в POST /v1/price: ответ покажет цену запуска, деньги при этом не списываются.
```bash
curl -X POST "https://api.cyhub.ai/v1/price" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
--data '{
"model": "recraft",
"settings": {
"mode": "text_to_image",
"prompt": "Деревянная вывеска кофейни с надписью «Утро», тёплый вечерний свет",
"engine": "v4_1",
"aspect_ratio": "3:2"
}
}'
```
- amount_minor: цена запуска в копейках (для рублей)
- currency: валюта кошелька
- available_minor: сколько сейчас доступно на балансе для новых задач
## Картинка по описанию
> Рисует картинку с нуля по описанию. Recraft хорошо держит текст в кадре.
Значение поля mode: `text_to_image`
Цена в этом режиме от 6 ₽.
### Параметры
Параметры модели передаются внутри settings. Пропущенные необязательные поля берут значение по умолчанию.
#### `prompt` (Обязательно)
Что нарисовать. Слова, которые должны быть на картинке, пишите в кавычках. С движками V3 и V2 не длиннее 1000 символов.
- Тип: Строка
- Минимум символов: 1
- Максимум символов: 2000
#### `engine` (Необязательно)
Движок, от него зависит цена. V4.1: лучший баланс. V4.1 Pro: максимум качества, крупнее (квадрат 2048 на 2048 против 1024 на 1024) и заметно дороже. V3: умеет готовые стили. V2: самый дешёвый.
- Тип: Строка
- Допустимые значения: `v4_1` (V4.1 (лучший баланс)), `v4_1_pro` (V4.1 Pro (максимум качества))
- По умолчанию: `"v4_1"`
#### `style` (Необязательно)
Готовый стиль: фотореализм или иллюстрация. Есть только у V3 и V2, у V4.1 манеру задают словами в описании.
- Тип: Строка
- Допустимые значения: `none`
- Набор зависит от `engine`.
- По умолчанию: `"none"`
#### `aspect_ratio` (Необязательно)
Пропорции кадра.
- Тип: Строка
- Допустимые значения: `1:1`, `3:2`, `2:3`, `4:3`, `3:4`, `16:9`, `9:16`, `2:1`, `1:2`
- По умолчанию: `"1:1"`
#### `count` (Необязательно)
Сколько вариантов сделать за раз, от 1 до 6. Каждый оплачивается отдельно.
- Тип: Целое число
- Минимум: 1
- Максимум: 6
- По умолчанию: `1`
Параметры, которых нет в списке, не принимаются: ответ 422 unknown_setting.
### Пример запроса
Отправьте этот JSON в POST /v1/tasks с ключом API. Чтобы узнать цену заранее, тот же JSON можно отправить в POST /v1/price.
Вывеска с надписью
```json
{
"model": "recraft",
"settings": {
"mode": "text_to_image",
"prompt": "Деревянная вывеска кофейни с надписью «Утро», тёплый вечерний свет",
"engine": "v4_1",
"aspect_ratio": "3:2"
}
}
```
Цена считается при приёме задачи, валюта `RUB`.
[Полный пример запуска](https://api.cyhub.ai/docs/generations.md?lang=ru)
### Результат
- Обычно готово за время от нескольких секунд до минуты.
- Картинки приходят файлами WebP без потери качества, столько, сколько задано в count.
| Вид (kind) | Форматы | Сколько | Пояснение |
|---|---|---|---|
| `image` | webp | от 1 до 6 | Сколько задано в count. |
Так выглядит готовая задача в ответе GET /v1/tasks/{id} (часть полей опущена). Подпись caption бывает у задачи или у отдельного файла и может быть пустой, имя файла задаёт модель.
```json
{
"id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
"status": "succeeded",
"finished_at": "2026-10-01T12:03:41+00:00",
"result": {
"caption": "Подпись к результату: модель и настройки",
"texts": [],
"files_expire_at": "2026-10-08T12:03:41+00:00",
"files_expired": false,
"artifacts": [
{
"index": 0,
"kind": "image",
"filename": "image.webp",
"size": 1843200,
"caption": "",
"download_path": "/v1/tasks/7c9e6679-7425-40de-944b-e07fc1f90ae7/artifacts/0"
}
]
}
}
```
[Как читать результат и скачивать файлы](https://api.cyhub.ai/docs/tasks.md?lang=ru#result)
## Вектор по описанию
> Рисует с нуля настоящий вектор SVG: логотипы, иконки, плоские иллюстрации.
Значение поля mode: `text_to_vector`
Цена в этом режиме от 12 ₽.
### Параметры
Параметры модели передаются внутри settings. Пропущенные необязательные поля берут значение по умолчанию.
#### `prompt` (Обязательно)
Что нарисовать. Слова, которые должны быть на картинке, пишите в кавычках. С движками V3 и V2 не длиннее 1000 символов.
- Тип: Строка
- Минимум символов: 1
- Максимум символов: 2000
#### `engine` (Необязательно)
Движок, от него зависит цена. V4.1: лучший баланс. V4.1 Pro: максимум качества, заметно дороже. V3: прошлое поколение. V2: самый дешёвый.
- Тип: Строка
- Допустимые значения: `v4_1` (V4.1 (лучший баланс)), `v4_1_pro` (V4.1 Pro (максимум качества))
- По умолчанию: `"v4_1"`
#### `aspect_ratio` (Необязательно)
Пропорции кадра.
- Тип: Строка
- Допустимые значения: `1:1`, `3:2`, `2:3`, `4:3`, `3:4`, `16:9`, `9:16`, `2:1`, `1:2`
- По умолчанию: `"1:1"`
#### `count` (Необязательно)
Сколько вариантов сделать за раз, от 1 до 6. Каждый оплачивается отдельно.
- Тип: Целое число
- Минимум: 1
- Максимум: 6
- По умолчанию: `1`
Параметры, которых нет в списке, не принимаются: ответ 422 unknown_setting.
### Пример запроса
Отправьте этот JSON в POST /v1/tasks с ключом API. Чтобы узнать цену заранее, тот же JSON можно отправить в POST /v1/price.
Иконка
```json
{
"model": "recraft",
"settings": {
"mode": "text_to_vector",
"prompt": "Плоская иконка ракеты в два цвета, толстый контур",
"engine": "v4_1",
"aspect_ratio": "1:1"
}
}
```
Цена считается при приёме задачи, валюта `RUB`.
[Полный пример запуска](https://api.cyhub.ai/docs/generations.md?lang=ru)
### Результат
- Обычно готово за время от нескольких секунд до минуты.
- Результат в SVG: настоящий вектор, его можно увеличивать без потерь и править в редакторе. Файлов столько, сколько задано в count.
| Вид (kind) | Форматы | Сколько | Пояснение |
|---|---|---|---|
| `document` | svg | от 1 до 6 | Сколько задано в count. |
Так выглядит готовая задача в ответе GET /v1/tasks/{id} (часть полей опущена). Подпись caption бывает у задачи или у отдельного файла и может быть пустой, имя файла задаёт модель.
```json
{
"id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
"status": "succeeded",
"finished_at": "2026-10-01T12:03:41+00:00",
"result": {
"caption": "Подпись к результату: модель и настройки",
"texts": [],
"files_expire_at": "2026-10-08T12:03:41+00:00",
"files_expired": false,
"artifacts": [
{
"index": 0,
"kind": "document",
"filename": "result.svg",
"size": 2097152,
"caption": "",
"download_path": "/v1/tasks/7c9e6679-7425-40de-944b-e07fc1f90ae7/artifacts/0"
}
]
}
}
```
[Как читать результат и скачивать файлы](https://api.cyhub.ai/docs/tasks.md?lang=ru#result)
## Переделать картинку
> Ваша картинка плюс описание: модель рисует новую, сохраняя композицию и цвета исходника. Насколько далеко уйти, задаёт strength.
Значение поля mode: `image_to_image`
Цена в этом режиме от 6 ₽.
### Параметры
Параметры модели передаются внутри settings. Пропущенные необязательные поля берут значение по умолчанию.
#### `image_urls` (Обязательно)
Одна ссылка на исходную картинку.
- Тип: Список (Строка, uri)
- Максимум элементов: 1
#### `prompt` (Обязательно)
Какой должна получиться картинка, до 1000 символов. Предметы называйте словами: модель рисует по описанию и не понимает отсылок вроде «тот же предмет».
- Тип: Строка
- Минимум символов: 1
- Максимум символов: 1000
#### `strength` (Необязательно)
Насколько далеко уйти от исходника: 0.2 слегка подправить, 0.5 заметно переделать, 0.8 почти нарисовать заново.
- Тип: Строка
- Допустимые значения: `0.2` (Слегка подправить), `0.5` (Заметно переделать), `0.8` (Почти нарисовать заново)
- По умолчанию: `"0.5"`
#### `count` (Необязательно)
Сколько вариантов сделать за раз, от 1 до 6. Каждый оплачивается отдельно.
- Тип: Целое число
- Минимум: 1
- Максимум: 6
- По умолчанию: `1`
Параметры, которых нет в списке, не принимаются: ответ 422 unknown_setting.
### Входные данные
- Картинка передаётся ссылкой на JPEG, PNG или WebP до 10 МБ, не больше 16 мегапикселей, каждая сторона от 256 до 4096 пикселей.
| Поле | Что принимает | Форматы | Файлов | Размер файла до |
|---|---|---|---|---|
| `image_urls` | Картинки | jpeg, jpg, png, webp | 1 | 10 МБ |
[Как передать файлы](https://api.cyhub.ai/docs/files.md?lang=ru)
### Пример запроса
Отправьте этот JSON в POST /v1/tasks с ключом API. Чтобы узнать цену заранее, тот же JSON можно отправить в POST /v1/price.
Другой интерьер
```json
{
"model": "recraft",
"settings": {
"mode": "image_to_image",
"image_urls": [
"https://example.com/living-room.jpg"
],
"prompt": "Гостиная в скандинавском стиле: светлый диван, дубовый стол, растения в горшках",
"strength": "0.5"
}
}
```
Цена считается при приёме задачи, валюта `RUB`.
[Полный пример запуска](https://api.cyhub.ai/docs/generations.md?lang=ru)
### Результат
- Обычно готово за время от нескольких секунд до минуты.
- Картинки приходят файлами WebP без потери качества, столько, сколько задано в count.
| Вид (kind) | Форматы | Сколько | Пояснение |
|---|---|---|---|
| `image` | webp | от 1 до 6 | Сколько задано в count. |
Так выглядит готовая задача в ответе GET /v1/tasks/{id} (часть полей опущена). Подпись caption бывает у задачи или у отдельного файла и может быть пустой, имя файла задаёт модель.
```json
{
"id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
"status": "succeeded",
"finished_at": "2026-10-01T12:03:41+00:00",
"result": {
"caption": "Подпись к результату: модель и настройки",
"texts": [],
"files_expire_at": "2026-10-08T12:03:41+00:00",
"files_expired": false,
"artifacts": [
{
"index": 0,
"kind": "image",
"filename": "image.webp",
"size": 1843200,
"caption": "",
"download_path": "/v1/tasks/7c9e6679-7425-40de-944b-e07fc1f90ae7/artifacts/0"
}
]
}
}
```
[Как читать результат и скачивать файлы](https://api.cyhub.ai/docs/tasks.md?lang=ru#result)
## Заменить область
> Перерисовывает по описанию часть картинки, отмеченную маской. Остальное не меняется.
Значение поля mode: `inpaint`
Цена в этом режиме от 6 ₽.
### Параметры
Параметры модели передаются внутри settings. Пропущенные необязательные поля берут значение по умолчанию.
#### `image_urls` (Обязательно)
Одна ссылка на исходную картинку.
- Тип: Список (Строка, uri)
- Максимум элементов: 1
#### `mask_urls` (Обязательно)
Одна ссылка на маску: картинку в оттенках серого ровно того же размера, что исходник. Белым отмечено то, что перерисовать, чёрным то, что оставить.
- Тип: Список (Строка, uri)
- Максимум элементов: 1
#### `prompt` (Обязательно)
Описание всей картинки, какой она должна стать, а не только отмеченного куска, до 1000 символов. Короткая команда вроде «напиши тут GG» область только затрёт.
- Тип: Строка
- Минимум символов: 1
- Максимум символов: 1000
#### `count` (Необязательно)
Сколько вариантов сделать за раз, от 1 до 6. Каждый оплачивается отдельно.
- Тип: Целое число
- Минимум: 1
- Максимум: 6
- По умолчанию: `1`
Параметры, которых нет в списке, не принимаются: ответ 422 unknown_setting.
### Входные данные
- Картинка передаётся ссылкой на JPEG, PNG или WebP до 10 МБ, не больше 16 мегапикселей, каждая сторона от 256 до 4096 пикселей.
- Маска: картинка PNG или JPEG в оттенках серого (один канал, без цвета и прозрачности) ровно того же размера, что исходник. Белым отмечено то, что меняется, чёрным то, что остаётся. Цветная маска не подойдёт, даже если на вид она чёрно-белая.
- Лучше PNG: нужны только чистый чёрный и чистый белый, а JPEG при сжатии даёт серые пиксели на границах.
- Картинку и маску мы скачиваем сами: ссылка должна отдавать файл сразу, без переадресации.
| Поле | Что принимает | Форматы | Файлов | Размер файла до |
|---|---|---|---|---|
| `image_urls` | Картинки | jpeg, jpg, png, webp | 1 | 10 МБ |
| `mask_urls` | Картинки | jpeg, jpg, png | 1 | 10 МБ |
[Как передать файлы](https://api.cyhub.ai/docs/files.md?lang=ru)
### Пример запроса
Отправьте этот JSON в POST /v1/tasks с ключом API. Чтобы узнать цену заранее, тот же JSON можно отправить в POST /v1/price.
Кактус на подоконнике
```json
{
"model": "recraft",
"settings": {
"mode": "inpaint",
"image_urls": [
"https://example.com/room.jpg"
],
"mask_urls": [
"https://example.com/room-mask.png"
],
"prompt": "Светлая комната, на подоконнике стоит глиняный горшок с кактусом"
}
}
```
Цена считается при приёме задачи, валюта `RUB`.
[Полный пример запуска](https://api.cyhub.ai/docs/generations.md?lang=ru)
### Результат
- Обычно готово за время от нескольких секунд до минуты.
- Картинки приходят файлами WebP без потери качества, столько, сколько задано в count.
| Вид (kind) | Форматы | Сколько | Пояснение |
|---|---|---|---|
| `image` | webp | от 1 до 6 | Сколько задано в count. |
Так выглядит готовая задача в ответе GET /v1/tasks/{id} (часть полей опущена). Подпись caption бывает у задачи или у отдельного файла и может быть пустой, имя файла задаёт модель.
```json
{
"id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
"status": "succeeded",
"finished_at": "2026-10-01T12:03:41+00:00",
"result": {
"caption": "Подпись к результату: модель и настройки",
"texts": [],
"files_expire_at": "2026-10-08T12:03:41+00:00",
"files_expired": false,
"artifacts": [
{
"index": 0,
"kind": "image",
"filename": "image.webp",
"size": 1843200,
"caption": "",
"download_path": "/v1/tasks/7c9e6679-7425-40de-944b-e07fc1f90ae7/artifacts/0"
}
]
}
}
```
[Как читать результат и скачивать файлы](https://api.cyhub.ai/docs/tasks.md?lang=ru#result)
## Стереть лишнее
> Убирает с картинки то, что отмечено маской, и достраивает фон под ним. Описание не нужно.
Значение поля mode: `erase`
Цена в этом режиме от 1 ₽.
### Параметры
Параметры модели передаются внутри settings. Пропущенные необязательные поля берут значение по умолчанию.
#### `image_urls` (Обязательно)
Одна ссылка на исходную картинку.
- Тип: Список (Строка, uri)
- Максимум элементов: 1
#### `mask_urls` (Обязательно)
Одна ссылка на маску: картинку в оттенках серого ровно того же размера, что исходник. Белым отмечено то, что стереть, чёрным то, что оставить.
- Тип: Список (Строка, uri)
- Максимум элементов: 1
Параметры, которых нет в списке, не принимаются: ответ 422 unknown_setting.
### Входные данные
- Картинка передаётся ссылкой на JPEG, PNG или WebP до 10 МБ, не больше 16 мегапикселей, каждая сторона от 256 до 4096 пикселей.
- Маска: картинка PNG или JPEG в оттенках серого (один канал, без цвета и прозрачности) ровно того же размера, что исходник. Белым отмечено то, что меняется, чёрным то, что остаётся. Цветная маска не подойдёт, даже если на вид она чёрно-белая.
- Лучше PNG: нужны только чистый чёрный и чистый белый, а JPEG при сжатии даёт серые пиксели на границах.
- Картинку и маску мы скачиваем сами: ссылка должна отдавать файл сразу, без переадресации.
| Поле | Что принимает | Форматы | Файлов | Размер файла до |
|---|---|---|---|---|
| `image_urls` | Картинки | jpeg, jpg, png, webp | 1 | 10 МБ |
| `mask_urls` | Картинки | jpeg, jpg, png | 1 | 10 МБ |
[Как передать файлы](https://api.cyhub.ai/docs/files.md?lang=ru)
### Пример запроса
Отправьте этот JSON в POST /v1/tasks с ключом API. Чтобы узнать цену заранее, тот же JSON можно отправить в POST /v1/price.
Убрать прохожего
```json
{
"model": "recraft",
"settings": {
"mode": "erase",
"image_urls": [
"https://example.com/beach.jpg"
],
"mask_urls": [
"https://example.com/beach-mask.png"
]
}
}
```
Цена считается при приёме задачи, валюта `RUB`.
[Полный пример запуска](https://api.cyhub.ai/docs/generations.md?lang=ru)
### Результат
- Обычно готово за время от нескольких секунд до минуты.
- Картинка приходит файлом WebP без потери качества.
| Вид (kind) | Форматы | Сколько | Пояснение |
|---|---|---|---|
| `image` | webp | 1 | |
Так выглядит готовая задача в ответе GET /v1/tasks/{id} (часть полей опущена). Подпись caption бывает у задачи или у отдельного файла и может быть пустой, имя файла задаёт модель.
```json
{
"id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
"status": "succeeded",
"finished_at": "2026-10-01T12:03:41+00:00",
"result": {
"caption": "Подпись к результату: модель и настройки",
"texts": [],
"files_expire_at": "2026-10-08T12:03:41+00:00",
"files_expired": false,
"artifacts": [
{
"index": 0,
"kind": "image",
"filename": "image.webp",
"size": 1843200,
"caption": "",
"download_path": "/v1/tasks/7c9e6679-7425-40de-944b-e07fc1f90ae7/artifacts/0"
}
]
}
}
```
[Как читать результат и скачивать файлы](https://api.cyhub.ai/docs/tasks.md?lang=ru#result)
## Расширить кадр
> Дорисовывает картинку в стороны на заданное число пикселей.
Значение поля mode: `outpaint`
Цена в этом режиме от 6 ₽.
### Параметры
Параметры модели передаются внутри settings. Пропущенные необязательные поля берут значение по умолчанию.
#### `image_urls` (Обязательно)
Одна ссылка на исходную картинку.
- Тип: Список (Строка, uri)
- Максимум элементов: 1
#### `prompt` (Обязательно)
Что должно появиться в дорисованной части, до 1000 символов.
- Тип: Строка
- Минимум символов: 1
- Максимум символов: 1000
#### `expand_left` (Необязательно)
На сколько пикселей дорисовать слева, от 0 до 1024.
- Тип: Целое число
- Минимум: 0
- Максимум: 1024
- По умолчанию: `0`
#### `expand_right` (Необязательно)
На сколько пикселей дорисовать справа, от 0 до 1024.
- Тип: Целое число
- Минимум: 0
- Максимум: 1024
- По умолчанию: `0`
#### `expand_top` (Необязательно)
На сколько пикселей дорисовать сверху, от 0 до 1024.
- Тип: Целое число
- Минимум: 0
- Максимум: 1024
- По умолчанию: `0`
#### `expand_bottom` (Необязательно)
На сколько пикселей дорисовать снизу, от 0 до 1024.
- Тип: Целое число
- Минимум: 0
- Максимум: 1024
- По умолчанию: `0`
#### `count` (Необязательно)
Сколько вариантов сделать за раз, от 1 до 6. Каждый оплачивается отдельно.
- Тип: Целое число
- Минимум: 1
- Максимум: 6
- По умолчанию: `1`
Параметры, которых нет в списке, не принимаются: ответ 422 unknown_setting.
### Входные данные
- Картинка передаётся ссылкой на JPEG, PNG или WebP до 10 МБ, не больше 16 мегапикселей, каждая сторона от 256 до 4096 пикселей.
- Хотя бы одна сторона больше нуля. Итоговый кадр не больше 4096 пикселей по каждой стороне.
| Поле | Что принимает | Форматы | Файлов | Размер файла до |
|---|---|---|---|---|
| `image_urls` | Картинки | jpeg, jpg, png, webp | 1 | 10 МБ |
[Как передать файлы](https://api.cyhub.ai/docs/files.md?lang=ru)
### Пример запроса
Отправьте этот JSON в POST /v1/tasks с ключом API. Чтобы узнать цену заранее, тот же JSON можно отправить в POST /v1/price.
Шире по бокам
```json
{
"model": "recraft",
"settings": {
"mode": "outpaint",
"image_urls": [
"https://example.com/portrait.jpg"
],
"prompt": "Песчаный пляж и спокойное море до горизонта",
"expand_left": 512,
"expand_right": 512
}
}
```
Цена считается при приёме задачи, валюта `RUB`.
[Полный пример запуска](https://api.cyhub.ai/docs/generations.md?lang=ru)
### Результат
- Обычно готово за время от нескольких секунд до минуты.
- Картинки приходят файлами WebP без потери качества, столько, сколько задано в count.
| Вид (kind) | Форматы | Сколько | Пояснение |
|---|---|---|---|
| `image` | webp | от 1 до 6 | Сколько задано в count. |
Так выглядит готовая задача в ответе GET /v1/tasks/{id} (часть полей опущена). Подпись caption бывает у задачи или у отдельного файла и может быть пустой, имя файла задаёт модель.
```json
{
"id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
"status": "succeeded",
"finished_at": "2026-10-01T12:03:41+00:00",
"result": {
"caption": "Подпись к результату: модель и настройки",
"texts": [],
"files_expire_at": "2026-10-08T12:03:41+00:00",
"files_expired": false,
"artifacts": [
{
"index": 0,
"kind": "image",
"filename": "image.webp",
"size": 1843200,
"caption": "",
"download_path": "/v1/tasks/7c9e6679-7425-40de-944b-e07fc1f90ae7/artifacts/0"
}
]
}
}
```
[Как читать результат и скачивать файлы](https://api.cyhub.ai/docs/tasks.md?lang=ru#result)
## Заменить фон
> Объект остаётся, а фон Recraft находит сам и переписывает по описанию.
Значение поля mode: `replace_background`
Цена в этом режиме от 6 ₽.
### Параметры
Параметры модели передаются внутри settings. Пропущенные необязательные поля берут значение по умолчанию.
#### `image_urls` (Обязательно)
Одна ссылка на исходную картинку.
- Тип: Список (Строка, uri)
- Максимум элементов: 1
#### `prompt` (Обязательно)
Каким должен стать фон, до 1000 символов.
- Тип: Строка
- Минимум символов: 1
- Максимум символов: 1000
#### `count` (Необязательно)
Сколько вариантов сделать за раз, от 1 до 6. Каждый оплачивается отдельно.
- Тип: Целое число
- Минимум: 1
- Максимум: 6
- По умолчанию: `1`
Параметры, которых нет в списке, не принимаются: ответ 422 unknown_setting.
### Входные данные
- Картинка передаётся ссылкой на JPEG, PNG или WebP до 10 МБ, не больше 16 мегапикселей, каждая сторона от 256 до 4096 пикселей.
| Поле | Что принимает | Форматы | Файлов | Размер файла до |
|---|---|---|---|---|
| `image_urls` | Картинки | jpeg, jpg, png, webp | 1 | 10 МБ |
[Как передать файлы](https://api.cyhub.ai/docs/files.md?lang=ru)
### Пример запроса
Отправьте этот JSON в POST /v1/tasks с ключом API. Чтобы узнать цену заранее, тот же JSON можно отправить в POST /v1/price.
Товар на мраморе
```json
{
"model": "recraft",
"settings": {
"mode": "replace_background",
"image_urls": [
"https://example.com/bottle.png"
],
"prompt": "Мраморная столешница, мягкий утренний свет"
}
}
```
Цена считается при приёме задачи, валюта `RUB`.
[Полный пример запуска](https://api.cyhub.ai/docs/generations.md?lang=ru)
### Результат
- Обычно готово за время от нескольких секунд до минуты.
- Картинки приходят файлами WebP без потери качества, столько, сколько задано в count.
| Вид (kind) | Форматы | Сколько | Пояснение |
|---|---|---|---|
| `image` | webp | от 1 до 6 | Сколько задано в count. |
Так выглядит готовая задача в ответе GET /v1/tasks/{id} (часть полей опущена). Подпись caption бывает у задачи или у отдельного файла и может быть пустой, имя файла задаёт модель.
```json
{
"id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
"status": "succeeded",
"finished_at": "2026-10-01T12:03:41+00:00",
"result": {
"caption": "Подпись к результату: модель и настройки",
"texts": [],
"files_expire_at": "2026-10-08T12:03:41+00:00",
"files_expired": false,
"artifacts": [
{
"index": 0,
"kind": "image",
"filename": "image.webp",
"size": 1843200,
"caption": "",
"download_path": "/v1/tasks/7c9e6679-7425-40de-944b-e07fc1f90ae7/artifacts/0"
}
]
}
}
```
[Как читать результат и скачивать файлы](https://api.cyhub.ai/docs/tasks.md?lang=ru#result)
## Фон по маске
> Как замена фона, но где фон, задаёт маска.
Значение поля mode: `generate_background`
Цена в этом режиме от 6 ₽.
### Параметры
Параметры модели передаются внутри settings. Пропущенные необязательные поля берут значение по умолчанию.
#### `image_urls` (Обязательно)
Одна ссылка на исходную картинку.
- Тип: Список (Строка, uri)
- Максимум элементов: 1
#### `mask_urls` (Обязательно)
Одна ссылка на маску: картинку в оттенках серого ровно того же размера, что исходник. Белым отмечено, где рисовать новый фон, чёрным объект, который остаётся.
- Тип: Список (Строка, uri)
- Максимум элементов: 1
#### `prompt` (Обязательно)
Каким должен стать фон, до 1000 символов.
- Тип: Строка
- Минимум символов: 1
- Максимум символов: 1000
#### `count` (Необязательно)
Сколько вариантов сделать за раз, от 1 до 6. Каждый оплачивается отдельно.
- Тип: Целое число
- Минимум: 1
- Максимум: 6
- По умолчанию: `1`
Параметры, которых нет в списке, не принимаются: ответ 422 unknown_setting.
### Входные данные
- Картинка передаётся ссылкой на JPEG, PNG или WebP до 10 МБ, не больше 16 мегапикселей, каждая сторона от 256 до 4096 пикселей.
- Маска: картинка PNG или JPEG в оттенках серого (один канал, без цвета и прозрачности) ровно того же размера, что исходник. Белым отмечено то, что меняется, чёрным то, что остаётся. Цветная маска не подойдёт, даже если на вид она чёрно-белая.
- Лучше PNG: нужны только чистый чёрный и чистый белый, а JPEG при сжатии даёт серые пиксели на границах.
- Картинку и маску мы скачиваем сами: ссылка должна отдавать файл сразу, без переадресации.
| Поле | Что принимает | Форматы | Файлов | Размер файла до |
|---|---|---|---|---|
| `image_urls` | Картинки | jpeg, jpg, png, webp | 1 | 10 МБ |
| `mask_urls` | Картинки | jpeg, jpg, png | 1 | 10 МБ |
[Как передать файлы](https://api.cyhub.ai/docs/files.md?lang=ru)
### Пример запроса
Отправьте этот JSON в POST /v1/tasks с ключом API. Чтобы узнать цену заранее, тот же JSON можно отправить в POST /v1/price.
Кроссовок у стены
```json
{
"model": "recraft",
"settings": {
"mode": "generate_background",
"image_urls": [
"https://example.com/sneaker.png"
],
"mask_urls": [
"https://example.com/sneaker-mask.png"
],
"prompt": "Бетонная стена с граффити, дневной свет"
}
}
```
Цена считается при приёме задачи, валюта `RUB`.
[Полный пример запуска](https://api.cyhub.ai/docs/generations.md?lang=ru)
### Результат
- Обычно готово за время от нескольких секунд до минуты.
- Картинки приходят файлами WebP без потери качества, столько, сколько задано в count.
| Вид (kind) | Форматы | Сколько | Пояснение |
|---|---|---|---|
| `image` | webp | от 1 до 6 | Сколько задано в count. |
Так выглядит готовая задача в ответе GET /v1/tasks/{id} (часть полей опущена). Подпись caption бывает у задачи или у отдельного файла и может быть пустой, имя файла задаёт модель.
```json
{
"id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
"status": "succeeded",
"finished_at": "2026-10-01T12:03:41+00:00",
"result": {
"caption": "Подпись к результату: модель и настройки",
"texts": [],
"files_expire_at": "2026-10-08T12:03:41+00:00",
"files_expired": false,
"artifacts": [
{
"index": 0,
"kind": "image",
"filename": "image.webp",
"size": 1843200,
"caption": "",
"download_path": "/v1/tasks/7c9e6679-7425-40de-944b-e07fc1f90ae7/artifacts/0"
}
]
}
}
```
[Как читать результат и скачивать файлы](https://api.cyhub.ai/docs/tasks.md?lang=ru#result)
## Похожие варианты
> Несколько вариаций вашей картинки: меняются детали, положение предметов и композиция, общая идея остаётся. Описание не нужно.
Значение поля mode: `variate`
Цена в этом режиме от 6 ₽.
### Параметры
Параметры модели передаются внутри settings. Пропущенные необязательные поля берут значение по умолчанию.
#### `image_urls` (Обязательно)
Одна ссылка на исходную картинку.
- Тип: Список (Строка, uri)
- Максимум элементов: 1
#### `aspect_ratio` (Необязательно)
Пропорции вариантов.
- Тип: Строка
- Допустимые значения: `1:1`, `3:2`, `2:3`, `4:3`, `3:4`, `16:9`, `9:16`, `2:1`, `1:2`
- По умолчанию: `"1:1"`
#### `count` (Необязательно)
Сколько вариантов сделать за раз, от 1 до 6. Каждый оплачивается отдельно.
- Тип: Целое число
- Минимум: 1
- Максимум: 6
- По умолчанию: `1`
Параметры, которых нет в списке, не принимаются: ответ 422 unknown_setting.
### Входные данные
- Картинка передаётся ссылкой на JPEG, PNG или WebP до 10 МБ, не больше 16 мегапикселей, каждая сторона от 256 до 4096 пикселей.
| Поле | Что принимает | Форматы | Файлов | Размер файла до |
|---|---|---|---|---|
| `image_urls` | Картинки | jpeg, jpg, png, webp | 1 | 10 МБ |
[Как передать файлы](https://api.cyhub.ai/docs/files.md?lang=ru)
### Пример запроса
Отправьте этот JSON в POST /v1/tasks с ключом API. Чтобы узнать цену заранее, тот же JSON можно отправить в POST /v1/price.
Три варианта персонажа
```json
{
"model": "recraft",
"settings": {
"mode": "variate",
"image_urls": [
"https://example.com/mascot.png"
],
"aspect_ratio": "1:1",
"count": 3
}
}
```
Цена считается при приёме задачи, валюта `RUB`.
[Полный пример запуска](https://api.cyhub.ai/docs/generations.md?lang=ru)
### Результат
- Обычно готово за время от нескольких секунд до минуты.
- Картинки приходят файлами WebP без потери качества, столько, сколько задано в count.
| Вид (kind) | Форматы | Сколько | Пояснение |
|---|---|---|---|
| `image` | webp | от 1 до 6 | Сколько задано в count. |
Так выглядит готовая задача в ответе GET /v1/tasks/{id} (часть полей опущена). Подпись caption бывает у задачи или у отдельного файла и может быть пустой, имя файла задаёт модель.
```json
{
"id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
"status": "succeeded",
"finished_at": "2026-10-01T12:03:41+00:00",
"result": {
"caption": "Подпись к результату: модель и настройки",
"texts": [],
"files_expire_at": "2026-10-08T12:03:41+00:00",
"files_expired": false,
"artifacts": [
{
"index": 0,
"kind": "image",
"filename": "image.webp",
"size": 1843200,
"caption": "",
"download_path": "/v1/tasks/7c9e6679-7425-40de-944b-e07fc1f90ae7/artifacts/0"
}
]
}
}
```
[Как читать результат и скачивать файлы](https://api.cyhub.ai/docs/tasks.md?lang=ru#result)
## Перевести в вектор
> Переводит картинку в настоящий вектор SVG. Описание не нужно.
Значение поля mode: `vectorize`
Цена в этом режиме от 2 ₽.
### Параметры
Параметры модели передаются внутри settings. Пропущенные необязательные поля берут значение по умолчанию.
#### `image_urls` (Обязательно)
Одна ссылка на исходную картинку.
- Тип: Список (Строка, uri)
- Максимум элементов: 1
Параметры, которых нет в списке, не принимаются: ответ 422 unknown_setting.
### Входные данные
- Картинка передаётся ссылкой на JPEG, PNG или WebP до 10 МБ, не больше 16 мегапикселей, каждая сторона от 256 до 4096 пикселей.
| Поле | Что принимает | Форматы | Файлов | Размер файла до |
|---|---|---|---|---|
| `image_urls` | Картинки | jpeg, jpg, png, webp | 1 | 10 МБ |
[Как передать файлы](https://api.cyhub.ai/docs/files.md?lang=ru)
### Пример запроса
Отправьте этот JSON в POST /v1/tasks с ключом API. Чтобы узнать цену заранее, тот же JSON можно отправить в POST /v1/price.
Логотип в вектор
```json
{
"model": "recraft",
"settings": {
"mode": "vectorize",
"image_urls": [
"https://example.com/logo.png"
]
}
}
```
Цена считается при приёме задачи, валюта `RUB`.
[Полный пример запуска](https://api.cyhub.ai/docs/generations.md?lang=ru)
### Результат
- Обычно готово за время от нескольких секунд до минуты.
- Результат: один файл SVG.
| Вид (kind) | Форматы | Сколько | Пояснение |
|---|---|---|---|
| `document` | svg | 1 | |
Так выглядит готовая задача в ответе GET /v1/tasks/{id} (часть полей опущена). Подпись caption бывает у задачи или у отдельного файла и может быть пустой, имя файла задаёт модель.
```json
{
"id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
"status": "succeeded",
"finished_at": "2026-10-01T12:03:41+00:00",
"result": {
"caption": "Подпись к результату: модель и настройки",
"texts": [],
"files_expire_at": "2026-10-08T12:03:41+00:00",
"files_expired": false,
"artifacts": [
{
"index": 0,
"kind": "document",
"filename": "result.svg",
"size": 2097152,
"caption": "",
"download_path": "/v1/tasks/7c9e6679-7425-40de-944b-e07fc1f90ae7/artifacts/0"
}
]
}
}
```
[Как читать результат и скачивать файлы](https://api.cyhub.ai/docs/tasks.md?lang=ru#result)
## Убрать фон
> Вырезает объект и убирает фон. Описание не нужно.
Значение поля mode: `remove_background`
Цена в этом режиме от 2 ₽.
### Параметры
Параметры модели передаются внутри settings. Пропущенные необязательные поля берут значение по умолчанию.
#### `image_urls` (Обязательно)
Одна ссылка на исходную картинку.
- Тип: Список (Строка, uri)
- Максимум элементов: 1
Параметры, которых нет в списке, не принимаются: ответ 422 unknown_setting.
### Входные данные
- Картинка передаётся ссылкой на JPEG, PNG или WebP до 10 МБ, не больше 16 мегапикселей, каждая сторона от 256 до 4096 пикселей.
| Поле | Что принимает | Форматы | Файлов | Размер файла до |
|---|---|---|---|---|
| `image_urls` | Картинки | jpeg, jpg, png, webp | 1 | 10 МБ |
[Как передать файлы](https://api.cyhub.ai/docs/files.md?lang=ru)
### Пример запроса
Отправьте этот JSON в POST /v1/tasks с ключом API. Чтобы узнать цену заранее, тот же JSON можно отправить в POST /v1/price.
Товар без фона
```json
{
"model": "recraft",
"settings": {
"mode": "remove_background",
"image_urls": [
"https://example.com/product.jpg"
]
}
}
```
Цена считается при приёме задачи, валюта `RUB`.
[Полный пример запуска](https://api.cyhub.ai/docs/generations.md?lang=ru)
### Результат
- Обычно готово за время от нескольких секунд до минуты.
- Картинка с прозрачным фоном, файл WebP без потери качества.
| Вид (kind) | Форматы | Сколько | Пояснение |
|---|---|---|---|
| `image` | webp | 1 | |
Так выглядит готовая задача в ответе GET /v1/tasks/{id} (часть полей опущена). Подпись caption бывает у задачи или у отдельного файла и может быть пустой, имя файла задаёт модель.
```json
{
"id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
"status": "succeeded",
"finished_at": "2026-10-01T12:03:41+00:00",
"result": {
"caption": "Подпись к результату: модель и настройки",
"texts": [],
"files_expire_at": "2026-10-08T12:03:41+00:00",
"files_expired": false,
"artifacts": [
{
"index": 0,
"kind": "image",
"filename": "image.webp",
"size": 1843200,
"caption": "",
"download_path": "/v1/tasks/7c9e6679-7425-40de-944b-e07fc1f90ae7/artifacts/0"
}
]
}
}
```
[Как читать результат и скачивать файлы](https://api.cyhub.ai/docs/tasks.md?lang=ru#result)
## Апскейл
> Увеличивает картинку: линии остаются резкими, нового не появляется. Описание не нужно.
Значение поля mode: `upscale_crisp`
Цена в этом режиме от 1 ₽.
### Параметры
Параметры модели передаются внутри settings. Пропущенные необязательные поля берут значение по умолчанию.
#### `image_urls` (Обязательно)
Одна ссылка на исходную картинку.
- Тип: Список (Строка, uri)
- Максимум элементов: 1
Параметры, которых нет в списке, не принимаются: ответ 422 unknown_setting.
### Входные данные
- Картинка передаётся ссылкой на JPEG, PNG или WebP до 10 МБ, не больше 16 мегапикселей, каждая сторона от 32 до 4096 пикселей.
| Поле | Что принимает | Форматы | Файлов | Размер файла до |
|---|---|---|---|---|
| `image_urls` | Картинки | jpeg, jpg, png, webp | 1 | 10 МБ |
[Как передать файлы](https://api.cyhub.ai/docs/files.md?lang=ru)
### Пример запроса
Отправьте этот JSON в POST /v1/tasks с ключом API. Чтобы узнать цену заранее, тот же JSON можно отправить в POST /v1/price.
Увеличить маленькую картинку
```json
{
"model": "recraft",
"settings": {
"mode": "upscale_crisp",
"image_urls": [
"https://example.com/small.png"
]
}
}
```
Цена считается при приёме задачи, валюта `RUB`.
[Полный пример запуска](https://api.cyhub.ai/docs/generations.md?lang=ru)
### Результат
- Обычно готово за время от нескольких секунд до минуты.
- Картинка приходит файлом WebP без потери качества.
| Вид (kind) | Форматы | Сколько | Пояснение |
|---|---|---|---|
| `image` | webp | 1 | |
Так выглядит готовая задача в ответе GET /v1/tasks/{id} (часть полей опущена). Подпись caption бывает у задачи или у отдельного файла и может быть пустой, имя файла задаёт модель.
```json
{
"id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
"status": "succeeded",
"finished_at": "2026-10-01T12:03:41+00:00",
"result": {
"caption": "Подпись к результату: модель и настройки",
"texts": [],
"files_expire_at": "2026-10-08T12:03:41+00:00",
"files_expired": false,
"artifacts": [
{
"index": 0,
"kind": "image",
"filename": "image.webp",
"size": 1843200,
"caption": "",
"download_path": "/v1/tasks/7c9e6679-7425-40de-944b-e07fc1f90ae7/artifacts/0"
}
]
}
}
```
[Как читать результат и скачивать файлы](https://api.cyhub.ai/docs/tasks.md?lang=ru#result)
## Апскейл с дорисовкой
> Увеличивает картинку и досочиняет мелкие детали: поры кожи, волоски, фактуру ткани. Спасает маленькие и мыльные исходники, но детали может переписать по-своему. Описание не нужно.
Значение поля mode: `upscale_creative`
Цена в этом режиме от 36 ₽.
### Параметры
Параметры модели передаются внутри settings. Пропущенные необязательные поля берут значение по умолчанию.
#### `image_urls` (Обязательно)
Одна ссылка на исходную картинку.
- Тип: Список (Строка, uri)
- Максимум элементов: 1
Параметры, которых нет в списке, не принимаются: ответ 422 unknown_setting.
### Входные данные
- Картинка передаётся ссылкой на JPEG, PNG или WebP до 10 МБ, не больше 16 мегапикселей, каждая сторона от 256 до 4096 пикселей.
| Поле | Что принимает | Форматы | Файлов | Размер файла до |
|---|---|---|---|---|
| `image_urls` | Картинки | jpeg, jpg, png, webp | 1 | 10 МБ |
[Как передать файлы](https://api.cyhub.ai/docs/files.md?lang=ru)
### Пример запроса
Отправьте этот JSON в POST /v1/tasks с ключом API. Чтобы узнать цену заранее, тот же JSON можно отправить в POST /v1/price.
Старое фото крупнее
```json
{
"model": "recraft",
"settings": {
"mode": "upscale_creative",
"image_urls": [
"https://example.com/old-photo.jpg"
]
}
}
```
Цена считается при приёме задачи, валюта `RUB`.
[Полный пример запуска](https://api.cyhub.ai/docs/generations.md?lang=ru)
### Результат
- Обычно готово за время от нескольких секунд до минуты.
- Картинка приходит файлом WebP без потери качества.
| Вид (kind) | Форматы | Сколько | Пояснение |
|---|---|---|---|
| `image` | webp | 1 | |
Так выглядит готовая задача в ответе GET /v1/tasks/{id} (часть полей опущена). Подпись caption бывает у задачи или у отдельного файла и может быть пустой, имя файла задаёт модель.
```json
{
"id": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
"status": "succeeded",
"finished_at": "2026-10-01T12:03:41+00:00",
"result": {
"caption": "Подпись к результату: модель и настройки",
"texts": [],
"files_expire_at": "2026-10-08T12:03:41+00:00",
"files_expired": false,
"artifacts": [
{
"index": 0,
"kind": "image",
"filename": "image.webp",
"size": 1843200,
"caption": "",
"download_path": "/v1/tasks/7c9e6679-7425-40de-944b-e07fc1f90ae7/artifacts/0"
}
]
}
}
```
[Как читать результат и скачивать файлы](https://api.cyhub.ai/docs/tasks.md?lang=ru#result)
## Смотрите также
- [Нейросеть Recraft: возможности и цены](https://api.cyhub.ai/models/recraft)
- Другие версии: [Recraft V3 API](https://api.cyhub.ai/models/recraft-v3/api.md), [Recraft V2 API](https://api.cyhub.ai/models/recraft-v2/api.md)
- Похожие модели: [GPT Image 2.5 API](https://api.cyhub.ai/models/gpt-image-2-5/api.md), [Nano Banana Pro API](https://api.cyhub.ai/models/nano-banana-pro/api.md), [Nano Banana 2 Lite API](https://api.cyhub.ai/models/nano-banana-2-lite/api.md), [Midjourney 8.2 API](https://api.cyhub.ai/models/midjourney/api.md), [Grok Imagine 2.0 API](https://api.cyhub.ai/models/grok-imagine-2/api.md), [Seedream 5.0 PRO API](https://api.cyhub.ai/models/seedream-5-pro/api.md)
- [Документация API](https://api.cyhub.ai/docs.md?lang=ru)
- [Ошибки API и что с ними делать](https://api.cyhub.ai/docs/errors.md?lang=ru)