Для разработчиков
API Завирусим
API делает то же, что сайт: ролики, картинки, «Улучшить качество», тренды и чат с нейросетями. Запросы идут из ваших программ, скриптов и Claude Code. Баланс и история генераций общие с сайтом.
- Основа адресов
https://zavirusim.ru/api/v1- Ключ
- заголовок
Authorization: Bearer zv_… - Формат
- JSON в UTF-8
- Цены
- в хайпах, 1 хайп = 1 ₽
- Для нейросетей
- /llms.txt, /llms-full.txt, OpenAPI
Разделы
Быстрый старт
Первый ролик через API: ключ, проверка баланса, создание и ожидание результата.
- Войдите на сайт через Яндекс ID или Google.
- Откройте Личный кабинет → API.
- Нажмите «Создать ключ». Скопируйте ключ: он показывается один раз.
- Сохраните ключ в переменную окружения
ZAVIRUSIM_API_KEY. - Запустите пример ниже: он проверит баланс, создаст ролик и дождётся его.
Пример делает ролик моделью 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.
- Узнайте цену без списания:
POST /generations/price, раздел «Не дороже». - Получайте уведомление вместо опроса: поле
callbackUrl, раздел «Результат». - Выберите модель и режим: разделы «Модели и цены» и «Видео».
Адреса
Основа адресов: 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. Ключ открывает только его аккаунт: баланс, генерации и загрузки.
Передавайте ключ заголовком:
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.5 | seedance-2-5 | ByteDance | text, image, references, frames, video | 480p, 720p, 1080p | 9:16, 16:9, 1:1, 3:4, 4:3, 21:9 | по выбору | 109 |
| Seedance 2.0 | seedance-2-0 | ByteDance | text, image, references, frames, video | 480p, 720p, 1080p, 4K | 9:16, 16:9, 1:1, 3:4, 4:3, 21:9 | по выбору | 74 |
| Seedance 2.0 Mini | seedance-2-0-mini | ByteDance | text, image, references, frames, video | 480p, 720p | 9:16, 16:9, 1:1, 3:4, 4:3, 21:9 | по выбору | 16 |
| Kling 3.0 | kling-3-0 | Kuaishou | text, image, references, frames | 720p, 1080p, 4K | 9:16, 16:9, 1:1 | по выбору | 69 |
| Veo 3.1 | veo-3-1 | text, image, frames | 720p, 1080p, 4K | 9:16, 16:9 | всегда | 227 | |
| Veo 3.1 Fast | veo-3-1-fast | text, image, references, frames | 720p, 1080p, 4K | 9:16, 16:9 | всегда | 55 | |
| Gemini Omni Flash 1.1 | gemini-omni-flash-1-1 | text, image, references, frames, video | 360p, 720p, 1080p, 4K | 9:16, 16:9 | всегда | 58 | |
| MiniMax H3 | minimax-h3 | MiniMax | text, image, references, frames, video | 768p, 2K | 9:16, 16:9, 1:1, 3:4, 4:3, 21:9 | всегда | 44 |
| Wan 3.0 | wan-3-0 | Alibaba | text, image, references, frames, video | 480p, 720p, 1080p | 9:16, 16:9, 1:1, 3:4, 4:3 | по выбору | 37 |
Цена от: самый дешёвый ролик модели. Цены по длине и качеству: ниже, в разделе «Цены роликов».
Картинки
| Модель | modelId | Разработчик | Режимы | Цена за картинку |
|---|---|---|---|---|
| Nano Banana Pro | nano-banana-pro | text, photo | 1K: 17, 2K: 17, 4K: 22 | |
| Nano Banana 2 | nano-banana-2 | text, photo | 1K: 8, 2K: 11, 4K: 17 | |
| GPT Image 2.6 | gpt-image-2-6 | OpenAI | text, photo | 1K: 7, 2K: 13, 4K: 24 |
| GPT Image 2.5 | gpt-image-2-5 | OpenAI | text, photo | 1K: 6, 2K: 10, 4K: 15 |
| GPT Image 2 | gpt-image-2 | OpenAI | text, photo | 1K: 6, 2K: 10, 4K: 15 |
| Seedream 5.0 Pro | seedream-5-pro | ByteDance | text, photo | 1K: 7, 2K: 13 |
| Flux 2 Pro | flux-2-pro | Black Forest Labs | text, photo | 1K: 5, 2K: 7 |
| Grok Imagine 2.0 | grok-imagine-2-0 | xAI | text, photo | 1K: 4 |
Повтор движения
| Модель | modelId | Разработчик | Качество | Видео на входе | Цена от |
|---|---|---|---|---|---|
| Kling 3.0 Motion Control | kling-3-0-motion | Kuaishou | 720p, 1080p | 3-30 с | 62 |
| Kling 2.6 Motion Control | kling-2-6-motion | Kuaishou | 720p, 1080p | 3-30 с | 35 |
Улучшить качество
| Модель | modelId | Разработчик | factor | Цена |
|---|---|---|---|---|
| Recraft Crisp Upscale | recraft-crisp-upscale | Recraft | не нужен: до ×4 | за картинку: 3 |
Чат
| Модель | model | Разработчик | Контекст, токенов | Умеет | За 1 млн токенов: вход / ответ | Обычный ответ |
|---|---|---|---|---|---|---|
| GPT-6 Astra | gpt-6-astra | OpenAI | 272 000 | фото, PDF, поиск | 508,29 / 2 541,45 | 2,29 |
| Claude Sonnet 5.5 | claude-sonnet-5-5 | Anthropic | 1 000 000 | фото | 145,23 / 726,13 | 0,66 |
| Gemini 4 Argon | gemini-4-argon | 1 048 576 | фото, PDF, поиск | 145,23 / 726,13 | 0,66 | |
| Claude Fable 5 | claude-fable-5 | Anthropic | 1 000 000 | фото | 726,13 / 3 630,63 | 3,27 |
| Grok 4.7 | grok-4-7 | xAI | 500 000 | фото, PDF, поиск | 145,23 / 435,68 | 0,46 |
| DeepSeek V4.1 Flash | deepseek-v4-1-flash | DeepSeek | 1 000 000 | фото, поиск | 21,79 / 86,23 | 0,09 |
Цены чата в хайпах с копейками. Обычный ответ: вопрос 1 000 токенов, ответ 700 токенов.
Цены роликов
Цена ролика без видео на входе и без платных фото. С ними цена другая: её даёт POST /generations/price.
Seedance 2.5: цены
| Длина, с | 480p | 720p | 1080p |
|---|---|---|---|
| 5 | 128 | 286 | 718 |
| 10 | 255 | 572 | 1 435 |
| 15 | 382 | 858 | 2 152 |
| 20 | 509 | 1 144 | 2 869 |
| 30 | 763 | 1 716 | 4 303 |
Seedance 2.0: цены
| Длина, с | 480p | 720p | 1080p | 4K |
|---|---|---|---|---|
| 5 | 87 | 187 | 463 | 944 |
| 10 | 173 | 373 | 926 | 1 888 |
| 15 | 259 | 559 | 1 389 | 2 832 |
Seedance 2.0 Mini: цены
| Длина, с | 480p | 720p |
|---|---|---|
| 5 | 18 | 38 |
| 10 | 35 | 75 |
| 15 | 52 | 112 |
Kling 3.0: цены
| Длина, с | 720p | 1080p | 4K |
|---|---|---|---|
| 5 | 104 / 69 | 138 / 92 | 343 |
| 10 | 207 / 138 | 275 / 184 | 686 |
| 15 | 310 / 206 | 412 / 276 | 1 028 |
Две цены: со звуком / без звука.
Veo 3.1: цены
| Длина, с | 720p | 1080p | 4K |
|---|---|---|---|
| 4 | 227 | 232 | 336 |
| 6 | 227 | 232 | 336 |
| 8 | 227 | 232 | 336 |
Veo 3.1 Fast: цены
| Длина, с | 720p | 1080p | 4K |
|---|---|---|---|
| 4 | 55 | 59 | 164 |
| 6 | 55 | 59 | 164 |
| 8 | 55 | 59 | 164 |
Gemini Omni Flash 1.1: цены
| Длина, с | 360p | 720p | 1080p | 4K |
|---|---|---|---|---|
| 4 | 58 | 58 | 58 | 134 |
| 6 | 77 | 77 | 77 | 153 |
| 8 | 96 | 96 | 96 | 172 |
| 10 | 115 | 115 | 115 | 191 |
MiniMax H3: цены
| Длина, с | 768p | 2K |
|---|---|---|
| 6 | 44 | 71 |
| 10 | 73 | 118 |
| 15 | 109 | 177 |
Wan 3.0: цены
| Длина, с | 480p | 720p | 1080p |
|---|---|---|---|
| 5 | 37 | 73 | 146 |
| 10 | 73 | 146 | 291 |
| 15 | 109 | 218 | 436 |
| 30 | 218 | 436 | 872 |
Видео
Ролик создаёт 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.5 | seedance-2-5 | 5, 10, 15, 20, 30 | 128 |
| Seedance 2.0 | seedance-2-0 | 5, 10, 15 | 87 |
| Seedance 2.0 Mini | seedance-2-0-mini | 5, 10, 15 | 18 |
| Kling 3.0 | kling-3-0 | 5, 10, 15 | 69 |
| Veo 3.1 | veo-3-1 | 4, 6, 8 | 227 |
| Veo 3.1 Fast | veo-3-1-fast | 4, 6, 8 | 55 |
| Gemini Omni Flash 1.1 | gemini-omni-flash-1-1 | 4, 6, 8, 10 | 58 |
| MiniMax H3 | minimax-h3 | 6, 10, 15 | 44 |
| Wan 3.0 | wan-3-0 | 5, 10, 15, 30 | 37 |
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.5 | seedance-2-5 | по фото | 5, 10, 15, 20, 30 | 128 |
| Seedance 2.0 | seedance-2-0 | aspectRatio | 5, 10, 15 | 87 |
| Seedance 2.0 Mini | seedance-2-0-mini | aspectRatio | 5, 10, 15 | 18 |
| Kling 3.0 | kling-3-0 | по фото | 5, 10, 15 | 69 |
| Veo 3.1 | veo-3-1 | aspectRatio | 4, 6, 8 | 227 |
| Veo 3.1 Fast | veo-3-1-fast | aspectRatio | 4, 6, 8 | 55 |
| Gemini Omni Flash 1.1 | gemini-omni-flash-1-1 | aspectRatio | 4, 6, 8, 10 | 58 |
| MiniMax H3 | minimax-h3 | по фото | 6, 10, 15 | 44 |
| Wan 3.0 | wan-3-0 | aspectRatio | 5, 10, 15, 30 | 37 |
{
"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.5 | seedance-2-5 | по фото | 5, 10, 15, 20, 30 | 128 |
| Seedance 2.0 | seedance-2-0 | aspectRatio | 5, 10, 15 | 87 |
| Seedance 2.0 Mini | seedance-2-0-mini | aspectRatio | 5, 10, 15 | 18 |
| Kling 3.0 | kling-3-0 | по фото | 5, 10, 15 | 69 |
| Veo 3.1 | veo-3-1 | aspectRatio | 4, 6, 8 | 227 |
| Veo 3.1 Fast | veo-3-1-fast | aspectRatio | 4, 6, 8 | 55 |
| Gemini Omni Flash 1.1 | gemini-omni-flash-1-1 | aspectRatio | 4, 6, 8, 10 | 58 |
| MiniMax H3 | minimax-h3 | по фото | 6, 10, 15 | 44 |
| Wan 3.0 | wan-3-0 | aspectRatio | 5, 10, 15, 30 | 37 |
{
"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.5 | seedance-2-5 | 2-9 | до 3 файлов, по 2-30 с, вместе до 30 с | 5, 10, 15, 20, 30 | 128 |
| Seedance 2.0 | seedance-2-0 | 2-9 | до 3 файлов, по 2-15 с, вместе до 15 с | 5, 10, 15 | 87 |
| Seedance 2.0 Mini | seedance-2-0-mini | 2-9 | до 3 файлов, по 2-15 с, вместе до 15 с | 5, 10, 15 | 18 |
| Kling 3.0 | kling-3-0 | 2-4 | нет | 5, 10, 15 | 69 |
| Veo 3.1 Fast | veo-3-1-fast | 2-3 | нет | 8 | 55 |
| Gemini Omni Flash 1.1 | gemini-omni-flash-1-1 | 2-7 | нет | 4, 6, 8, 10 | 58 |
| MiniMax H3 | minimax-h3 | 2-9 | до 3 файлов, по 2-15 с, вместе до 15 с | 6, 10, 15 | 44 |
| Wan 3.0 | wan-3-0 | 2-9 | до 3 файлов, по 1-15 с, вместе до 15 с | 5, 10, 15, 30 | 37 |
{
"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.5 | seedance-2-5 | до 3 файлов, по 2-30 с, вместе до 30 с | 0-9 | до 3 файлов, по 2-30 с, вместе до 30 с | -1 (по видео), 5, 10, 15, 20, 30 | 109 |
| Seedance 2.0 | seedance-2-0 | до 3 файлов, по 2-15 с, вместе до 15 с | 0-9 | до 3 файлов, по 2-15 с, вместе до 15 с | -1 (по видео), 5, 10, 15 | 74 |
| Seedance 2.0 Mini | seedance-2-0-mini | до 3 файлов, по 2-15 с, вместе до 15 с | 0-9 | до 3 файлов, по 2-15 с, вместе до 15 с | -1 (по видео), 5, 10, 15 | 16 |
| Gemini Omni Flash 1.1 | gemini-omni-flash-1-1 | 1 файл, 1-30 с | 0-5 | нет | 4, 6, 8, 10 | 153 |
| MiniMax H3 | minimax-h3 | до 3 файлов, по 2-15 с, вместе до 15 с | 0-9 | до 3 файлов, по 2-15 с, вместе до 15 с | 6, 10, 15 | 59 |
| Wan 3.0 | wan-3-0 | до 3 файлов, по 1-15 с, вместе до 15 с | 0-9 | до 3 файлов, по 1-15 с, вместе до 15 с | 5, 10, 15 | 44 |
{
"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.
| Модель | modelId | resolution | Видео | 3 с | 5 с | 10 с | 15 с | 20 с | 30 с |
|---|---|---|---|---|---|---|---|---|---|
| Kling 3.0 Motion Control | kling-3-0-motion | 720p | 3-30 с | 62 | 104 | 207 | 310 | 413 | 619 |
| Kling 3.0 Motion Control | kling-3-0-motion | 1080p | 3-30 с | 83 | 138 | 275 | 412 | 549 | 823 |
| Kling 2.6 Motion Control | kling-2-6-motion | 720p | 3-30 с | 35 | 58 | 115 | 172 | 229 | 344 |
| Kling 2.6 Motion Control | kling-2-6-motion | 1080p | 3-30 с | 56 | 92 | 184 | 276 | 367 | 551 |
{
"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" |
mode | text: по описанию; 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 Pro | nano-banana-pro | 1:1, 4:5, 3:4, 2:3, 9:16, 5:4, 4:3, 3:2, 16:9, 21:9 | 1K, 2K, 4K | 1-8 | 1K: 17, 2K: 17, 4K: 22 |
| Nano Banana 2 | nano-banana-2 | 1:1, 4:5, 3:4, 2:3, 9:16, 5:4, 4:3, 3:2, 16:9, 21:9 | 1K, 2K, 4K | 1-14 | 1K: 8, 2K: 11, 4K: 17 |
| GPT Image 2.6 | gpt-image-2-6 | 1:1, 4:5, 3:4, 2:3, 9:16, 5:4, 4:3, 3:2, 16:9, 21:9 | 1K, 2K, 4K | 1-16 | 1K: 7, 2K: 13, 4K: 24 |
| GPT Image 2.5 | gpt-image-2-5 | 1:1, 3:4, 2:3, 9:16, 4:3, 3:2, 16:9, 21:9 | 1K, 2K, 4K | 1-16 | 1K: 6, 2K: 10, 4K: 15 |
| GPT Image 2 | gpt-image-2 | 1:1, 4:5, 3:4, 2:3, 9:16, 5:4, 4:3, 3:2, 16:9, 21:9 | 1K, 2K, 4K | 1-16 | 1K: 6, 2K: 10, 4K: 15 |
| Seedream 5.0 Pro | seedream-5-pro | 1:1, 3:4, 2:3, 9:16, 4:3, 3:2, 16:9, 21:9 | 1K, 2K | 1-10 | 1K: 7, 2K: 13 |
| Flux 2 Pro | flux-2-pro | 1:1, 3:4, 2:3, 9:16, 4:3, 3:2, 16:9 | 1K, 2K | 1-8 | 1K: 5, 2K: 7 |
| Grok Imagine 2.0 | grok-imagine-2-0 | 1:1, 2:3, 9:16, 3:2, 16:9 | 1K | 1-5 | 1K: 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
}'По фото
{
"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 Upscale | recraft-crisp-upscale | Recraft | не нужен: до ×4 | за картинку: 3 |
Сервер уменьшает фото до 2 048 px по длинной стороне. Короткая сторона фото: от 64 px.
Цена одна за картинку: от размера фото она не зависит.
{
"kind": "image",
"mode": "upscale",
"modelId": "recraft-crisp-upscale",
"photos": [{ "source": "url", "url": "https://example.com/photo.jpg" }]
}Тренды
Тренд: готовая сцена со своей моделью, длиной, звуком и скрытым промптом. Вы присылаете фото, формат и качество.
Список трендов: GET /trends, ключ не нужен. Ролик тренда создаёт POST /generations.
| Поле | Что это |
|---|---|
kind | "trend" |
trendId | id тренда из GET /trends |
photos | фото по порядку: n-е фото встаёт на n-е место в photos тренда. Фото с optional: true можно не присылать. У тренда по ролику прогон один при любом числе фото: цена в prices указана за одно фото, с несколькими фото она такая же или чуть ниже. Цену за ваши фото называет POST /generations/price |
trendFields | значения полей тренда: число строкой из цифр ("25"), у выбора id варианта |
params.aspectRatio | формат: один из aspectRatios тренда |
params.resolution | качество: одно из resolutions тренда |
maxPrice | наибольшая цена в хайпах |
callbackUrl | адрес уведомления о готовности |
Модель, длину, звук и промпт задаёт тренд: modelId и prompt из запроса не читаются. В ответе prompt: «Тренд «название»», а поле trend: id и title.
{
"kind": "trend",
"trendId": "estetika",
"photos": [{ "source": "url", "url": "https://example.com/photo-1.jpg" }],
"trendFields": { "figure": "slim" },
"params": { "aspectRatio": "9:16", "resolution": "480p" }
}Все тренды: 197
trendId | Тренд | Модель, длина | Фото по порядку | Поля | Цена от |
|---|---|---|---|---|---|
estetika | Эстетика | Seedance 2.5, 10 с | Лицо крупно; В полный рост (можно без него) | figure (Фигура): slim «Чуть стройнее», real «Как на фото» | 255 |
na-cypochkah | На цыпочках | Seedance 2.5, 15 с | Кого пугают; Кто пугает (можно без него) | нет | 463 |
kapitan-za-rulem | Капитан за рулём | Wan 3.0, 14 с | Капитан; Пассажир (можно без него) | нет | 204 |
ne-dutsya-ne-gnutsya | Не дуться, не гнуться | Wan 3.0, 15 с | Кто объясняет | нет | 218 |
sbory-v-razdevalke | Сборы в раздевалке | Seedance 2.5, 12 с | Сотрудник; Напарник (можно без него) | нет | 371 |
pesnya-v-dushe | Песня в душе | Seedance 2.5, 14 с | Друг слева; Друг справа (можно без него) | нет | 433 |
svyashchenniki-v-dveryah | Священники в дверях | Wan 3.0, 7 с | Кто слева; Кто справа (можно без него) | нет | 95 |
v-nizhnem-bele | В нижнем белье | Seedance 2.0, 10 с | Ваше фото | нет | 173 |
ssora-u-morya | Ссора у моря | Wan 3.0, 15 с | Парень; Девушка (можно без него) | нет | 218 |
velikansha-na-bilborde | Великанша на билборде | Seedance 2.5, 11 с | Великанша; Фото товара (можно без него) | нет | 340 |
odnim-vydohom | Одним выдохом | Wan 3.0, 8 с | Ваше фото | нет | 117 |
devushka-na-pleche | Девушка на плече | Wan 3.0, 11 с | Кого несут; Кто несёт (можно без него) | нет | 160 |
neudachnyj-prikol | Неудачный прикол | Wan 3.0, 15 с | Кто стреляет резинкой; Кто у стола (можно без него) | нет | 218 |
rep-klip-na-rajone | Рэп-клип на районе | Wan 3.0, 17 с | Герой клипа; Друг у крыльца (можно без него) | нет | 248 |
nokaut-s-nogi | Нокаут с ноги | Wan 3.0, 14 с | Кто бьёт; Кого нокаутируют (можно без него) | нет | 204 |
karusel-u-elki | Карусель у ёлки | Wan 3.0, 10 с | Ваше фото | нет | 146 |
prikurit-svechu | Прикурить свечу | Wan 3.0, 10 с | Ваше фото | нет | 146 |
perehod-s-telefonom | Переход с телефоном | Wan 3.0, 7 с | Ваше фото | нет | 102 |
uvidel-poluchil | Увидел - получил | Wan 3.0, 9 с | Кто держит телефон; Кто на фото в телефоне (можно без него) | нет | 124 |
zabezhal-skazat | Забежал сказать | Wan 3.0, 8 с | Ребёнок | нет | 117 |
logotip-na-snegu | Логотип на снегу | Wan 3.0, 15 с | Логотип; Товар (можно без него) | нет | 218 |
novyj-god-na-nosu | Новый год на носу | Wan 3.0, 13 с | Кто с микрофоном; Кого спрашивают (можно без него) | нет | 189 |
vot-takoj-podarochek | Вот такой подарочек | Wan 3.0, 15 с | Кто обнимает телевизор; Кто на диване (можно без него) | нет | 218 |
zhaloba | Жалоба | Wan 3.0, 9 с | Кто слева; Кто в центре (можно без него); Кто справа (можно без него) | нет | 131 |
tolko-ne-begi-ot-menya | Только не беги от меня | Wan 3.0, 15 с | Девушка; Парень (можно без него) | нет | 218 |
na-vershinu-2027 | На вершину 2027 | Wan 3.0, 15 с | Ваше фото | нет | 218 |
tanec-eleny-i-dejmona | Танец Елены и Деймона | Wan 3.0, 15 с | Девушка; Мужчина (можно без него) | нет | 218 |
novye-druzya | Новые друзья | Wan 3.0, 30 с | Ваше фото | нет | 445 |
prazdnovanie-gola | Празднование гола | Wan 3.0, 8 с | Ваше фото | нет | 117 |
moi-slezy-trio | Мои слёзы не помогут (трио) | Wan 3.0, 12 с | Кто справа; Кто слева (можно без него); Кто в центре (можно без него) | нет | 175 |
baraban-i-bayan | Барабан и баян | Wan 3.0, 22 с | Кто с барабаном; Кто с баяном (можно без него) | нет | 313 |
supergeroj-v-kamere | Супергерой в камере | Wan 3.0, 15 с | Ваше фото | нет | 218 |
kofe-v-retro-kafe | Кофе в ретро-кафе | Wan 3.0, 11 с | Девушка; Мужчина (можно без него) | нет | 160 |
ya-tozhe-hochu-shokoladku | Я тоже хочу шоколадку | Wan 3.0, 19 с | Ваш питомец | нет | 277 |
kot-daet-intervyu | Кот даёт интервью | Wan 3.0, 27 с | Ваш питомец | нет | 386 |
proshchaj-gta-5 | Прощай, GTA 5 | Wan 3.0, 28 с | Водитель кабриолета | нет | 243 |
vzryv-za-spinoj | Взрыв за спиной | Seedance 2.5, 14 с | Кто уходит от взрыва; Фото машины (можно без него) | нет | 433 |
tort-i-drift | Торт и дрифт | Seedance 2.5, 9 с | Именинник; Фото машины (можно без него) | нет | 278 |
na-kryle-samoleta | На крыле самолёта | Seedance 2.5, 6 с | Кто на крыле | нет | 186 |
vedma-u-svetofora | Ведьма у светофора | Wan 3.0, 7 с | Ведьма | нет | 95 |
preobrazhenie-podrug | Преображение подруг | Wan 3.0, 15 с | Подруга слева; Подруга справа (можно без него) | нет | 218 |
mashina-nad-golovoj | Машина над головой | Wan 3.0, 9 с | Герой на песке; Ваша машина (можно без него) | нет | 124 |
tanec-u-nochnyh-okon | Танец у ночных окон | Wan 3.0, 15 с | Танцовщица | нет | 218 |
boj-na-ringe | Бой на ринге | Wan 3.0, 15 с | Боксёр; Соперник (можно без него) | нет | 218 |
vstrecha-s-detstvom | Встреча с детством | Wan 3.0, 9 с | Вы сейчас; Вы в детстве (можно без него) | нет | 141 |
portret-na-vetru | Портрет на ветру | Seedance 2.5, 6 с | Героиня портрета | нет | 186 |
privet-iz-parizha | Привет из Парижа | Seedance 2.5, 6 с | Кто позирует | нет | 186 |
shkola-volshebstva | Школа волшебства | Seedance 2.5, 6 с | Кто идёт с метлой | нет | 186 |
tanec-na-perehode | Танец на переходе | Seedance 2.5, 7 с | Кто танцует | нет | 217 |
vstrecha-na-parkovke | Встреча на парковке | Wan 3.0, 15 с | Кого спасают; Кто спасает (можно без него) | нет | 218 |
krazha-iz-mashiny | Кража из машины | Seedance 2.5, 13 с | Кто крадёт; Фото товара (можно без него) | нет | 402 |
mashina-mechty | Машина мечты | Seedance 2.5, 9 с | Фокусник; Фото машины (можно без него) | нет | 278 |
otrazhenie-v-zerkale | Отражение в зеркале | Wan 3.0, 15 с | Девушка с телефоном | нет | 218 |
ty-zagorazhivaesh-svet | Ты загораживаешь свет | Wan 3.0, 15 с | Девушка на диване | нет | 218 |
chuzhoe-mnenie | Чужое мнение | Wan 3.0, 15 с | Кто хоронит мешок | нет | 218 |
zvezdy-sceny | Звёзды сцены | Wan 3.0, 13 с | Подруга слева; Подруга справа (можно без него) | нет | 182 |
obrazy-pod-ventilyatorom | Образы под вентилятором | Wan 3.0, 11 с | Вы на ковре; Одежда 2-го образа (можно без него); Одежда 3-го образа (можно без него) | нет | 153 |
smena-cveta-mashiny | Смена цвета машины | Seedance 2.5, 16 с | Фото машины | нет | 494 |
tanec-u-didzheya | Танец у диджея | Seedance 2.5, 15 с | Танцор | dancer (Кто танцует): woman «Девушка», man «Мужчина» | 463 |
hit-iz-nichego | Хит из ничего | Wan 3.0, 29 с | Кто поёт; Кто играет (можно без него) | нет | 422 |
eskalator-obrazov | Эскалатор образов | Wan 3.0, 15 с | Кто на эскалаторе | нет | 218 |
na-yahte | На яхте | Wan 3.0, 6 с | Кто на яхте | outfit (Одежда): dress «Белое платье», shirt «Рубашка и брюки» | 80 |
nad-oblakami-na-zakate | Над облаками на закате | Seedance 2.5, 6 с | Кто на вершине | нет | 186 |
shary-kappadokii | Шары Каппадокии | Seedance 2.5, 9 с | Кто на смотровой | нет | 278 |
pesnya-v-kabriolete | Песня в кабриолете | Wan 3.0, 19 с | Девушка с собачкой; Парень за рулём (можно без него) | нет | 270 |
russkaya-dusha | Русская душа | Seedance 2.5, 16 с | Кто с медведями | нет | 494 |
tanec-s-sobakoj | Танец с собакой | Wan 3.0, 22 с | Хозяин; Собака (можно без него) | нет | 313 |
anime-portret | Аниме-портрет | Seedance 2.5, 5 с | Аниме-герой | нет | 155 |
vyhod-iz-limuzina | Выход из лимузина | Seedance 2.5, 16 с | Пассажир; Фото машины (можно без него) | нет | 494 |
vyhod-iz-priboya | Выход из прибоя | Wan 3.0, 6 с | Сёрфер | нет | 80 |
krik-u-okna | Крик у окна | Seedance 2.5, 5 с | Кто кричит | нет | 155 |
mir-v-banke | Мир в банке | Seedance 2.5, 8 с | Кто в банке | нет | 247 |
proverka-obraza | Проверка образа | Wan 3.0, 6 с | Ваш образ | нет | 80 |
rep-duet | Рэп-дуэт | Wan 3.0, 25 с | Рэпер слева; Рэпер справа (можно без него) | нет | 357 |
tanec-v-neone | Танец в неоне | Wan 3.0, 29 с | Танцор | нет | 415 |
schaste-lyubit-tishinu | Счастье любит тишину | Wan 3.0, 13 с | Кто в окне | нет | 189 |
battl-vmesto-draki | Баттл вместо драки | Wan 3.0, 23 с | Кто оборачивается; Кто бежит навстречу (можно без него) | нет | 343 |
vertolet-na-den-rozhdeniya | Вертолёт на день рождения | Wan 3.0, 14 с | Именинница | нет | 204 |
mam-ya-zhe-snimayu | Мам, я же снимаю! | Seedance 2.5, 17 с | Кто снимает; Мама (можно без него) | нет | 525 |
polet-nad-probkoj | Полёт над пробкой | Wan 3.0, 28 с | Водитель; Пассажир (можно без него) | нет | 408 |
hellouin-perehod | Хэллоуин-переход | Wan 3.0, 14 с | Королева | нет | 197 |
vnezapno-po-yaponski | Внезапно по-японски | Wan 3.0, 9 с | Начальник; Помощница (можно без него) | нет | 131 |
kot-avtoritet | Кот-авторитет | Seedance 2.5, 9 с | Фото кота | нет | 278 |
kot-pevec | Кот-певец | Seedance 2.5, 10 с | Фото кота | нет | 309 |
krasnaya-ili-sinyaya | Красная или синяя | Wan 3.0, 30 с | Кто выбирает; Наставник (можно без него) | нет | 436 |
motociklist-v-probke | Мотоциклист в пробке | Wan 3.0, 9 с | Мотоциклист; Дама в машине (можно без него) | нет | 124 |
pereodevanie | Переодевание | Seedance 2.5, 10 с | Ваше фото; Фото нового образа | нет | 255 |
sopernik-eto-ty | Соперник - это ты | Wan 3.0, 14 с | Вы сейчас; Вы в детстве (можно без него) | нет | 221 |
francuzskij-macho | Французский мачо | Wan 3.0, 13 с | Мачо | нет | 189 |
kofe-s-soboj | Кофе с собой | Wan 3.0, 6 с | Кто пьёт кофе | нет | 80 |
rycar-i-pitomec | Рыцарь и питомец | Wan 3.0, 10 с | Фото питомца; Рыцарь (можно без него) | нет | 146 |
drift-v-kolizee | Дрифт в Колизее | Wan 3.0, 26 с | Водитель; Пассажир в люке (можно без него); Императрица (можно без него) | нет | 372 |
strelcy-dr | Стрельцы (ДР) | Seedance 2.5, 11 с | Стрелец | outfit (Одежда): dress «Чёрное атласное платье», suit «Чёрный костюм», own «Как на фото» | 340 |
tancy-u-traktora | Танцы у трактора | Wan 3.0, 11 с | Танцор; Друг у камеры (можно без него) | нет | 160 |
na-nosu-korablya | На носу корабля | Seedance 2.5, 16 с | Девушка; Мужчина (можно без него) | нет | 494 |
vybirayu-sebya | Выбираю себя | Wan 3.0, 8 с | Кто держит доску; Кто на доске (можно без него) | нет | 117 |
vstrecha-s-budushchim-soboj | Встреча с будущим собой | Wan 3.0, 9 с | Вы сейчас | нет | 141 |
samodovolnyj-tanec | Самодовольный танец | Wan 3.0, 12 с | Кто танцует | нет | 175 |
tanec-vsej-kompaniej | Танец всей компанией | Wan 3.0, 21 с | Танцор у клумбы; Парень с селфи (можно без него); Девушка из машины (можно без него) | нет | 313 |
uhazher-v-kepke | Ухажёр в кепке | Wan 3.0, 15 с | Ухажёр; Спутница (можно без него) | нет | 218 |
avtoritet-iz-90-h | Авторитет из 90-х | Seedance 2.5, 18 с | Авторитет | нет | 556 |
krik-iz-kuzova | Крик из кузова | Seedance 2.5, 9 с | Парень в очках | нет | 278 |
shampanskoe-na-hodu | Шампанское на ходу | Wan 3.0, 15 с | Пассажирка | нет | 218 |
tri-metra-nad-urovnem | Три метра над уровнем | Wan 3.0, 15 с | Кто на балконе; Кто на танцполе (можно без него) | нет | 218 |
cena-uspeha | Цена успеха | Seedance 2.5, 12 с | Мужчина за рулём; Девушка рядом (можно без него) | нет | 371 |
spasti-lyubov | Спасти любовь | Wan 3.0, 15 с | Кого спасают; Кто спасает (можно без него) | нет | 218 |
ognennye-cifry | Огненные цифры | Seedance 2.5, 11 с | Кто поджигает число | number (Число): число до 3 цифр | 340 |
krasimsya | Красимся | Seedance 2.5, 16 с | Кто красится | нет | 494 |
boj-s-tenyu | Бой с тенью | Seedance 2.5, 13 с | Боксёр | нет | 402 |
modnik-v-gorode | Модник в городе | Wan 3.0, 14 с | Модник | нет | 197 |
odin-protiv-tolpy | Один против толпы | Wan 3.0, 28 с | Кто в чёрном | нет | 401 |
patrul-na-velosipede | Патруль на велосипеде | Wan 3.0, 7 с | Кто за рулём; Кто на багажнике (можно без него) | нет | 102 |
begstvo-ot-valuna | Бегство от валуна | Seedance 2.5, 9 с | Искатель приключений | нет | 278 |
geroj-videoigry | Герой видеоигры | Wan 3.0, 21 с | Герой игры | нет | 299 |
golova-v-lunku | Голова в лунку | Wan 3.0, 13 с | Модель на холме | нет | 182 |
gonochnoe-taksi | Гоночное такси | Wan 3.0, 30 с | Таксист; Пассажир (можно без него) | нет | 436 |
den-rozhdeniya-na-motocikle | День рождения на мотоцикле | Wan 3.0, 9 с | Именинник | нет | 124 |
elka-po-shchelchku | Ёлка по щелчку | Seedance 2.5, 9 с | Кто зажигает ёлку | нет | 278 |
zhdu-pupsika-na-dache | Жду пупсика на даче | Seedance 2.5, 11 с | Дачник | нет | 340 |
zatyanulo-v-igru | Затянуло в игру | Wan 3.0, 21 с | Игрок | нет | 299 |
kto-eto-byl | Кто это был? | Wan 3.0, 26 с | Мужчина; Девушка в окне (можно без него); Его спутница (можно без него) | нет | 372 |
makiyazh-dlya-prizraka | Макияж для призрака | Seedance 2.5, 21 с | Девушка у зеркала; Призрак (можно без него) | нет | 649 |
mashina-iz-risunka | Машина из рисунка | Wan 3.0, 6 с | Кто касается рисунка; Фото машины (можно без него) | нет | 80 |
mrachnaya-nevesta | Мрачная невеста | Wan 3.0, 9 с | Невеста | нет | 124 |
nuar | Нуар | Wan 3.0, 15 с | Детектив | нет | 218 |
ograblenie-poezda | Ограбление поезда | Wan 3.0, 19 с | Всадник; Фото товара (можно без него) | нет | 270 |
ofis-mechty | Офис мечты | Wan 3.0, 19 с | Офисный работник | нет | 277 |
parik-v-samolete | Парик в самолёте | Wan 3.0, 9 с | Пассажир у окна; Соседка в парике (можно без него) | нет | 131 |
pitomec-didzhej | Питомец-диджей | Wan 3.0, 15 с | Фото питомца | нет | 211 |
pobeg-s-dnya-rozhdeniya | Побег с дня рождения | Seedance 2.5, 11 с | Именинница | age (Возраст на торте): число до 3 цифр; newage (Возраст после подмены): число до 3 цифр | 340 |
pogonya-v-maske | Погоня в маске | Wan 3.0, 23 с | Кто убегает | нет | 343 |
vspomni-nas | Вспомни нас | Wan 3.0, 11 с | Девушка; Мужчина (можно без него) | нет | 153 |
prilip-k-krovati | Прилип к кровати | Seedance 2.5, 11 с | Кто прилип к кровати | нет | 340 |
protri-zerkalo | Протри зеркало | Wan 3.0, 18 с | Офисный работник | нет | 255 |
pryatki-v-piccerii | Прятки в пиццерии | Wan 3.0, 21 с | Кто прячется | нет | 299 |
sladkaya-oblava | Сладкая облава | Wan 3.0, 14 с | Кондитер | нет | 197 |
slomannyj-pult | Сломанный пульт | Wan 3.0, 21 с | Кто жмёт пульт | нет | 298 |
spasennaya-tmoj | Спасённая тьмой | Wan 3.0, 30 с | Девушка; Вампир (можно без него) | нет | 445 |
steklyannyj-dozhd | Стеклянный дождь | Wan 3.0, 15 с | Кто у окна | нет | 218 |
steklyannyj-kub | Стеклянный куб | Wan 3.0, 16 с | Кто заперт в кубе | нет | 241 |
stolknovenie-v-slou-mo | Столкновение в слоу-мо | Wan 3.0, 11 с | Кто идёт с кофе | нет | 153 |
tort-v-holodilnike | Торт в холодильнике | Seedance 2.5, 9 с | Именинница | age (Возраст): число до 3 цифр | 278 |
utro-dnya-rozhdeniya | Утро дня рождения | Wan 3.0, 9 с | Именинник; Фото наряда (можно без него) | нет | 124 |
chto-upadet-s-yabloni | Что упадёт с яблони | Seedance 2.5, 13 с | Кто трясёт яблоню; Фото товара (можно без него) | нет | 402 |
balerina-pod-arestom | Балерина под арестом | Wan 3.0, 11 с | Балерина | нет | 153 |
glavnyj-priz | Главный приз | Seedance 2.5, 13 с | Игрок; Фото приза (можно без него) | нет | 402 |
ded-moroz-huligan | Дед Мороз-хулиган | Wan 3.0, 21 с | Хулиган | нет | 299 |
dopros-uhazhera | Допрос ухажёра | Wan 3.0, 30 с | Строгий отец; Ухажёр (можно без него) | нет | 444 |
druzya-nad-kanonom | Друзья над каньоном | Wan 3.0, 10 с | Друг слева; Друг справа (можно без него) | нет | 146 |
koshachij-razgovor | Кошачий разговор | Seedance 2.5, 17 с | Кот-слушатель; Кошка-болтушка (можно без него) | нет | 525 |
na-krayu-pobedy | На краю победы | Seedance 2.5, 11 с | Скалолаз; Фото товара (можно без него) | нет | 340 |
pogonya-nad-estakadoj | Погоня над эстакадой | Wan 3.0, 12 с | Летящий; На байке (можно без него) | нет | 168 |
snajper-s-kameroj | Снайпер | Wan 3.0, 19 с | Снайпер; Девушка у машины (можно без него) | нет | 270 |
duet-na-kuhne | Дуэт на кухне | Wan 3.0, 15 с | Певец; Спутница (можно без него) | нет | 211 |
intervyu-s-broshyuroj | Интервью с брошюрой | Seedance 2.5, 6 с | Кто даёт интервью | нет | 186 |
kot-i-burger | Кот и бургер | Wan 3.0, 20 с | Фото кота | нет | 285 |
poezd-ushel | Поезд ушёл | Wan 3.0, 14 с | Опоздавший | нет | 204 |
razgovor-korotkij | Разговор короткий | Seedance 2.5, 10 с | Кто говорит | нет | 309 |
obayatelnyj-moshennik | Обаятельный мошенник | Wan 3.0, 7 с | Мошенник; Дама в шляпе (можно без него) | нет | 102 |
paryashchij-tovar | Парящий товар | Seedance 2.5, 7 с | Фото товара | нет | 217 |
svist-v-koridore | Свист в коридоре | Wan 3.0, 13 с | Кто насвистывает | нет | 182 |
tanec-vrachej-u-mashiny | Танец врачей у машины | Wan 3.0, 20 с | Врач без очков; Врач в очках (можно без него) | нет | 284 |
skorpiony-dr | Скорпионы (ДР) | Wan 3.0, 11 с | Именинница | нет | 153 |
plan-b | План Б | Wan 3.0, 13 с | Кто с битой | нет | 182 |
on-ryadom | Он рядом | Wan 3.0, 30 с | Девушка на берегу | нет | 444 |
konec-90-h | Конец 90-х | Wan 3.0, 30 с | Девушка с папками; Незнакомец (можно без него) | нет | 445 |
ty-ne-odna | Ты не одна | Wan 3.0, 13 с | Девушка; Кто поднимает (можно без него) | нет | 182 |
day-sebe-shans | Дай себе шанс | Wan 3.0, 15 с | Кого спасают; Кто спасает (можно без него) | нет | 218 |
otpusti-sebya-prezhnyuyu | Отпусти себя прежнюю | Wan 3.0, 15 с | Вы сейчас; Вы прежняя | нет | 218 |
god-spustya | У каждой истории есть своё „год спустя“ | Seedance 2.5, 11 с | Герой истории | нет | 340 |
uzhe-ne-vernut | Уже не вернуть | Wan 3.0, 15 с | Девушка на берегу; Мужчина-призрак (можно без него) | нет | 218 |
vospominanie | Воспоминание | Wan 3.0, 19 с | Девушка на льду; Мужчина из воспоминания (можно без него) | нет | 269 |
zaduvaem-svechi | Задуваем свечи | Wan 3.0, 11 с | Именинница | нет | 153 |
v-dvizhenii | В движении | Seedance 2.0, 15 с | Ваше фото | нет | 259 |
sobiraemsya | Собираемся | Seedance 2.5, 16 с | Кто собирается | нет | 494 |
idealnyj-perehod | Идеальный переход | Seedance 2.5, 11 с | Героиня перехода | нет | 340 |
navozhu-krasotu | Навожу красоту | Seedance 2.5, 11 с | Кто у зеркала | нет | 340 |
chto-nadet | Что надеть? | Seedance 2.5, 16 с | Кто выбирает наряд | нет | 494 |
siyaj | Сияй | Wan 3.0, 30 с | Вы сейчас; Вы в детстве (можно без него); Ваш ребёнок (можно без него) | нет | 451 |
letayuschaya-mashina | Летающая машина | Wan 3.0, 15 с | Водитель | нет | 218 |
skorpionchik | Скорпиончик | Wan 3.0, 14 с | Именинница | нет | 197 |
neboskreb | Небоскрёб | Wan 3.0, 26 с | Девушка за окном; Мужчина в офисе (можно без него) | нет | 371 |
v-cvetochnom-obraze | В цветочном образе | Seedance 2.5, 10 с | Ваше фото | нет | 255 |
v-grimerke | В гримёрке | Seedance 2.5, 10 с | Ваше фото | нет | 255 |
prohodka-na-parkovke | Проходка на парковке | Seedance 2.5, 12 с | Кто идёт | нет | 371 |
okno | Окно | Wan 3.0, 15 с | Кто ест у окна; Фото еды (можно без него) | нет | 218 |
razbivaem-shampanskoe | Разбиваем шампанское | Seedance 2.5, 11 с | Кто разбивает бутылку; Фото одежды (можно без него) | нет | 340 |
kanat-nad-propastyu | Канат над пропастью | Wan 3.0, 15 с | Кто отпускает; Кого отпускают (можно без него) | нет | 218 |
malysh-na-doprose | Малыш на допросе | Seedance 2.5, 15 с | Малыш | нет | 463 |
pryzhok-podrug | Прыжок подруг | Seedance 2.5, 10 с | Подруга слева; Подруга справа (можно без него) | нет | 309 |
shpagat-pod-samoletom | Шпагат под самолётом | Seedance 2.5, 8 с | Кто прыгает в шпагат | нет | 247 |
podderzhka-blizkogo | Поддержка близкого | Wan 3.0, 15 с | Девушка босиком; Мужчина с пиджаком (можно без него) | нет | 218 |
malenkij-voin | Маленький воин | Seedance 2.5, 15 с | Фото ребёнка; Мама или папа (можно без него) | нет | 463 |
ona-stala-zombi | Она стала зомби | Seedance 2.5, 26 с | Мужчина; Девушка-зомби (можно без него) | нет | 803 |
on-stal-zombi | Он стал зомби | Seedance 2.5, 25 с | Девушка; Кто стал зомби (можно без него) | нет | 772 |
kofe-s-drakonom | Кофе с драконом | Wan 3.0, 11 с | Кто пьёт кофе | нет | 153 |
hellouin-na-podiume | Хэллоуин на подиуме | Seedance 2.5, 11 с | Кто на подиуме | costume (Образ): thorns «Шипы и трещины», vampire «Вампир», skeleton «Скелет», doll «Фарфоровая кукла», witch «Ведьма или колдун», ghost «Призрак» | 340 |
Файлы
Генерации принимают фото, видео и звук. Ниже: как их передать и какие у них пределы.
Фото
| Источник | Как указать в 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 с; у моделей свои пределы |
Загрузка файла
- Начните загрузку:
POST /uploadsс телом{ "kind": "video", "bytes": <размер в байтах> }.kind:photo,videoилиaudio. - Отправьте файл на
uploadUrlиз ответа: целиком однимPUTили кусками. Ключ не нужен: ссылка подписана и живёт 60 минут. - Укажите
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.
Генерация в ответе
| Поле | Что это |
|---|---|
id | id генерации |
type | video или image |
status | queued, 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 |
{
"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.
Уведомления
- Укажите
callbackUrlв телеPOST /generations:httpsи публичный адрес. - Когда генерация станет
doneилиfailed, сервер пришлётPOSTна этот адрес. Тело: генерация, как вGET /generations/{id}. - Ответьте кодом 2xx за 10 секунд. Тело ответа: пустое или до 64 КБ; длиннее уведомление считается недоставленным. Перенаправления сервер не проходит.
- Если ответа 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.
- Узнайте цену:
POST /generations/priceс тем же телом, что уPOST /generations. Хайпы не списываются. - Ответ:
price: цена всего запроса в хайпах,count: сколько генераций он создаст,currency:"hype". - Пришлите
maxPriceвPOST /generations: целое число хайпов за весь запрос. У картинок: за всеcountкартинок. - Если цена выше
maxPrice, ответ: 409price_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 на треть больше файла. Тело больше предела: ответ 413payload_too_large. - Переписка должна помещаться в контекст модели (
contextTokensвGET /models) с запасом на ответ. Иначе ответ: 413payload_too_large.
# 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: узнаёт баланс и цены, создаёт ролики и картинки, даёт ссылки на готовые файлы.
- Создайте ключ в Личный кабинет → API. Задайте ключу лимит в сутки: Claude тратит хайпы с баланса.
- Выполните в терминале команду ниже. Вместо
zv_…вставьте ключ. - Откройте новую сессию 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 без тела.
{ "error": { "code": "insufficient_balance", "message": "…" } }message: текст для человека, тот же, что на сайте. Программа сверяет code: текст может меняться.
| HTTP | code | Когда |
|---|---|---|
| 400 | bad_request | тело или параметры адреса не читаются: не JSON, текст не в UTF-8, нет Content-Length, неверный Idempotency-Key |
| 401 | missing_api_key | нет заголовка Authorization |
| 401 | invalid_api_key | ключ не того вида или такого ключа нет |
| 401 | key_revoked | ключ отозван |
| 402 | insufficient_balance | не хватает хайпов |
| 402 | key_daily_limit | ключ потратил свой лимит за сутки; сутки по Москве |
| 403 | account_blocked | аккаунт заблокирован |
| 403 | forbidden | запрос к MCP пришёл со страницы чужого сайта: заголовок Origin |
| 404 | not_found | нет такой генерации, загрузки, файла или адреса; временная ссылка устарела |
| 405 | method_not_allowed | только у MCP: метод не подходит адресу. Адреса /api/v1 на неверный метод отвечают 405 без тела |
| 409 | conflict | кусок загрузки не на своём месте; в ответе received: сколько байт уже есть |
| 409 | price_changed | цена выше maxPrice; хайпы не списаны |
| 413 | payload_too_large | файл или тело запроса больше предела |
| 422 | invalid_request | модель, режим, параметры или файлы не подходят; текст ошибки говорит, что исправить |
| 429 | rate_limited | запросы слишком часто |
| 500 | internal_error | сбой на сервере; повторите запрос |
| 502 | model_unavailable | нейросеть недоступна: модель чата не ответила или файлы на входе не дошли до нейросети; повторите позже |
| 503 | server_busy | сервер или нейросети заняты |
429 и 503 приходят с заголовком Retry-After, если сервер знает, через сколько секунд повторить. Без заголовка повторите через 5 секунд.
Новые code могут появиться без новой версии API. Незнакомый code обрабатывайте по статусу HTTP.
Лимиты
| Что | Предел | Сверх предела |
|---|---|---|
| Запросов с одного ключа | 120 в минуту | 429 rate_limited, Retry-After |
Из них созданий: POST /generations и POST /chat/completions | 30 в минуту | 429 rate_limited, Retry-After |
| Новых задач нейросетям от всех ключей API | 8 за 10 секунд; каждая картинка из count: отдельная задача | 503 server_busy, Retry-After |
| Генераций одновременно | без предела | |
| Ответов чата одновременно у аккаунта | 3 | 429 rate_limited |
| Трат ключа в сутки | лимит ключа в хайпах, сутки по Москве | 402 key_daily_limit |
| Промпт | 2 000 символов | 422 invalid_request |
GET /generations?ids= | 50 id | 400 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, тот же ключ.