# API Завирусим API делает то же, что сайт: ролики, картинки, «Улучшить качество», тренды и чат с нейросетями. Запросы идут из ваших программ, скриптов и Claude Code. Баланс и история генераций общие с сайтом. - **Основа адресов**: `https://zavirusim.ru/api/v1` - **Ключ**: заголовок `Authorization: Bearer zv_…` - **Формат**: JSON в UTF-8 - **Цены**: в хайпах, 1 хайп = 1 ₽ - **Для нейросетей**: [/llms.txt](https://zavirusim.ru/llms.txt), [/llms-full.txt](https://zavirusim.ru/llms-full.txt), [OpenAPI](https://zavirusim.ru/api/v1/openapi.json) Страница документации: https://zavirusim.ru/developers ## Быстрый старт Первый ролик через API: ключ, проверка баланса, создание и ожидание результата. 1. Войдите на сайт через Яндекс ID или Google. 2. Откройте [Личный кабинет → API](https://zavirusim.ru/account/api). 3. Нажмите «Создать ключ». Скопируйте ключ: он показывается один раз. 4. Сохраните ключ в переменную окружения `ZAVIRUSIM_API_KEY`. 5. Запустите пример ниже: он проверит баланс, создаст ролик и дождётся его. Пример делает ролик моделью Seedance 2.0 Mini: 5 с, 480p, формат 9:16. Цена: 18 хайпов. Если генерация не получится, хайпы вернутся на баланс. curl: ```bash # Ключ из «Личный кабинет → 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 из ответа" ``` Python: ```python import os import time import requests API = "https://zavirusim.ru/api/v1" HEADERS = {"Authorization": f"Bearer {os.environ['ZAVIRUSIM_API_KEY']}"} # 1. Проверить ключ и баланс me = requests.get(f"{API}/me", headers=HEADERS).json() print("Баланс:", me["balance"]["hypes"]) # 2. Создать ролик body = { "mode": "text", "modelId": "seedance-2-0-mini", "prompt": "Кот в очках катается на скейтборде по набережной на закате, камера едет рядом", "params": {"duration": 5, "aspectRatio": "9:16", "resolution": "480p", "audio": True}, } response = requests.post(f"{API}/generations", headers=HEADERS, json=body) if not response.ok: raise SystemExit(response.json()["error"]["message"]) generation = response.json()["generations"][0] # 3. Ждать результата: опрос раз в 5 секунд while generation["status"] in ("queued", "generating"): time.sleep(5) generation = requests.get(f"{API}/generations/{generation['id']}", headers=HEADERS).json() # 4. Скачать ролик: downloadUrl работает без ключа if generation["status"] == "done": name = generation["files"]["result"]["name"] with open(name, "wb") as file: file.write(requests.get(generation["downloadUrl"]).content) print("Готово:", name) else: print("Не получилось:", generation["error"]) ``` JavaScript: ```javascript // Node.js 18 и новее. Сохраните как quick-start.mjs import { writeFile } from "node:fs/promises"; const API = "https://zavirusim.ru/api/v1"; const headers = { Authorization: `Bearer ${process.env.ZAVIRUSIM_API_KEY}` }; // 1. Проверить ключ и баланс const me = await fetch(`${API}/me`, { headers }).then((r) => r.json()); console.log("Баланс:", me.balance.hypes); // 2. Создать ролик const body = { mode: "text", modelId: "seedance-2-0-mini", prompt: "Кот в очках катается на скейтборде по набережной на закате, камера едет рядом", params: { duration: 5, aspectRatio: "9:16", resolution: "480p", audio: true }, }; const response = await fetch(`${API}/generations`, { method: "POST", headers: { ...headers, "Content-Type": "application/json" }, body: JSON.stringify(body), }); const created = await response.json(); if (!response.ok) throw new Error(created.error.message); let generation = created.generations[0]; // 3. Ждать результата: опрос раз в 5 секунд while (generation.status === "queued" || generation.status === "generating") { await new Promise((resolve) => setTimeout(resolve, 5000)); generation = await fetch(`${API}/generations/${generation.id}`, { headers }).then((r) => r.json()); } // 4. Скачать ролик: downloadUrl работает без ключа if (generation.status === "done") { const file = await fetch(generation.downloadUrl); await writeFile(generation.files.result.name, Buffer.from(await file.arrayBuffer())); console.log("Готово:", generation.files.result.name); } else { console.log("Не получилось:", generation.error); } ``` > В 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`, раздел [«Не дороже»](https://zavirusim.ru/developers#max-price). - Получайте уведомление вместо опроса: поле `callbackUrl`, раздел [«Результат»](https://zavirusim.ru/developers#webhooks). - Выберите модель и режим: разделы [«Модели и цены»](https://zavirusim.ru/developers#models) и [«Видео»](https://zavirusim.ru/developers#video). ## Адреса Основа адресов: `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»](https://zavirusim.ru/developers#claude-code). ## Ключ API Ключ создаёт вошедший пользователь в [Личный кабинет → API](https://zavirusim.ru/account/api). Ключ открывает только его аккаунт: баланс, генерации и загрузки. Передавайте ключ заголовком: ```text 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` | Google | `text`, `image`, `frames` | 720p, 1080p, 4K | 9:16, 16:9 | всегда | 227 | | Veo 3.1 Fast | `veo-3-1-fast` | Google | `text`, `image`, `references`, `frames` | 720p, 1080p, 4K | 9:16, 16:9 | всегда | 55 | | Gemini Omni Flash 1.1 | `gemini-omni-flash-1-1` | Google | `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` | Google | `text`, `photo` | 1K: 17, 2K: 17, 4K: 22 | | Nano Banana 2 | `nano-banana-2` | Google | `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` | Google | 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` | фото по порядку, раздел [«Файлы»](https://zavirusim.ru/developers#files) | | `videos` | видео: `[{ "upload": "" }]` или `[{ "url": "https://…" }]` | | `audio` | звук: так же, как `videos` | | `maxPrice` | наибольшая цена в хайпах, раздел [«Не дороже»](https://zavirusim.ru/developers#max-price) | | `callbackUrl` | адрес уведомления о готовности, раздел [«Результат»](https://zavirusim.ru/developers#webhooks) | Заголовок `Idempotency-Key` защищает от двойного списания, раздел [«Повтор запроса»](https://zavirusim.ru/developers#idempotency). Поля `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: ```bash 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 } }' ``` Python: ```python import os import requests API = "https://zavirusim.ru/api/v1" HEADERS = {"Authorization": f"Bearer {os.environ['ZAVIRUSIM_API_KEY']}"} body = { "mode": "text", "modelId": "seedance-2-5", "prompt": "Кот в очках катается на скейтборде по набережной на закате, камера едет рядом", "params": {"duration": 5, "aspectRatio": "9:16", "resolution": "720p", "audio": True}, } response = requests.post(f"{API}/generations", headers=HEADERS, json=body) print(response.status_code, response.json()) ``` JavaScript: ```javascript const API = "https://zavirusim.ru/api/v1"; const headers = { Authorization: `Bearer ${process.env.ZAVIRUSIM_API_KEY}` }; const body = { mode: "text", modelId: "seedance-2-5", prompt: "Кот в очках катается на скейтборде по набережной на закате, камера едет рядом", params: { duration: 5, aspectRatio: "9:16", resolution: "720p", audio: true }, }; const response = await fetch(`${API}/generations`, { method: "POST", headers: { ...headers, "Content-Type": "application/json" }, body: JSON.stringify(body), }); console.log(response.status, await response.json()); ``` ### `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 | ```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.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 | ```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.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 | ```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.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 | ```json { "mode": "video", "modelId": "seedance-2-5", "prompt": "Замени человека в видео на человека с фото, движения те же", "params": { "duration": 5, "aspectRatio": "9:16", "resolution": "720p", "audio": true }, "photos": [{ "source": "mine", "id": "" }], "videos": [{ "upload": "" }] } ``` ### `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 | ```json { "mode": "motion", "modelId": "kling-3-0-motion", "params": { "resolution": "720p" }, "photos": [{ "source": "mine", "id": "" }], "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` | наибольшая цена всего запроса, раздел [«Не дороже»](https://zavirusim.ru/developers#max-price) | | `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: ```bash 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 }' ``` Python: ```python import os import requests API = "https://zavirusim.ru/api/v1" HEADERS = {"Authorization": f"Bearer {os.environ['ZAVIRUSIM_API_KEY']}"} body = { "kind": "image", "mode": "text", "modelId": "nano-banana-pro", "prompt": "Капибара в спа с полотенцем на голове, мягкий свет, фотореализм", "params": {"aspectRatio": "3:4", "resolution": "2K"}, "count": 2, } response = requests.post(f"{API}/generations", headers=HEADERS, json=body) print(response.status_code, response.json()) ``` JavaScript: ```javascript const API = "https://zavirusim.ru/api/v1"; const headers = { Authorization: `Bearer ${process.env.ZAVIRUSIM_API_KEY}` }; const body = { kind: "image", mode: "text", modelId: "nano-banana-pro", prompt: "Капибара в спа с полотенцем на голове, мягкий свет, фотореализм", params: { aspectRatio: "3:4", resolution: "2K" }, count: 2, }; const response = await fetch(`${API}/generations`, { method: "POST", headers: { ...headers, "Content-Type": "application/json" }, body: JSON.stringify(body), }); console.log(response.status, await response.json()); ``` ### По фото ```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` | одно фото, раздел [«Файлы»](https://zavirusim.ru/developers#files) | | `count` | не указывать или `1` | | `maxPrice` | наибольшая цена в хайпах | | `callbackUrl` | адрес уведомления о готовности | | Модель | `modelId` | Разработчик | `factor` | Цена | |---|---|---|---|---| | Recraft Crisp Upscale | `recraft-crisp-upscale` | Recraft | не нужен: до ×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" }] } ``` ## Тренды Тренд: готовая сцена со своей моделью, длиной, звуком и скрытым промптом. Вы присылаете фото, формат и качество. Список трендов: `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`. ```json { "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": "" }` | фото из «Моих фотографий»: `GET /me/photos` | | `file` | `{ "source": "file", "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: ```bash 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" ``` Python: ```python import json import os import requests API = "https://zavirusim.ru/api/v1" HEADERS = {"Authorization": f"Bearer {os.environ['ZAVIRUSIM_API_KEY']}"} payload = { "mode": "image", "modelId": "seedance-2-5", "prompt": "Человек на фото улыбается и машет рукой, лёгкий ветер в волосах", "params": {"duration": 5, "aspectRatio": "9:16", "resolution": "720p", "audio": True}, "photos": [{"source": "upload"}], } with open("first-frame.jpg", "rb") as photo: response = requests.post( f"{API}/generations", headers=HEADERS, data={"payload": json.dumps(payload)}, files=[("photo", ("first-frame.jpg", photo, "image/jpeg"))], ) print(response.status_code, response.json()) ``` JavaScript: ```javascript import { readFile } from "node:fs/promises"; const API = "https://zavirusim.ru/api/v1"; const headers = { Authorization: `Bearer ${process.env.ZAVIRUSIM_API_KEY}` }; const payload = { mode: "image", modelId: "seedance-2-5", prompt: "Человек на фото улыбается и машет рукой, лёгкий ветер в волосах", params: { duration: 5, aspectRatio: "9:16", resolution: "720p", audio: true }, photos: [{ source: "upload" }], }; const form = new FormData(); form.append("payload", JSON.stringify(payload)); form.append("photo", new Blob([await readFile("first-frame.jpg")], { type: "image/jpeg" }), "first-frame.jpg"); const response = await fetch(`${API}/generations`, { method: "POST", headers, body: form }); console.log(response.status, await response.json()); ``` ### Видео и звук Видео (`videos`) и звук (`audio`) указываются так: `{ "upload": "" }` или `{ "url": "https://…" }`. Сервер перекодирует видео и звук для нейросети. У каждой модели свои пределы числа и длины файлов: поля `videos` и `audio` режима в `GET /models` и таблицы раздела [«Видео»](https://zavirusim.ru/developers#video). ### Пределы | Файл | Форматы | Размер | Длина | |---|---|---|---| | Фото | 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": "" }` у видео и звука, `{ "source": "file", "id": "" }` у фото. > Один `PUT` сервер обрывает через 5 минут. Если файл может идти дольше, шлите его кусками: так делают примеры на Python и JavaScript. curl: ```bash # 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" ``` Python: ```python import os import requests API = "https://zavirusim.ru/api/v1" HEADERS = {"Authorization": f"Bearer {os.environ['ZAVIRUSIM_API_KEY']}"} path = "dance.mp4" response = requests.post(f"{API}/uploads", headers=HEADERS, json={"kind": "video", "bytes": os.path.getsize(path)}) if not response.ok: raise SystemExit(response.json()["error"]["message"]) upload = response.json() # Кусками: при обрыве связи повторяется только один кусок with open(path, "rb") as file: offset = 0 while chunk := file.read(upload["chunkBytes"]): response = requests.put(upload["uploadUrl"], params={"offset": offset}, data=chunk) if response.status_code == 409 and "received" in response.json(): offset = response.json()["received"] # сервер уже получил больше: продолжаем с этого байта file.seek(offset) continue response.raise_for_status() offset += len(chunk) # В генерации: "videos": [{"upload": upload["id"]}] print(upload["id"]) ``` JavaScript: ```javascript import { readFile } from "node:fs/promises"; const API = "https://zavirusim.ru/api/v1"; const headers = { Authorization: `Bearer ${process.env.ZAVIRUSIM_API_KEY}` }; const file = await readFile("dance.mp4"); const created = await fetch(`${API}/uploads`, { method: "POST", headers: { ...headers, "Content-Type": "application/json" }, body: JSON.stringify({ kind: "video", bytes: file.length }), }); const upload = await created.json(); if (!created.ok) throw new Error(upload.error.message); // Кусками: при обрыве связи повторяется только один кусок let offset = 0; while (offset < file.length) { const chunk = file.subarray(offset, offset + upload.chunkBytes); const response = await fetch(`${upload.uploadUrl}&offset=${offset}`, { method: "PUT", body: chunk }); const state = await response.json(); if (response.status === 409 && state.received !== undefined) { offset = state.received; // сервер уже получил больше: продолжаем с этого байта continue; } if (!response.ok) throw new Error(state.error.message); offset += chunk.length; } // В генерации: videos: [{ upload: upload.id }] console.log(upload.id); ``` Ответ `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=,`, до 50 id через запятую. - История: `GET /generations?type=all`. `type`: `all`, `video` или `image`. За раз: 60 генераций, новые сверху. Ответ: `generations`, `more` и `next`. Если `more: true`, следующая страница: `?before=`. - Генерации общие с сайтом: созданные через 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` | ```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=,v1=<подпись>`. `v1`: HMAC-SHA256 в hex от строки `.<тело запроса>` на секрете уведомлений. Секрет один на аккаунт. Он в [Личный кабинет → API](https://zavirusim.ru/account/api). Там же секрет можно перевыпустить: старый перестаёт подходить сразу. Проверяйте подпись по сырому телу запроса, до разбора JSON. Отклоняйте уведомление, если `t` старше 5 минут. Python: ```python 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 ``` JavaScript: ```javascript import { createHmac, timingSafeEqual } from "node:crypto"; /** rawBody: сырое тело запроса (Buffer); header: заголовок Zavirusim-Signature; secret: секрет уведомлений */ export function verifySignature(rawBody, header, secret, toleranceSeconds = 300) { const parts = Object.fromEntries(header.split(",").map((item) => item.split("="))); const timestamp = Number(parts.t); if (!Number.isInteger(timestamp) || !parts.v1) return false; const expected = Buffer.from(createHmac("sha256", secret).update(`${parts.t}.`).update(rawBody).digest("hex")); const given = Buffer.from(parts.v1); if (given.length !== expected.length || !timingSafeEqual(expected, given)) return false; return Math.abs(Date.now() / 1000 - timestamp) <= toleranceSeconds; } // Express: // app.post("/hooks/zavirusim", express.raw({ type: "application/json" }), (req, res) => { // if (!verifySignature(req.body, req.get("Zavirusim-Signature") ?? "", SECRET)) return res.sendStatus(400); // const generation = JSON.parse(req.body); // res.sendStatus(204); // }); ``` ## Повтор запроса Связь может оборваться, когда хайпы уже списаны. Повторите запрос с тем же заголовком `Idempotency-Key`: сервер вернёт те же генерации и второй раз не спишет. - Значение: от 8 до 64 знаков: латинские буквы, цифры и дефис. Подходит UUID. - Первый запрос: ответ 201 и новые генерации. - Повтор с тем же значением: ответ 200 и те же `generations`. Сервер отвечает сразу: файлы не скачиваются заново, хайпы второй раз не списываются. - Для каждой новой генерации нужно новое значение. - Без заголовка каждый запрос создаёт новую генерацию. - Значение не того вида: ответ 400 `bad_request`. curl: ```bash 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 } }' ``` Python: ```python # API, HEADERS и body: из быстрого старта import uuid key = str(uuid.uuid4()) # одно значение на одну генерацию response = requests.post(f"{API}/generations", headers={**HEADERS, "Idempotency-Key": key}, json=body) # Связь оборвалась: тот же запрос с тем же key вернёт ту же генерацию ``` JavaScript: ```javascript // API, headers и body: из быстрого старта const key = crypto.randomUUID(); // одно значение на одну генерацию const response = await fetch(`${API}/generations`, { method: "POST", headers: { ...headers, "Content-Type": "application/json", "Idempotency-Key": key }, body: JSON.stringify(body), }); // Связь оборвалась: тот же запрос с тем же key вернёт ту же генерацию ``` ## Не дороже Цены меняются. Чтобы не заплатить больше, чем ожидаете, пришлите `maxPrice`. 1. Узнайте цену: `POST /generations/price` с тем же телом, что у `POST /generations`. Хайпы не списываются. 2. Ответ: `price`: цена всего запроса в хайпах, `count`: сколько генераций он создаст, `currency`: `"hype"`. 3. Пришлите `maxPrice` в `POST /generations`: целое число хайпов за весь запрос. У картинок: за все `count` картинок. 4. Если цена выше `maxPrice`, ответ: 409 `price_changed`. Хайпы не списываются. curl: ```bash 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 } }' ``` Ответ: ```json { "price": 18, "count": 1, "currency": "hype" } ``` Цена «Улучшить качество» зависит от размера фото, а цена с видео на входе зависит от длины видео. Для них `POST /generations/price` читает фото и загрузки. Видео и звук по ссылке он не скачивает: сначала загрузите их через `POST /uploads`. ## Чат Чат работает в формате OpenAI Chat Completions: `POST /chat/completions`. Программа для OpenAI подключается сменой адреса и ключа: адрес `https://zavirusim.ru/api/v1`, ключ: ваш ключ API. curl: ```bash 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": "Придумай идею вирусного ролика про кофейню" } ] }' ``` Python: ```python import os from openai import OpenAI client = OpenAI(base_url="https://zavirusim.ru/api/v1", api_key=os.environ["ZAVIRUSIM_API_KEY"]) answer = client.chat.completions.create( model="gpt-6-astra", messages=[ {"role": "system", "content": "Отвечай коротко."}, {"role": "user", "content": "Придумай идею вирусного ролика про кофейню"}, ], ) print(answer.choices[0].message.content) print("Цена, копеек хайпа:", answer.cost) ``` JavaScript: ```javascript import OpenAI from "openai"; const client = new OpenAI({ baseURL: "https://zavirusim.ru/api/v1", apiKey: process.env.ZAVIRUSIM_API_KEY }); const answer = await client.chat.completions.create({ model: "gpt-6-astra", messages: [ { role: "system", content: "Отвечай коротко." }, { role: "user", content: "Придумай идею вирусного ролика про кофейню" }, ], }); console.log(answer.choices[0].message.content); console.log("Цена, копеек хайпа:", answer.cost); ``` ### Запрос - `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]`. Python: ```python # 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) ``` JavaScript: ```javascript // client: из первого примера чата const stream = await client.chat.completions.create({ model: "gpt-6-astra", messages: [{ role: "user", content: "Напиши сценарий ролика на 15 секунд" }], stream: true, }); for await (const chunk of stream) { process.stdout.write(chunk.choices[0]?.delta?.content ?? ""); } ``` ### Цена и пределы - Цена ответа считается по токенам, в копейках хайпа. Копейки копятся, целые хайпы списываются с баланса. - Перед ответом сервер проверяет баланс: на нём должно хватать на переписку и ответ в 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](https://zavirusim.ru/account/api). Задайте ключу лимит в сутки: Claude тратит хайпы с баланса. 2. Выполните в терминале команду ниже. Вместо `zv_…` вставьте ключ. 3. Откройте новую сессию Claude Code. Спросите: «Сколько у меня хайпов на Завирусим?» ```bash 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 файл ""`. ## Ошибки Ошибка приходит JSON. Исключение: метод, которого у адреса нет (например, `PATCH`), получает 405 без тела. ```json { "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, тот же ключ.