Для разработчиков

API Завирусим

API делает то же, что сайт: ролики, картинки, «Улучшить качество», тренды и чат с нейросетями. Запросы идут из ваших программ, скриптов и Claude Code. Баланс и история генераций общие с сайтом.

Основа адресов
https://zavirusim.ru/api/v1
Ключ
заголовок Authorization: Bearer zv_…
Формат
JSON в UTF-8
Цены
в хайпах, 1 хайп = 1 ₽
Для нейросетей
/llms.txt, /llms-full.txt, OpenAPI
Разделы

Быстрый старт

Первый ролик через API: ключ, проверка баланса, создание и ожидание результата.

  1. Войдите на сайт через Яндекс ID или Google.
  2. Откройте Личный кабинет → API.
  3. Нажмите «Создать ключ». Скопируйте ключ: он показывается один раз.
  4. Сохраните ключ в переменную окружения ZAVIRUSIM_API_KEY.
  5. Запустите пример ниже: он проверит баланс, создаст ролик и дождётся его.

Пример делает ролик моделью Seedance 2.0 Mini: 5 с, 480p, формат 9:16. Цена: 18 хайпов. Если генерация не получится, хайпы вернутся на баланс.

# Ключ из «Личный кабинет → API»
export ZAVIRUSIM_API_KEY="zv_…"

# 1. Проверить ключ и баланс
curl https://zavirusim.ru/api/v1/me \
  -H "Authorization: Bearer $ZAVIRUSIM_API_KEY"

# 2. Создать ролик: id генерации придёт в generations[0].id
curl https://zavirusim.ru/api/v1/generations \
  -H "Authorization: Bearer $ZAVIRUSIM_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "mode": "text",
  "modelId": "seedance-2-0-mini",
  "prompt": "Кот в очках катается на скейтборде по набережной на закате, камера едет рядом",
  "params": { "duration": 5, "aspectRatio": "9:16", "resolution": "480p", "audio": true }
}'

# 3. Узнать статус: повторяйте раз в 5 секунд, пока status не станет done или failed
GENERATION_ID="id из ответа"
curl "https://zavirusim.ru/api/v1/generations/$GENERATION_ID" \
  -H "Authorization: Bearer $ZAVIRUSIM_API_KEY"

# 4. Скачать ролик по downloadUrl из ответа: ключ не нужен
curl -o video.mp4 "downloadUrl из ответа"

В Windows curl из консоли (cmd, PowerShell, Git Bash) шлёт кириллицу не в UTF-8. Тогда ответ: 400 bad_request. Сохраните тело в файл body.json в кодировке UTF-8. Отправьте его так: curl --data-binary @body.json -H "Content-Type: application/json". В PowerShell вызывайте curl.exe.

Адреса

Основа адресов: https://zavirusim.ru/api/v1. Тела запросов и ответы: JSON в UTF-8.

Тело POST /generations и POST /generations/price шлите с заголовком Content-Length: curl, requests и fetch ставят его сами. Без него ответ: 400 bad_request.

В Windows curl из консоли (cmd, PowerShell, Git Bash) шлёт кириллицу не в UTF-8. Тогда ответ: 400 bad_request. Сохраните тело в файл body.json в кодировке UTF-8. Отправьте его так: curl --data-binary @body.json -H "Content-Type: application/json". В PowerShell вызывайте curl.exe.

Метод и адресЧто делаетКлюч
GET /meимя и баланс: hypes, kopecks, availableнужен
GET /me/photos«Мои фотографии»: их можно брать в генерациюнужен
GET /modelsмодели, режимы, параметры, лимиты и цены; один вид: ?type= и video, image, motion, upscale или chatне нужен
GET /trendsтренды: фото, поля, форматы, цены и ролики-примерыне нужен
POST /generations/priceцена генерации без списаниянужен
POST /generationsсоздать генерациюнужен
GET /generations/{id}статус, файлы и downloadUrlнужен
GET /generationsистория или несколько генераций по ?ids=нужен
DELETE /generations/{id}удалить генерацию и её файлынужен
GET /generations/{id}/files/{name}скачать файл генерациинужен
GET /download/{id}/{name}скачать файл по downloadUrlне нужен: ?token= в ссылке
POST /uploadsначать загрузку фото, видео или звуканужен
PUT /uploads/{id}отправить файл целиком или кусокнужен или uploadUrl
GET /uploads/{id}состояние загрузкинужен или uploadUrl
DELETE /uploads/{id}удалить загрузкунужен
POST /chat/completionsответ модели чата в формате OpenAIнужен
GET /openapi.jsonописание API в формате OpenAPI 3.1не нужен

Адрес внутри /api/v1, которого нет, отвечает 404 not_found.

MCP для Claude Code: https://zavirusim.ru/api/mcp, раздел «Claude Code».

Ключ API

Ключ создаёт вошедший пользователь в Личный кабинет → API. Ключ открывает только его аккаунт: баланс, генерации и загрузки.

Передавайте ключ заголовком:

HTTP
Authorization: Bearer zv_…
  • Вид ключа: zv_ и 40 латинских букв и цифр.
  • Ключ показывается один раз, при создании. Сайт хранит только его хэш. Если ключ потерян, отзовите его. Потом создайте новый.
  • Действующих ключей у аккаунта: до 10, новых за сутки: до 20. Название ключа: до 40 символов.
  • Лимит трат ключа в сутки задаётся в хайпах, сутки по Москве. Сверх лимита ответ: 402 key_daily_limit.
  • Отзыв действует сразу. Запрос с отозванным ключом получает 401 key_revoked.
  • Если аккаунт заблокирован, его ключи получают 403 account_blocked.
  • Ключ не даёт прав администратора, даже администратору сайта.

Без заголовка ответ: 401 missing_api_key. Ключ не того вида или неизвестный ключ: 401 invalid_api_key.

Храните ключ на сервере или в переменной окружения. Не вставляйте ключ в код страницы: CORS выключен, а ключ увидит любой посетитель.

Без ключа работают GET /models, GET /trends, GET /openapi.json и временные ссылки downloadUrl и uploadUrl.

Модели и цены

Цены в хайпах: 1 хайп = 1 ₽. Баланс и цены общие с сайтом.

Цены меняются вместе с ценами сайта: сервер сверяет их каждые 15 минут. Точную цену запроса даёт POST /generations/price.

Генерация списывает хайпы при создании. Если генерация не получилась (failed), хайпы возвращаются на баланс.

Модели меняются вместе с сайтом. Берите их из GET /models: ключ не нужен. Не записывайте список моделей в код программы.

Видео

МодельmodelIdРазработчикРежимыКачествоФорматыЗвукЦена от
Seedance 2.5seedance-2-5ByteDancetext, image, references, frames, video480p, 720p, 1080p9:16, 16:9, 1:1, 3:4, 4:3, 21:9по выбору109
Seedance 2.0seedance-2-0ByteDancetext, image, references, frames, video480p, 720p, 1080p, 4K9:16, 16:9, 1:1, 3:4, 4:3, 21:9по выбору74
Seedance 2.0 Miniseedance-2-0-miniByteDancetext, image, references, frames, video480p, 720p9:16, 16:9, 1:1, 3:4, 4:3, 21:9по выбору16
Kling 3.0kling-3-0Kuaishoutext, image, references, frames720p, 1080p, 4K9:16, 16:9, 1:1по выбору69
Veo 3.1veo-3-1Googletext, image, frames720p, 1080p, 4K9:16, 16:9всегда227
Veo 3.1 Fastveo-3-1-fastGoogletext, image, references, frames720p, 1080p, 4K9:16, 16:9всегда55
Gemini Omni Flash 1.1gemini-omni-flash-1-1Googletext, image, references, frames, video360p, 720p, 1080p, 4K9:16, 16:9всегда58
MiniMax H3minimax-h3MiniMaxtext, image, references, frames, video768p, 2K9:16, 16:9, 1:1, 3:4, 4:3, 21:9всегда44
Wan 3.0wan-3-0Alibabatext, image, references, frames, video480p, 720p, 1080p9:16, 16:9, 1:1, 3:4, 4:3по выбору37

Цена от: самый дешёвый ролик модели. Цены по длине и качеству: ниже, в разделе «Цены роликов».

Картинки

МодельmodelIdРазработчикРежимыЦена за картинку
Nano Banana Pronano-banana-proGoogletext, photo1K: 17, 2K: 17, 4K: 22
Nano Banana 2nano-banana-2Googletext, photo1K: 8, 2K: 11, 4K: 17
GPT Image 2.6gpt-image-2-6OpenAItext, photo1K: 7, 2K: 13, 4K: 24
GPT Image 2.5gpt-image-2-5OpenAItext, photo1K: 6, 2K: 10, 4K: 15
GPT Image 2gpt-image-2OpenAItext, photo1K: 6, 2K: 10, 4K: 15
Seedream 5.0 Proseedream-5-proByteDancetext, photo1K: 7, 2K: 13
Flux 2 Proflux-2-proBlack Forest Labstext, photo1K: 5, 2K: 7
Grok Imagine 2.0grok-imagine-2-0xAItext, photo1K: 4

Повтор движения

МодельmodelIdРазработчикКачествоВидео на входеЦена от
Kling 3.0 Motion Controlkling-3-0-motionKuaishou720p, 1080p3-30 с62
Kling 2.6 Motion Controlkling-2-6-motionKuaishou720p, 1080p3-30 с35

Улучшить качество

МодельmodelIdРазработчикfactorЦена
Recraft Crisp Upscalerecraft-crisp-upscaleRecraftне нужен: до ×4за картинку: 3

Чат

МодельmodelРазработчикКонтекст, токеновУмеетЗа 1 млн токенов: вход / ответОбычный ответ
GPT-6 Astragpt-6-astraOpenAI272 000фото, PDF, поиск508,29 / 2 541,452,29
Claude Sonnet 5.5claude-sonnet-5-5Anthropic1 000 000фото145,23 / 726,130,66
Gemini 4 Argongemini-4-argonGoogle1 048 576фото, PDF, поиск145,23 / 726,130,66
Claude Fable 5claude-fable-5Anthropic1 000 000фото726,13 / 3 630,633,27
Grok 4.7grok-4-7xAI500 000фото, PDF, поиск145,23 / 435,680,46
DeepSeek V4.1 Flashdeepseek-v4-1-flashDeepSeek1 000 000фото, поиск21,79 / 86,230,09

Цены чата в хайпах с копейками. Обычный ответ: вопрос 1 000 токенов, ответ 700 токенов.

Цены роликов

Цена ролика без видео на входе и без платных фото. С ними цена другая: её даёт POST /generations/price.

Seedance 2.5: цены
Длина, с480p720p1080p
5128286718
102555721 435
153828582 152
205091 1442 869
307631 7164 303
Seedance 2.0: цены
Длина, с480p720p1080p4K
587187463944
101733739261 888
152595591 3892 832
Seedance 2.0 Mini: цены
Длина, с480p720p
51838
103575
1552112
Kling 3.0: цены
Длина, с720p1080p4K
5104 / 69138 / 92343
10207 / 138275 / 184686
15310 / 206412 / 2761 028

Две цены: со звуком / без звука.

Veo 3.1: цены
Длина, с720p1080p4K
4227232336
6227232336
8227232336
Veo 3.1 Fast: цены
Длина, с720p1080p4K
45559164
65559164
85559164
Gemini Omni Flash 1.1: цены
Длина, с360p720p1080p4K
4585858134
6777777153
8969696172
10115115115191
MiniMax H3: цены
Длина, с768p2K
64471
1073118
15109177
Wan 3.0: цены
Длина, с480p720p1080p
53773146
1073146291
15109218436
30218436872

Видео

Ролик создаёт POST /generations. Тело: JSON с полями ниже. Ответ: 201 и { "generations": [...] }. Повтор с тем же Idempotency-Key: 200 и те же генерации.

ПолеЧто это
kind"video" или не указывать
modeрежим: text, image, frames, references, video, motion
modelIdмодель из GET /models?type=video; у motion: из GET /models?type=motion
promptописание ролика: от 3 до 2000 символов; у motion по желанию
params.durationдлина ролика, с: одна из durations режима модели
params.aspectRatioформат: один из aspectRatios модели
params.resolutionкачество: одно из resolutions модели
params.audioзвук: true или false; нужен у моделей, где звук по выбору (audio: "toggle" в GET /models)
photosфото по порядку, раздел «Файлы»
videosвидео: [{ "upload": "<id>" }] или [{ "url": "https://…" }]
audioзвук: так же, как videos
maxPriceнаибольшая цена в хайпах, раздел «Не дороже»
callbackUrlадрес уведомления о готовности, раздел «Результат»

Заголовок Idempotency-Key защищает от двойного списания, раздел «Повтор запроса».

Поля params, которых нет в запросе, сервер берёт из defaults модели в GET /models. У картинок так же: формат и качество из defaults, count без поля: 1. У тренда: defaultAspectRatio и defaultResolution из GET /trends. Модели нет в режиме: ответ 422 invalid_request со списком моделей режима.

Режимы

modeРежимЧто на входеМодели
textТекст → видеотолько промптseedance-2-5, seedance-2-0, seedance-2-0-mini, kling-3-0, veo-3-1, veo-3-1-fast, gemini-omni-flash-1-1, minimax-h3, wan-3-0
imageФото → видео, одно фото1 фото: первый кадрseedance-2-5, seedance-2-0, seedance-2-0-mini, kling-3-0, veo-3-1, veo-3-1-fast, gemini-omni-flash-1-1, minimax-h3, wan-3-0
framesПервый и последний кадр2 фото: первый и последний кадрseedance-2-5, seedance-2-0, seedance-2-0-mini, kling-3-0, veo-3-1, veo-3-1-fast, gemini-omni-flash-1-1, minimax-h3, wan-3-0
referencesФото → видео, образцыот 2 фото-образцов; у части моделей ещё звукseedance-2-5, seedance-2-0, seedance-2-0-mini, kling-3-0, veo-3-1-fast, gemini-omni-flash-1-1, minimax-h3, wan-3-0
videoВидео-референсвидео; фото и звук по желаниюseedance-2-5, seedance-2-0, seedance-2-0-mini, gemini-omni-flash-1-1, minimax-h3, wan-3-0
motionПовтор движения1 фото человека и 1 видео с движениемkling-3-0-motion, kling-2-6-motion

text: Текст → видео

Ролик по описанию, без файлов.

МодельmodelIdДлительность, сЦена от
Seedance 2.5seedance-2-55, 10, 15, 20, 30128
Seedance 2.0seedance-2-05, 10, 1587
Seedance 2.0 Miniseedance-2-0-mini5, 10, 1518
Kling 3.0kling-3-05, 10, 1569
Veo 3.1veo-3-14, 6, 8227
Veo 3.1 Fastveo-3-1-fast4, 6, 855
Gemini Omni Flash 1.1gemini-omni-flash-1-14, 6, 8, 1058
MiniMax H3minimax-h36, 10, 1544
Wan 3.0wan-3-05, 10, 15, 3037
curl https://zavirusim.ru/api/v1/generations \
  -H "Authorization: Bearer $ZAVIRUSIM_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "mode": "text",
  "modelId": "seedance-2-5",
  "prompt": "Кот в очках катается на скейтборде по набережной на закате, камера едет рядом",
  "params": { "duration": 5, "aspectRatio": "9:16", "resolution": "720p", "audio": true }
}'

image: Фото → видео, одно фото

Одно фото становится первым кадром ролика.

Звук на входе режим не принимает: звук работает с образцами, режим references.

Если у режима formatFromPhoto: true, ролик повторяет пропорции фото. Поле aspectRatio нужно и тогда.

МодельmodelIdФорматДлительность, сЦена от
Seedance 2.5seedance-2-5по фото5, 10, 15, 20, 30128
Seedance 2.0seedance-2-0aspectRatio5, 10, 1587
Seedance 2.0 Miniseedance-2-0-miniaspectRatio5, 10, 1518
Kling 3.0kling-3-0по фото5, 10, 1569
Veo 3.1veo-3-1aspectRatio4, 6, 8227
Veo 3.1 Fastveo-3-1-fastaspectRatio4, 6, 855
Gemini Omni Flash 1.1gemini-omni-flash-1-1aspectRatio4, 6, 8, 1058
MiniMax H3minimax-h3по фото6, 10, 1544
Wan 3.0wan-3-0aspectRatio5, 10, 15, 3037
JSON
{
  "mode": "image",
  "modelId": "seedance-2-5",
  "prompt": "Человек на фото улыбается и машет рукой, лёгкий ветер в волосах",
  "params": { "duration": 5, "aspectRatio": "9:16", "resolution": "720p", "audio": true },
  "photos": [{ "source": "url", "url": "https://example.com/first-frame.jpg" }]
}

frames: Первый и последний кадр

Два фото по порядку: первый и последний кадр. Ролик идёт от первого кадра к последнему.

Если у режима formatFromPhoto: true, ролик повторяет пропорции фото. Поле aspectRatio нужно и тогда.

МодельmodelIdФорматДлительность, сЦена от
Seedance 2.5seedance-2-5по фото5, 10, 15, 20, 30128
Seedance 2.0seedance-2-0aspectRatio5, 10, 1587
Seedance 2.0 Miniseedance-2-0-miniaspectRatio5, 10, 1518
Kling 3.0kling-3-0по фото5, 10, 1569
Veo 3.1veo-3-1aspectRatio4, 6, 8227
Veo 3.1 Fastveo-3-1-fastaspectRatio4, 6, 855
Gemini Omni Flash 1.1gemini-omni-flash-1-1aspectRatio4, 6, 8, 1058
MiniMax H3minimax-h3по фото6, 10, 1544
Wan 3.0wan-3-0aspectRatio5, 10, 15, 3037
JSON
{
  "mode": "frames",
  "modelId": "seedance-2-5",
  "prompt": "Плавный переход от первого кадра к последнему, камера медленно приближается",
  "params": { "duration": 5, "aspectRatio": "9:16", "resolution": "720p", "audio": true },
  "photos": [
    { "source": "url", "url": "https://example.com/first-frame.jpg" },
    { "source": "url", "url": "https://example.com/last-frame.jpg" }
  ]
}

references: Фото → видео, образцы

Фото-образцы: люди, предметы и стиль с фото появятся в ролике.

Фото: от 2 до предела модели. Для одного фото выберите режим image.

Звук-образец (голос или музыку) принимают модели, у которых в таблице есть звук. Звук пришлите в audio. Со звуком ролик всегда со звуком.

У MiniMax H3 фото начиная с 6-го стоят дополнительно. Точную цену даёт POST /generations/price.

МодельmodelIdФотоЗвукДлительность, сЦена от
Seedance 2.5seedance-2-52-9до 3 файлов, по 2-30 с, вместе до 30 с5, 10, 15, 20, 30128
Seedance 2.0seedance-2-02-9до 3 файлов, по 2-15 с, вместе до 15 с5, 10, 1587
Seedance 2.0 Miniseedance-2-0-mini2-9до 3 файлов, по 2-15 с, вместе до 15 с5, 10, 1518
Kling 3.0kling-3-02-4нет5, 10, 1569
Veo 3.1 Fastveo-3-1-fast2-3нет855
Gemini Omni Flash 1.1gemini-omni-flash-1-12-7нет4, 6, 8, 1058
MiniMax H3minimax-h32-9до 3 файлов, по 2-15 с, вместе до 15 с6, 10, 1544
Wan 3.0wan-3-02-9до 3 файлов, по 1-15 с, вместе до 15 с5, 10, 15, 3037
JSON
{
  "mode": "references",
  "modelId": "seedance-2-5",
  "prompt": "Люди с фото пьют кофе в уютной кофейне и смеются",
  "params": { "duration": 5, "aspectRatio": "9:16", "resolution": "720p", "audio": true },
  "photos": [
    { "source": "url", "url": "https://example.com/person-1.jpg" },
    { "source": "url", "url": "https://example.com/person-2.jpg" }
  ]
}

video: Видео-референс

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

Длительность -1 значит «по видео»: ролик повторяет длину и формат видео на входе. Так модель правит само видео: меняет лицо, предмет или стиль. Длительность -1 принимают Seedance 2.5, Seedance 2.0 и Seedance 2.0 Mini. Каждое видео на входе для «по видео»: от 4 с (поле byVideoMinSeconds в GET /models).

У Wan 3.0 видео на входе и новый ролик вместе: не дольше 30 с.

Цена зависит от длины видео на входе. Узнайте её через POST /generations/price: видео для этого загрузите через POST /uploads.

МодельmodelIdВидеоФотоЗвукДлительность, сЦена от
Seedance 2.5seedance-2-5до 3 файлов, по 2-30 с, вместе до 30 с0-9до 3 файлов, по 2-30 с, вместе до 30 с-1 (по видео), 5, 10, 15, 20, 30109
Seedance 2.0seedance-2-0до 3 файлов, по 2-15 с, вместе до 15 с0-9до 3 файлов, по 2-15 с, вместе до 15 с-1 (по видео), 5, 10, 1574
Seedance 2.0 Miniseedance-2-0-miniдо 3 файлов, по 2-15 с, вместе до 15 с0-9до 3 файлов, по 2-15 с, вместе до 15 с-1 (по видео), 5, 10, 1516
Gemini Omni Flash 1.1gemini-omni-flash-1-11 файл, 1-30 с0-5нет4, 6, 8, 10153
MiniMax H3minimax-h3до 3 файлов, по 2-15 с, вместе до 15 с0-9до 3 файлов, по 2-15 с, вместе до 15 с6, 10, 1559
Wan 3.0wan-3-0до 3 файлов, по 1-15 с, вместе до 15 с0-9до 3 файлов, по 1-15 с, вместе до 15 с5, 10, 1544
JSON
{
  "mode": "video",
  "modelId": "seedance-2-5",
  "prompt": "Замени человека в видео на человека с фото, движения те же",
  "params": { "duration": 5, "aspectRatio": "9:16", "resolution": "720p", "audio": true },
  "photos": [{ "source": "mine", "id": "<id из GET /me/photos>" }],
  "videos": [{ "upload": "<id загрузки видео>" }]
}

motion: Повтор движения

Человек с фото повторяет движения из видео.

Нужны одно фото человека и одно видео с движением. Из params нужно только resolution. Промпт по желанию.

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

Модели режима свои: GET /models?type=motion.

МодельmodelIdresolutionВидео3 с5 с10 с15 с20 с30 с
Kling 3.0 Motion Controlkling-3-0-motion720p3-30 с62104207310413619
Kling 3.0 Motion Controlkling-3-0-motion1080p3-30 с83138275412549823
Kling 2.6 Motion Controlkling-2-6-motion720p3-30 с3558115172229344
Kling 2.6 Motion Controlkling-2-6-motion1080p3-30 с5692184276367551
JSON
{
  "mode": "motion",
  "modelId": "kling-3-0-motion",
  "params": { "resolution": "720p" },
  "photos": [{ "source": "mine", "id": "<id из GET /me/photos>" }],
  "videos": [{ "url": "https://example.com/dance.mp4" }]
}

Картинки

Картинки создаёт тот же POST /generations с "kind": "image".

ПолеЧто это
kind"image"
modetext: по описанию; photo: по фото
modelIdмодель из GET /models?type=image
promptописание картинки: от 3 до 2000 символов
params.aspectRatioформат: один из aspectRatios модели
params.resolutionкачество: одно из resolutions модели
countсколько картинок: 1-4, обязательно
photosу photo: фото по порядку, от 1 до предела модели
maxPriceнаибольшая цена всего запроса, раздел «Не дороже»
callbackUrlадрес уведомления о готовности

Каждая картинка из count: отдельная генерация. Ответ: столько же элементов в generations. Цена запроса: цена картинки × count.

МодельmodelIdФорматыКачествоФото в photoЦена за картинку
Nano Banana Pronano-banana-pro1:1, 4:5, 3:4, 2:3, 9:16, 5:4, 4:3, 3:2, 16:9, 21:91K, 2K, 4K1-81K: 17, 2K: 17, 4K: 22
Nano Banana 2nano-banana-21:1, 4:5, 3:4, 2:3, 9:16, 5:4, 4:3, 3:2, 16:9, 21:91K, 2K, 4K1-141K: 8, 2K: 11, 4K: 17
GPT Image 2.6gpt-image-2-61:1, 4:5, 3:4, 2:3, 9:16, 5:4, 4:3, 3:2, 16:9, 21:91K, 2K, 4K1-161K: 7, 2K: 13, 4K: 24
GPT Image 2.5gpt-image-2-51:1, 3:4, 2:3, 9:16, 4:3, 3:2, 16:9, 21:91K, 2K, 4K1-161K: 6, 2K: 10, 4K: 15
GPT Image 2gpt-image-21:1, 4:5, 3:4, 2:3, 9:16, 5:4, 4:3, 3:2, 16:9, 21:91K, 2K, 4K1-161K: 6, 2K: 10, 4K: 15
Seedream 5.0 Proseedream-5-pro1:1, 3:4, 2:3, 9:16, 4:3, 3:2, 16:9, 21:91K, 2K1-101K: 7, 2K: 13
Flux 2 Proflux-2-pro1:1, 3:4, 2:3, 9:16, 4:3, 3:2, 16:91K, 2K1-81K: 5, 2K: 7
Grok Imagine 2.0grok-imagine-2-01:1, 2:3, 9:16, 3:2, 16:91K1-51K: 4

Некоторых сочетаний формата и качества у моделей нет. Они в поле excluded модели:

  • GPT Image 2: нет 4K в 1:1, 2K в 4:5, 2K в 5:4.

У GPT Image 2.6 фото начиная с 1-го стоят дополнительно. Точную цену даёт POST /generations/price.

У Seedream 5.0 Pro фото начиная с 2-го стоят дополнительно. Точную цену даёт POST /generations/price.

По описанию

curl https://zavirusim.ru/api/v1/generations \
  -H "Authorization: Bearer $ZAVIRUSIM_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "kind": "image",
  "mode": "text",
  "modelId": "nano-banana-pro",
  "prompt": "Капибара в спа с полотенцем на голове, мягкий свет, фотореализм",
  "params": { "aspectRatio": "3:4", "resolution": "2K" },
  "count": 2
}'

По фото

JSON
{
  "kind": "image",
  "mode": "photo",
  "modelId": "nano-banana-pro",
  "prompt": "Сделай из фото постер в стиле ретро-комикса",
  "params": { "aspectRatio": "3:4", "resolution": "2K" },
  "count": 1,
  "photos": [{ "source": "url", "url": "https://example.com/photo.jpg" }]
}

Улучшить качество

«Улучшить качество» делает картинку больше и резче. Запрос: POST /generations с "kind": "image" и "mode": "upscale". Промпта нет.

ПолеЧто это
kind"image"
mode"upscale"
modelIdмодель из GET /models?type=upscale
photosодно фото, раздел «Файлы»
countне указывать или 1
maxPriceнаибольшая цена в хайпах
callbackUrlадрес уведомления о готовности
МодельmodelIdРазработчикfactorЦена
Recraft Crisp Upscalerecraft-crisp-upscaleRecraftне нужен: до ×4за картинку: 3

Сервер уменьшает фото до 2 048 px по длинной стороне. Короткая сторона фото: от 64 px.

Цена одна за картинку: от размера фото она не зависит.

JSON
{
  "kind": "image",
  "mode": "upscale",
  "modelId": "recraft-crisp-upscale",
  "photos": [{ "source": "url", "url": "https://example.com/photo.jpg" }]
}

Файлы

Генерации принимают фото, видео и звук. Ниже: как их передать и какие у них пределы.

Фото

ИсточникКак указать в photosКогда удобно
upload{ "source": "upload" } и файл в том же запросеодин запрос с файлом (multipart)
mine{ "source": "mine", "id": "<id>" }фото из «Моих фотографий»: GET /me/photos
file{ "source": "file", "id": "<id загрузки>" }файл загружен через POST /uploads
url{ "source": "url", "url": "https://…" }фото уже лежит в интернете

Фото идут по порядку. Источники можно смешивать в одном запросе.

Сервер принимает JPEG, PNG и WebP. Он приводит фото к JPEG: поворачивает по EXIF и уменьшает до 2 048 px по длинной стороне. Потом фото проверяется: короткая сторона от 340 px, длинная сторона не больше короткой × 2,5.

«Мои фотографии» добавляются и удаляются на сайте. Их id: в GET /me/photos.

Фото в том же запросе

Отправьте multipart/form-data: поле payload с JSON тела и поля photo с файлами. n-е поле photo становится n-м фото { "source": "upload" }. Файл в поле photo: до 5 МБ. Запросы с файлами одного аккаунта идут по одному: второй, пока идёт первый, получит 429 rate_limited.

curl https://zavirusim.ru/api/v1/generations \
  -H "Authorization: Bearer $ZAVIRUSIM_API_KEY" \
  --form-string 'payload={"mode":"image","modelId":"seedance-2-5","prompt":"Человек на фото улыбается и машет рукой, лёгкий ветер в волосах","params":{"duration":5,"aspectRatio":"9:16","resolution":"720p","audio":true},"photos":[{"source":"upload"}]}' \
  -F "photo=@first-frame.jpg"

Видео и звук

Видео (videos) и звук (audio) указываются так: { "upload": "<id загрузки>" } или { "url": "https://…" }.

Сервер перекодирует видео и звук для нейросети. У каждой модели свои пределы числа и длины файлов: поля videos и audio режима в GET /models и таблицы раздела «Видео».

Пределы

ФайлФорматыРазмерДлина
ФотоJPEG, PNG, WebPв поле photo: до 5 МБ; по ссылке и загрузкой: до 25 МБ
ВидеоMP4, MOVдо 200 МБдо 30 с; у моделей свои пределы
ЗвукMP3, WAV, M4A, AAC, OGG, OGA, OPUSдо 15 МБдо 30 с; у моделей свои пределы

Загрузка файла

  1. Начните загрузку: POST /uploads с телом { "kind": "video", "bytes": <размер в байтах> }. kind: photo, video или audio.
  2. Отправьте файл на uploadUrl из ответа: целиком одним PUT или кусками. Ключ не нужен: ссылка подписана и живёт 60 минут.
  3. Укажите id загрузки в генерации: { "upload": "<id>" } у видео и звука, { "source": "file", "id": "<id>" } у фото.

Один PUT сервер обрывает через 5 минут. Если файл может идти дольше, шлите его кусками: так делают примеры на Python и JavaScript.

# 1. Начать загрузку: вид файла и размер в байтах
curl https://zavirusim.ru/api/v1/uploads \
  -H "Authorization: Bearer $ZAVIRUSIM_API_KEY" \
  -H "Content-Type: application/json" \
  -d "{\"kind\": \"video\", \"bytes\": $(wc -c < dance.mp4)}"

# 2. Отправить файл на uploadUrl из ответа: ключ не нужен
UPLOAD_URL="uploadUrl из ответа"
curl -T dance.mp4 "$UPLOAD_URL"

# 3. Проверить состояние: ready - готово, failed - причина в error
curl "$UPLOAD_URL"

Ответ POST /uploads: id, kind, uploadUrl, chunkBytes, status, received и bytes.

statusЧто значит
uploadingфайл ещё идёт: received байт из bytes
processingфайл получен, сервер готовит его для нейросети
readyфайл готов; у видео и звука seconds: длина
failedфайл не подошёл: причина в error

Генерацию можно создавать сразу после PUT: сервер дождётся подготовки файла. Если файл не подошёл, создание ответит 422 invalid_request с причиной.

Файл можно отправить кусками: при обрыве связи повторяется только один кусок. Каждый кусок: PUT на uploadUrl с &offset=<номер первого байта>; с ключом: PUT /uploads/{id}?offset=<номер>. Размер куска любой: сервер сам делит файл на части по chunkBytes байт (2 МБ).

Если кусок не на своём месте, ответ: 409 conflict и поле received. Продолжите с байта received. Куски одной загрузки шлите по одному: второй PUT, пока идёт первый, получит 409.

Файл по ссылке: POST /uploads с телом { "kind": "video", "url": "https://…" }. Сервер скачает файл сам. Состояние: GET /uploads/{id}. В первом ответе bytes: предел для этого вида файла, а не размер файла.

Загрузка живёт сутки. Недогруженную загрузку без новых кусков сервер удаляет через час. Загрузок у аккаунта: до 12, вместе с формой сайта. Новая загрузка сверх 12 удаляет самую старую. Загрузок в работе (файл идёт или готовится): до 6, вместе до 650 МБ. Сверх этого POST /uploads отвечает 429 rate_limited. Создавайте генерацию сразу после загрузки. Удалить загрузку: DELETE /uploads/{id}.

  • Ссылка: только https и публичный адрес. Локальная сеть, адреса сервера и адрес сайта не подходят. Перенаправления проверяются так же.
  • На скачивание файла сервер тратит не больше 120 секунд.
  • Видео и звук по ссылке POST /generations/price не скачивает: для цены загрузите файл через POST /uploads.
  • Сервер скачивает файлы с заголовком User-Agent: Mozilla/5.0 (compatible; ZavirusimBot/1.0; +https://zavirusim.ru/developers). Если ваш сайт отдаёт фото не всем, разрешите этот User-Agent.

Результат

Статусы

statusЧто значит
queuedждёт очереди у нейросети
generatingнейросеть делает файл
doneготово: есть files и downloadUrl
failedне получилось: причина в error, хайпы вернулись на баланс

Если нейросеть сразу не приняла задачу, генерация приходит в ответе POST /generations уже со статусом failed. Хайпы за неё вернулись.

Опрос

  • Одна генерация: GET /generations/{id}. Опрашивайте раз в 5 секунд, пока статус queued или generating.
  • Несколько генераций: GET /generations?ids=<id>,<id>, до 50 id через запятую.
  • История: GET /generations?type=all. type: all, video или image. За раз: 60 генераций, новые сверху. Ответ: generations, more и next. Если more: true, следующая страница: ?before=<next>.
  • Генерации общие с сайтом: созданные через API видны в истории на сайте, а созданные на сайте приходят в API.

Генерация в ответе

ПолеЧто это
idid генерации
typevideo или image
statusqueued, generating, done или failed
modeрежим: у роликов text, image, frames, references, video, motion; у картинок text, photo, upscale
modelId, modelNameмодель
promptпромпт; у тренда: «Тренд «название»»
paramsу ролика duration, aspectRatio, resolution и audio (у motion без audio); у картинки aspectRatio и resolution
priceсписано хайпов
createdAtвремя создания, ISO 8601
filesпри done: result (готовый файл) и preview (превью); у файла name, url, type, у result ещё width и height, если они известны
downloadUrlссылка на готовый файл без ключа на 24 часа
errorпри failed: причина для человека
inputsфайлы на входе: photos, videos, audio; у видео и звука seconds
trendу ролика тренда: id и title
JSON
{
  "id": "6f1c2a7e-3b8d-4c1e-9a52-0d4f7b9e2c11",
  "type": "video",
  "status": "done",
  "mode": "text",
  "modelId": "seedance-2-0-mini",
  "modelName": "Seedance 2.0 Mini",
  "prompt": "Кот в очках катается на скейтборде по набережной на закате, камера едет рядом",
  "params": { "duration": 5, "aspectRatio": "9:16", "resolution": "480p", "audio": true },
  "price": 18,
  "createdAt": "2026-11-10T12:00:00.000Z",
  "files": {
    "result": {
      "name": "video.mp4",
      "url": "https://zavirusim.ru/api/v1/generations/6f1c2a7e-3b8d-4c1e-9a52-0d4f7b9e2c11/files/video.mp4",
      "type": "video/mp4"
    },
    "preview": {
      "name": "poster.jpg",
      "url": "https://zavirusim.ru/api/v1/generations/6f1c2a7e-3b8d-4c1e-9a52-0d4f7b9e2c11/files/poster.jpg",
      "type": "image/jpeg"
    }
  },
  "downloadUrl": "https://zavirusim.ru/api/v1/download/6f1c2a7e-3b8d-4c1e-9a52-0d4f7b9e2c11/video.mp4?token=…",
  "error": null,
  "inputs": null,
  "trend": null
}

Файлы

  • files.result.url: готовый файл, нужен ключ. Файл отдаётся кусками по заголовку Range: скачивание можно продолжить.
  • downloadUrl: тот же файл без ключа. Ссылка живёт 24 часа. Каждый GET /generations/{id} даёт новую ссылку.
  • Файлы хранятся, пока вы не удалите генерацию. Удалить: DELETE /generations/{id}, ответ 204.

Уведомления

  1. Укажите callbackUrl в теле POST /generations: https и публичный адрес.
  2. Когда генерация станет done или failed, сервер пришлёт POST на этот адрес. Тело: генерация, как в GET /generations/{id}.
  3. Ответьте кодом 2xx за 10 секунд. Тело ответа: пустое или до 64 КБ; длиннее уведомление считается недоставленным. Перенаправления сервер не проходит.
  4. Если ответа 2xx нет, сервер повторяет уведомление. Перерывы между попытками: 1, 5, 30, 120 и 360 минут. После последней неудачи запись появится в журнале ключа в разделе «API».

Подпись: заголовок Zavirusim-Signature: t=<unix-время>,v1=<подпись>. v1: HMAC-SHA256 в hex от строки <t>.<тело запроса> на секрете уведомлений. Секрет один на аккаунт. Он в Личный кабинет → API. Там же секрет можно перевыпустить: старый перестаёт подходить сразу.

Проверяйте подпись по сырому телу запроса, до разбора JSON. Отклоняйте уведомление, если t старше 5 минут.

import hashlib
import hmac
import time


def verify_signature(body: bytes, header: str, secret: str, tolerance: int = 300) -> bool:
    """body: сырое тело запроса; header: заголовок Zavirusim-Signature; secret: секрет уведомлений"""
    parts = dict(item.split("=", 1) for item in header.split(",") if "=" in item)
    timestamp, signature = parts.get("t", ""), parts.get("v1", "")
    if not timestamp.isdigit() or not signature:
        return False
    expected = hmac.new(secret.encode(), timestamp.encode() + b"." + body, hashlib.sha256).hexdigest()
    if not hmac.compare_digest(expected, signature):
        return False
    return abs(time.time() - int(timestamp)) <= tolerance


# Flask:
# @app.post("/hooks/zavirusim")
# def hook():
#     if not verify_signature(request.get_data(), request.headers.get("Zavirusim-Signature", ""), SECRET):
#         abort(400)
#     generation = request.get_json()
#     return "", 204

Повтор запроса

Связь может оборваться, когда хайпы уже списаны. Повторите запрос с тем же заголовком Idempotency-Key: сервер вернёт те же генерации и второй раз не спишет.

  • Значение: от 8 до 64 знаков: латинские буквы, цифры и дефис. Подходит UUID.
  • Первый запрос: ответ 201 и новые генерации.
  • Повтор с тем же значением: ответ 200 и те же generations. Сервер отвечает сразу: файлы не скачиваются заново, хайпы второй раз не списываются.
  • Для каждой новой генерации нужно новое значение.
  • Без заголовка каждый запрос создаёт новую генерацию.
  • Значение не того вида: ответ 400 bad_request.
curl https://zavirusim.ru/api/v1/generations \
  -H "Authorization: Bearer $ZAVIRUSIM_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: 3f2b8c1e-7d4a-4f6b-9e0c-5a1d2b3c4e5f" \
  -d '{
  "mode": "text",
  "modelId": "seedance-2-0-mini",
  "prompt": "Кот в очках катается на скейтборде по набережной на закате, камера едет рядом",
  "params": { "duration": 5, "aspectRatio": "9:16", "resolution": "480p", "audio": true }
}'

Не дороже

Цены меняются. Чтобы не заплатить больше, чем ожидаете, пришлите maxPrice.

  1. Узнайте цену: POST /generations/price с тем же телом, что у POST /generations. Хайпы не списываются.
  2. Ответ: price: цена всего запроса в хайпах, count: сколько генераций он создаст, currency: "hype".
  3. Пришлите maxPrice в POST /generations: целое число хайпов за весь запрос. У картинок: за все count картинок.
  4. Если цена выше maxPrice, ответ: 409 price_changed. Хайпы не списываются.
curl https://zavirusim.ru/api/v1/generations/price \
  -H "Authorization: Bearer $ZAVIRUSIM_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "mode": "text",
  "modelId": "seedance-2-0-mini",
  "prompt": "Кот в очках катается на скейтборде по набережной на закате, камера едет рядом",
  "params": { "duration": 5, "aspectRatio": "9:16", "resolution": "480p", "audio": true }
}'

Цена «Улучшить качество» зависит от размера фото, а цена с видео на входе зависит от длины видео. Для них POST /generations/price читает фото и загрузки. Видео и звук по ссылке он не скачивает: сначала загрузите их через POST /uploads.

Чат

Чат работает в формате OpenAI Chat Completions: POST /chat/completions. Программа для OpenAI подключается сменой адреса и ключа: адрес https://zavirusim.ru/api/v1, ключ: ваш ключ API.

curl https://zavirusim.ru/api/v1/chat/completions \
  -H "Authorization: Bearer $ZAVIRUSIM_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "gpt-6-astra",
  "messages": [
    { "role": "system", "content": "Отвечай коротко." },
    { "role": "user", "content": "Придумай идею вирусного ролика про кофейню" }
  ]
}'

Запрос

  • model: id модели из GET /models?type=chat.
  • messages: от 1 до 500 сообщений, хотя бы одно user. Роли: system, developer, user, assistant. system и developer становятся инструкцией модели.
  • content: строка или список частей: text; у user ещё image_url и file.
  • stream: true: ответ потоком SSE, как у OpenAI. В конце data: [DONE].
  • web_search_options: {}: поиск в интернете. Искать ли, модель решает сама, как в чате на сайте: курсы, новости и цены ищет, тексты и промпты пишет без поиска. Поиск работает у моделей с search: true: gpt-6-astra, gemini-4-argon, grok-4-7, deepseek-v4-1-flash. У остальных поле не читается.
  • Поля temperature, max_tokens, tools и другие сервер не читает.

Фото и PDF

  • Фото: часть { "type": "image_url", "image_url": { "url": "…" } }. url: data:-ссылка base64 или https-ссылка. Фото видят модели с photos: true.
  • Сервер уменьшает фото до 1 600 px по длинной стороне. Фото по https-ссылке: до 25 МБ.
  • PDF: часть { "type": "file", "file": { "filename": "…", "file_data": "data:application/pdf;base64,…" } }. PDF читают модели с pdf: true. Один PDF: до 10 МБ.
  • Файлов во всей переписке: до 20.
  • Тело запроса: до 24 МБ. Фото и PDF в data:-ссылках идут в нём base64, а base64 на треть больше файла. Тело больше предела: ответ 413 payload_too_large.
  • Переписка должна помещаться в контекст модели (contextTokens в GET /models) с запасом на ответ. Иначе ответ: 413 payload_too_large.
Python
# client: из первого примера чата
import base64

photo = base64.b64encode(open("photo.jpg", "rb").read()).decode()
pdf = base64.b64encode(open("report.pdf", "rb").read()).decode()

answer = client.chat.completions.create(
    model="gpt-6-astra",
    messages=[
        {
            "role": "user",
            "content": [
                {"type": "text", "text": "Что на фото и о чём документ?"},
                {"type": "image_url", "image_url": {"url": f"data:image/jpeg;base64,{photo}"}},
                {"type": "file", "file": {"filename": "report.pdf", "file_data": f"data:application/pdf;base64,{pdf}"}},
            ],
        },
    ],
    extra_body={"web_search_options": {}},  # поиск в интернете
)
print(answer.choices[0].message.content)

Ответ

  • id: chatcmpl-…; model: id модели; choices[0].message.content: текст ответа.
  • choices[0].message.annotations: источники поиска, url_citation.
  • usage: токены: prompt_tokens, completion_tokens, total_tokens.
  • cost: цена ответа в копейках хайпа. Например, 29: это 0,29 хайпа.
  • finish_reason: stop; length, если ответ оборвался. В ответе целиком причина обрыва тогда в поле warning.
  • В потоке usage и cost приходят в последнем куске перед data: [DONE].
# client: из первого примера чата
stream = client.chat.completions.create(
    model="gpt-6-astra",
    messages=[{"role": "user", "content": "Напиши сценарий ролика на 15 секунд"}],
    stream=True,
)
for chunk in stream:
    if chunk.choices and chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="", flush=True)

Цена и пределы

  • Цена ответа считается по токенам, в копейках хайпа. Копейки копятся, целые хайпы списываются с баланса.
  • Перед ответом сервер проверяет баланс: на нём должно хватать на переписку и ответ в 4 000 токенов. Если не хватает, ответ: 402 insufficient_balance.
  • С web_search_options у GPT-6 Astra, Grok 4.7 и DeepSeek V4.1 Flash поиск - отдельный шаг: модель просит поиск и отвечает второй раз по найденному. Такой ответ дороже. Перед поиском сервер проверяет, хватит ли на него баланса и дневного лимита ключа. Не хватит - модель ответит без поиска.
  • Ответов одновременно у аккаунта: до 3. Больше: 429 rate_limited.
  • Ответ дольше 10 минут обрывается.
  • Если программа оборвала соединение, модель всё равно допишет ответ. Ответ оплачивается целиком.
  • Модель не ответила: 502 model_unavailable. В потоке ошибка приходит строкой data: {"error": …} перед data: [DONE].
  • Переписка не хранится: историю держит ваша программа, как в API OpenAI. В истории чатов на сайте этих ответов нет. Траты видны в разделе «API» личного кабинета.

Claude Code

Claude Code работает с сайтом через MCP: узнаёт баланс и цены, создаёт ролики и картинки, даёт ссылки на готовые файлы.

  1. Создайте ключ в Личный кабинет → API. Задайте ключу лимит в сутки: Claude тратит хайпы с баланса.
  2. Выполните в терминале команду ниже. Вместо zv_… вставьте ключ.
  3. Откройте новую сессию Claude Code. Спросите: «Сколько у меня хайпов на Завирусим?»
Терминал
claude mcp add --transport http zavirusim https://zavirusim.ru/api/mcp --header "Authorization: Bearer zv_…"

Адрес MCP: https://zavirusim.ru/api/mcp. Транспорт: Streamable HTTP. Ключ: тот же заголовок Authorization: Bearer.

ИнструментЧто делаетТратит хайпы
get_balanceбаланс: хайпы с копейкаминет
list_my_photos«Мои фотографии»: id для { "source": "mine" }нет
list_modelsмодели, режимы, параметры и ценынет
list_trendsтренды: фото, поля, форматы и ценынет
get_priceцена генерации без списаниянет
create_uploadссылка uploadUrl для загрузки файла с компьютеранет
create_videoсоздать роликда
create_imageсоздать картинкида
upscale_imageулучшить качество картинкида
run_trendролик по трендуда
get_generationстатус генерации и downloadUrlнет
list_generationsистория генерацийнет
ask_modelвопрос модели чатада

Перед платной генерацией Claude называет цену: инструмент get_price.

Файл с компьютера Claude отправляет так: create_upload даёт uploadUrl, затем Claude выполняет curl -T файл "<uploadUrl>".

Ошибки

Ошибка приходит JSON. Исключение: метод, которого у адреса нет (например, PATCH), получает 405 без тела.

JSON
{ "error": { "code": "insufficient_balance", "message": "…" } }

message: текст для человека, тот же, что на сайте. Программа сверяет code: текст может меняться.

HTTPcodeКогда
400bad_requestтело или параметры адреса не читаются: не JSON, текст не в UTF-8, нет Content-Length, неверный Idempotency-Key
401missing_api_keyнет заголовка Authorization
401invalid_api_keyключ не того вида или такого ключа нет
401key_revokedключ отозван
402insufficient_balanceне хватает хайпов
402key_daily_limitключ потратил свой лимит за сутки; сутки по Москве
403account_blockedаккаунт заблокирован
403forbiddenзапрос к MCP пришёл со страницы чужого сайта: заголовок Origin
404not_foundнет такой генерации, загрузки, файла или адреса; временная ссылка устарела
405method_not_allowedтолько у MCP: метод не подходит адресу. Адреса /api/v1 на неверный метод отвечают 405 без тела
409conflictкусок загрузки не на своём месте; в ответе received: сколько байт уже есть
409price_changedцена выше maxPrice; хайпы не списаны
413payload_too_largeфайл или тело запроса больше предела
422invalid_requestмодель, режим, параметры или файлы не подходят; текст ошибки говорит, что исправить
429rate_limitedзапросы слишком часто
500internal_errorсбой на сервере; повторите запрос
502model_unavailableнейросеть недоступна: модель чата не ответила или файлы на входе не дошли до нейросети; повторите позже
503server_busyсервер или нейросети заняты

429 и 503 приходят с заголовком Retry-After, если сервер знает, через сколько секунд повторить. Без заголовка повторите через 5 секунд.

Новые code могут появиться без новой версии API. Незнакомый code обрабатывайте по статусу HTTP.

Лимиты

ЧтоПределСверх предела
Запросов с одного ключа120 в минуту429 rate_limited, Retry-After
Из них созданий: POST /generations и POST /chat/completions30 в минуту429 rate_limited, Retry-After
Новых задач нейросетям от всех ключей API8 за 10 секунд; каждая картинка из count: отдельная задача503 server_busy, Retry-After
Генераций одновременнобез предела
Ответов чата одновременно у аккаунта3429 rate_limited
Трат ключа в суткилимит ключа в хайпах, сутки по Москве402 key_daily_limit
Промпт2 000 символов422 invalid_request
GET /generations?ids=50 id400 bad_request

Ответ чата может превысить лимит ключа на свою цену: цену ответа сервер узнаёт в конце.

Версии

  • Версия указана в адресе: /api/v1. Ключ от версии не зависит.
  • Внутри v1 изменения только добавляют: модель, режим, необязательное поле, адрес, код ошибки.
  • Ломающее изменение выходит только в новой версии, /api/v2: удалить или переименовать поле, сделать поле обязательным, изменить смысл поля. После выхода v2 версия v1 работает ещё 3 месяца и отдаёт заголовки Deprecation и Sunset.
  • Модели и цены меняются вместе с сайтом, без новой версии. Если модель ушла с сайта, запрос с ней получает 422 invalid_request.

Журнал изменений

17.11.2026

  • Улучшить качество: модель topaz-upscale убрана, запрос с ней получает 422 с id доступных моделей. Осталась recraft-crisp-upscale: 3 хайпа за картинку, было 1; во сколько раз увеличить, решает модель, поле factor не нужно.

16.11.2026

  • Картинки: новая модель gpt-image-2-6 (GPT Image 2.6) - «Текст → картинка» и «По фото» до 16 фото, 10 форматов, 1K, 2K и 4K. Каждое фото на входе стоит дополнительно, начиная с первого: цену с вашими фото называет POST /generations/price.

13.11.2026

  • Тренды: качество по умолчанию - 480p, было 720p. Запрос без params.resolution делает ролик в 480p; для 720p или 1080p передайте params.resolution.
  • Тренды по ролику: несколько фото - один прогон нейросети, а не проход на каждое фото. Цена с несколькими фото такая же, как с одним, или чуть ниже; prices - цена с одним фото, цену за ваши фото называет POST /generations/price.
  • «Ваши фото» на сайте теперь называются «Мои фотографии»: там до 30 фото, свои и друзей. GET /me/photos и list_my_photos работают как раньше.

12.11.2026

  • API открыт всем: ключ создаёт любой вошедший в разделе «API» личного кабинета.
  • Каталог GET /models: у режимов видео поле byVideoMinSeconds: с какой длины видео на входе работает длительность -1 «по видео».
  • Чат: с web_search_options модель сама решает, искать ли в интернете. Искать умеют и grok-4-7, и deepseek-v4-1-flash. У gpt-6-astra, grok-4-7 и deepseek-v4-1-flash поиск - отдельный шаг: перед ним сервер проверяет баланс и дневной лимит ключа, не хватит - модель ответит без поиска.
  • Тренды по ролику: ролик-пример тренда, в котором герои заменены людьми с фото, со звуком примера. Формат у такого тренда один, как у ролика. Фото после первого можно не присылать. Каждое фото - ещё один проход нейросети: цена в prices указана за одно фото, цену за ваши фото называет POST /generations/price.

10.11.2026

  • Первая версия API v1. Ключ создаётся в разделе «API» личного кабинета и передаётся заголовком Authorization: Bearer.
  • Генерации: видео во всех режимах сайта и «Повтор движения», картинки «Текст → картинка» и «По фото», «Улучшить качество», тренды.
  • Цена без списания: POST /generations/price. «Не дороже»: поле maxPrice. Повтор без второго списания: заголовок Idempotency-Key.
  • Файлы на входе: «Ваши фото», загрузки POST /uploads и ссылки https.
  • Статус, история и удаление генераций, файлы по ключу, временная ссылка downloadUrl на 24 часа, уведомление о готовности на callbackUrl.
  • Чат в формате OpenAI Chat Completions: POST /chat/completions, ответ целиком или потоком SSE.
  • Без ключа: каталог моделей и цен GET /models, тренды GET /trends, описание OpenAPI 3.1 GET /openapi.json.
  • MCP для Claude Code: адрес /api/mcp, тот же ключ.