{"openapi":"3.1.0","info":{"title":"API Завирусим","version":"2026-11-17","description":"Всё, что умеет сайт Завирусим, из своих программ: видео, картинки, «Улучшить качество», тренды и чат с нейросетями. Ключ создаётся в разделе «API» личного кабинета и передаётся заголовком Authorization: Bearer <ключ>. Цены в хайпах: 1 хайп = 1 ₽, баланс общий с сайтом. Модели, режимы, лимиты и цены меняются вместе с сайтом: берите их из GET /models. Изменения API: x-changelog. MCP для Claude Code: https://zavirusim.ru/api/mcp."},"externalDocs":{"description":"Документация","url":"https://zavirusim.ru/developers"},"servers":[{"url":"https://zavirusim.ru/api/v1"}],"tags":[{"name":"Аккаунт","description":"Баланс и «Мои фотографии»."},{"name":"Каталог","description":"Модели, цены и тренды. Без ключа."},{"name":"Загрузки","description":"Свои фото, видео и звук для генераций."},{"name":"Генерации","description":"Видео, картинки, «Улучшить качество» и тренды."},{"name":"Чат","description":"Ответы моделей чата в формате OpenAI."}],"security":[{"apiKey":[]}],"paths":{"/me":{"get":{"tags":["Аккаунт"],"operationId":"getMe","summary":"Имя и баланс","description":"Баланс общий с сайтом: хайпы с копейками, которые набрал чат.","responses":{"200":{"description":"Имя и баланс.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Me"}}}},"401":{"$ref":"#/components/responses/Error401"},"403":{"$ref":"#/components/responses/Error403"},"429":{"$ref":"#/components/responses/Error429"},"500":{"$ref":"#/components/responses/Error500"}}}},"/me/photos":{"get":{"tags":["Аккаунт"],"operationId":"listMyPhotos","summary":"«Мои фотографии»","description":"Фото, которые человек сохранил на сайте в «Моих фотографиях»: свои, друзей, близких. id подходит в photos как { \"source\": \"mine\", \"id\": \"…\" }. Добавляются и удаляются на сайте.","responses":{"200":{"description":"«Мои фотографии».","content":{"application/json":{"schema":{"$ref":"#/components/schemas/MyPhotos"}}}},"401":{"$ref":"#/components/responses/Error401"},"403":{"$ref":"#/components/responses/Error403"},"429":{"$ref":"#/components/responses/Error429"},"500":{"$ref":"#/components/responses/Error500"}}}},"/models":{"get":{"tags":["Каталог"],"operationId":"listModels","summary":"Модели, режимы и цены","description":"Без ключа. Те же модели, режимы, лимиты и цены, что на сайте: цены обновляются вместе с ценами сайта. Берите значения отсюда, а не из кода программы: модели приходят и уходят.","security":[],"parameters":[{"name":"type","in":"query","required":false,"description":"Только один вид моделей.","schema":{"type":"string","enum":["video","image","motion","upscale","chat"]}}],"responses":{"200":{"description":"Каталог.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Catalog"}}}},"400":{"$ref":"#/components/responses/Error400"}}}},"/trends":{"get":{"tags":["Каталог"],"operationId":"listTrends","summary":"Тренды","description":"Без ключа. Фото, поля, форматы, цены и ролик-пример каждого тренда. Ролик тренда создаёт POST /generations с kind: \"trend\".","security":[],"responses":{"200":{"description":"Тренды: сначала новинки.","content":{"application/json":{"schema":{"type":"object","properties":{"trends":{"type":"array","items":{"$ref":"#/components/schemas/Trend"}}},"required":["trends"]}}}}}}},"/openapi.json":{"get":{"tags":["Каталог"],"operationId":"getOpenApi","summary":"Это описание","description":"Без ключа. OpenAPI 3.1 с ценами на сейчас.","security":[],"responses":{"200":{"description":"Описание API.","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/uploads":{"post":{"tags":["Загрузки"],"operationId":"createUpload","summary":"Начать загрузку файла","description":"Фото, видео или звук для генерации. { kind, bytes }: файл пришлёт программа одним PUT на uploadUrl или кусками с ?offset=. { kind, url }: файл скачает сервер. uploadUrl работает без ключа 60 минут: подходит для curl -T. Загрузка живёт сутки. В генерации фото из загрузки: { \"source\": \"file\", \"id\": id }, видео и звук: { \"upload\": id }.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UploadRequest"}}}},"responses":{"201":{"description":"Загрузка создана.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Upload"}}}},"400":{"$ref":"#/components/responses/Error400"},"401":{"$ref":"#/components/responses/Error401"},"403":{"$ref":"#/components/responses/Error403"},"413":{"$ref":"#/components/responses/Error413"},"422":{"$ref":"#/components/responses/Error422"},"429":{"$ref":"#/components/responses/Error429"},"500":{"$ref":"#/components/responses/Error500"},"503":{"$ref":"#/components/responses/Error503"}}}},"/uploads/{id}":{"parameters":[{"$ref":"#/components/parameters/UploadId"}],"put":{"tags":["Загрузки"],"operationId":"putUpload","summary":"Файл целиком или кусок","description":"Тело: байты файла. ?offset=N: кусок с N-го байта. Кусок не с того места: ответ 409 с полем received, продолжите с него. Ответ: состояние загрузки. После последнего куска processing, потом ready.","security":[{"apiKey":[]},{}],"parameters":[{"name":"offset","in":"query","required":false,"description":"С какого байта кусок. Без него: с начала.","schema":{"type":"integer","minimum":0}},{"$ref":"#/components/parameters/UploadToken"}],"requestBody":{"required":true,"content":{"application/octet-stream":{"schema":{"type":"string","contentMediaType":"application/octet-stream"}}}},"responses":{"200":{"description":"Кусок принят.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UploadState"}}}},"400":{"$ref":"#/components/responses/Error400"},"401":{"$ref":"#/components/responses/Error401"},"403":{"$ref":"#/components/responses/Error403"},"404":{"$ref":"#/components/responses/Error404"},"409":{"description":"Кусок не на своём месте или уже принимается.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","description":"Код ошибки: по нему программа решает, что делать. Новые коды могут добавиться.","enum":["conflict"]},"message":{"type":"string","description":"Текст для человека: тот же, что на сайте."}},"required":["code","message"]},"received":{"type":"integer","description":"Сколько байт уже получено: продолжите с этого места."}},"required":["error"]}}}},"429":{"$ref":"#/components/responses/Error429"},"500":{"$ref":"#/components/responses/Error500"},"503":{"$ref":"#/components/responses/Error503"}}},"get":{"tags":["Загрузки"],"operationId":"getUpload","summary":"Состояние загрузки","security":[{"apiKey":[]},{}],"parameters":[{"$ref":"#/components/parameters/UploadToken"}],"responses":{"200":{"description":"Состояние загрузки.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UploadState"}}}},"401":{"$ref":"#/components/responses/Error401"},"403":{"$ref":"#/components/responses/Error403"},"404":{"$ref":"#/components/responses/Error404"},"429":{"$ref":"#/components/responses/Error429"},"500":{"$ref":"#/components/responses/Error500"}}},"delete":{"tags":["Загрузки"],"operationId":"deleteUpload","summary":"Удалить загрузку","responses":{"204":{"description":"Загрузки больше нет."},"401":{"$ref":"#/components/responses/Error401"},"403":{"$ref":"#/components/responses/Error403"},"429":{"$ref":"#/components/responses/Error429"},"500":{"$ref":"#/components/responses/Error500"}}}},"/generations/price":{"post":{"tags":["Генерации"],"operationId":"quoteGeneration","summary":"Цена без списания","description":"Тело как у POST /generations. Цена считается по тем же формулам, что спишет создание. Хайпы и задачи нейросетям не тратятся. Видео и звук по ссылке для цены не скачиваются: сначала загрузите их через POST /uploads.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GenerationRequest"}},"multipart/form-data":{"schema":{"type":"object","description":"Фото в том же запросе: поле payload и поля photo по порядку.","properties":{"payload":{"type":"string","description":"Тело генерации JSON-строкой: те же поля, что в application/json.","contentMediaType":"application/json"},"photo":{"type":"array","description":"Файлы фото «upload» по порядку: JPEG, PNG или WebP, до 5 МБ каждый.","items":{"type":"string","contentMediaType":"application/octet-stream"}}},"required":["payload","photo"]},"encoding":{"photo":{"contentType":"image/jpeg, image/png, image/webp"}}}}},"responses":{"200":{"description":"Цена.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Price"}}}},"400":{"$ref":"#/components/responses/Error400"},"401":{"$ref":"#/components/responses/Error401"},"403":{"$ref":"#/components/responses/Error403"},"413":{"$ref":"#/components/responses/Error413"},"422":{"$ref":"#/components/responses/Error422"},"429":{"$ref":"#/components/responses/Error429"},"500":{"$ref":"#/components/responses/Error500"},"503":{"$ref":"#/components/responses/Error503"}}}},"/generations":{"post":{"tags":["Генерации"],"operationId":"createGeneration","summary":"Создать генерацию","description":"Тело как у формы сайта. Хайпы списываются сразу; если не получилось, они возвращаются. Картинок за раз бывает до 4: в ответе столько генераций. Готовность: GET /generations/{id} раз в 5 секунд или уведомление на callbackUrl.","parameters":[{"$ref":"#/components/parameters/IdempotencyKey"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GenerationRequest"}},"multipart/form-data":{"schema":{"type":"object","description":"Фото в том же запросе: поле payload и поля photo по порядку.","properties":{"payload":{"type":"string","description":"Тело генерации JSON-строкой: те же поля, что в application/json.","contentMediaType":"application/json"},"photo":{"type":"array","description":"Файлы фото «upload» по порядку: JPEG, PNG или WebP, до 5 МБ каждый.","items":{"type":"string","contentMediaType":"application/octet-stream"}}},"required":["payload","photo"]},"encoding":{"photo":{"contentType":"image/jpeg, image/png, image/webp"}}}}},"responses":{"200":{"description":"Повтор с тем же Idempotency-Key: те же генерации, второй раз хайпы не списаны.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GenerationList"}}}},"201":{"description":"Генерации созданы.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GenerationList"}}}},"400":{"$ref":"#/components/responses/Error400"},"401":{"$ref":"#/components/responses/Error401"},"402":{"$ref":"#/components/responses/Error402"},"403":{"$ref":"#/components/responses/Error403"},"409":{"$ref":"#/components/responses/Error409"},"413":{"$ref":"#/components/responses/Error413"},"422":{"$ref":"#/components/responses/Error422"},"429":{"$ref":"#/components/responses/Error429"},"500":{"$ref":"#/components/responses/Error500"},"502":{"$ref":"#/components/responses/Error502"},"503":{"$ref":"#/components/responses/Error503"}},"callbacks":{"generationFinished":{"{$request.body#/callbackUrl}":{"post":{"summary":"Уведомление о готовности","description":"После done или failed сервер шлёт POST с генерацией. Ответ 2xx: уведомление доставлено. Иначе повтор через 1, 5, 30, 120, 360 минут. Ответа ждём 10 секунд, перенаправления не выполняются.","parameters":[{"name":"Zavirusim-Signature","in":"header","required":true,"description":"t=<unix-время>,v1=<HMAC-SHA256 от строки «t.тело» на секрете уведомлений, hex>. Секрет: раздел «API» личного кабинета. Сверяйте t со своими часами, чтобы не принять старое уведомление повторно.","schema":{"type":"string"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Generation"}}}},"responses":{"2XX":{"description":"Уведомление принято."}}}}}}},"get":{"tags":["Генерации"],"operationId":"listGenerations","summary":"История или несколько генераций","description":"История: новые сверху, по 60. Следующая страница: ?before= со значением next. ?ids=: несколько генераций по id, до 50.","parameters":[{"name":"type","in":"query","required":false,"description":"Что показать.","schema":{"type":"string","enum":["all","video","image"],"default":"all"}},{"name":"before","in":"query","required":false,"description":"id генерации: страница после неё.","schema":{"type":"string","maxLength":64}},{"name":"ids","in":"query","required":false,"description":"До 50 id через запятую. С ним type и before не читаются.","schema":{"type":"string"}}],"responses":{"200":{"description":"Генерации.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/GenerationPage"}}}},"400":{"$ref":"#/components/responses/Error400"},"401":{"$ref":"#/components/responses/Error401"},"403":{"$ref":"#/components/responses/Error403"},"429":{"$ref":"#/components/responses/Error429"},"500":{"$ref":"#/components/responses/Error500"}}}},"/generations/{id}":{"parameters":[{"$ref":"#/components/parameters/GenerationId"}],"get":{"tags":["Генерации"],"operationId":"getGeneration","summary":"Статус и ссылки на файлы","responses":{"200":{"description":"Генерация.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Generation"}}}},"401":{"$ref":"#/components/responses/Error401"},"403":{"$ref":"#/components/responses/Error403"},"404":{"$ref":"#/components/responses/Error404"},"429":{"$ref":"#/components/responses/Error429"},"500":{"$ref":"#/components/responses/Error500"}}},"delete":{"tags":["Генерации"],"operationId":"deleteGeneration","summary":"Удалить генерацию","description":"Как «Удалить» на сайте: файлы стираются.","responses":{"204":{"description":"Генерации больше нет."},"401":{"$ref":"#/components/responses/Error401"},"403":{"$ref":"#/components/responses/Error403"},"404":{"$ref":"#/components/responses/Error404"},"429":{"$ref":"#/components/responses/Error429"},"500":{"$ref":"#/components/responses/Error500"}}}},"/generations/{id}/files/{name}":{"parameters":[{"$ref":"#/components/parameters/GenerationId"},{"$ref":"#/components/parameters/FileName"}],"get":{"tags":["Генерации"],"operationId":"getGenerationFile","summary":"Скачать файл","description":"Готовый файл, превью или файл на входе. Тип: в заголовке Content-Type. Поддерживает Range: можно докачивать.","responses":{"200":{"description":"Файл.","content":{"application/octet-stream":{}}},"206":{"description":"Часть файла по Range.","content":{"application/octet-stream":{}}},"304":{"description":"Файл не изменился: метка совпала с If-None-Match."},"401":{"$ref":"#/components/responses/Error401"},"403":{"$ref":"#/components/responses/Error403"},"404":{"$ref":"#/components/responses/Error404"},"416":{"description":"Range за пределами файла."},"429":{"$ref":"#/components/responses/Error429"},"500":{"$ref":"#/components/responses/Error500"}}}},"/chat/completions":{"post":{"tags":["Чат"],"operationId":"createChatCompletion","summary":"Ответ модели чата","description":"Формат OpenAI Chat Completions: программа, которая умеет OpenAI, подключается сменой адреса и ключа. Цена: по факту, в копейках хайпа (поле cost). Перед ответом сервер проверяет запас на балансе. Переписка не сохраняется: историю держит программа.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChatCompletionRequest"}}}},"responses":{"200":{"description":"Ответ целиком или поток.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ChatCompletion"}},"text/event-stream":{"schema":{"type":"string","description":"Поток SSE при stream: true. Строки data: с объектами chat.completion.chunk (choices[].delta), в последнем куске usage и cost, в конце data: [DONE]. Сбой во время ответа: строка data: с объектом error."}}}},"400":{"$ref":"#/components/responses/Error400"},"401":{"$ref":"#/components/responses/Error401"},"402":{"$ref":"#/components/responses/Error402"},"403":{"$ref":"#/components/responses/Error403"},"413":{"$ref":"#/components/responses/Error413"},"422":{"$ref":"#/components/responses/Error422"},"429":{"$ref":"#/components/responses/Error429"},"500":{"$ref":"#/components/responses/Error500"},"502":{"$ref":"#/components/responses/Error502"},"503":{"$ref":"#/components/responses/Error503"}}}}},"components":{"securitySchemes":{"apiKey":{"type":"http","scheme":"bearer","bearerFormat":"zv_…","description":"Ключ из раздела «API» личного кабинета: zv_ и 40 букв и цифр. Ключ открывает только свой аккаунт."}},"parameters":{"GenerationId":{"name":"id","in":"path","required":true,"description":"id генерации.","schema":{"type":"string","maxLength":64}},"FileName":{"name":"name","in":"path","required":true,"description":"Имя файла из files или inputs генерации.","schema":{"type":"string","maxLength":64}},"UploadId":{"name":"id","in":"path","required":true,"description":"id загрузки из POST /uploads.","schema":{"type":"string"}},"UploadToken":{"name":"token","in":"query","required":false,"description":"Подпись из uploadUrl: с ней ключ не нужен.","schema":{"type":"string"}},"IdempotencyKey":{"name":"Idempotency-Key","in":"header","required":false,"description":"Ключ повтора: 8-64 знака, латинские буквы, цифры и дефис. Повтор с тем же ключом вернёт ту же генерацию и второй раз не спишет хайпы.","schema":{"type":"string","pattern":"^[A-Za-z0-9-]{8,64}$"}}},"headers":{"RetryAfter":{"description":"Через сколько секунд повторить запрос.","schema":{"type":"integer"}}},"responses":{"Error400":{"description":"Запрос не читается: тело, заголовок или параметры не того вида.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","description":"Код ошибки: по нему программа решает, что делать. Новые коды могут добавиться.","enum":["bad_request"]},"message":{"type":"string","description":"Текст для человека: тот же, что на сайте."}},"required":["code","message"]}},"required":["error"]}}}},"Error401":{"description":"Нет ключа, ключ неверный или отозван.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","description":"Код ошибки: по нему программа решает, что делать. Новые коды могут добавиться.","enum":["missing_api_key","invalid_api_key","key_revoked"]},"message":{"type":"string","description":"Текст для человека: тот же, что на сайте."}},"required":["code","message"]}},"required":["error"]}}}},"Error402":{"description":"Не хватает хайпов, или ключ потратил свой лимит трат за сутки.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","description":"Код ошибки: по нему программа решает, что делать. Новые коды могут добавиться.","enum":["insufficient_balance","key_daily_limit"]},"message":{"type":"string","description":"Текст для человека: тот же, что на сайте."}},"required":["code","message"]}},"required":["error"]}}}},"Error403":{"description":"Аккаунт заблокирован.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","description":"Код ошибки: по нему программа решает, что делать. Новые коды могут добавиться.","enum":["account_blocked","forbidden"]},"message":{"type":"string","description":"Текст для человека: тот же, что на сайте."}},"required":["code","message"]}},"required":["error"]}}}},"Error404":{"description":"Нет такой генерации, загрузки, файла или адреса.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","description":"Код ошибки: по нему программа решает, что делать. Новые коды могут добавиться.","enum":["not_found"]},"message":{"type":"string","description":"Текст для человека: тот же, что на сайте."}},"required":["code","message"]}},"required":["error"]}}}},"Error405":{"description":"Адрес не принимает этот метод.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","description":"Код ошибки: по нему программа решает, что делать. Новые коды могут добавиться.","enum":["method_not_allowed"]},"message":{"type":"string","description":"Текст для человека: тот же, что на сайте."}},"required":["code","message"]}},"required":["error"]}}}},"Error409":{"description":"Цена выше maxPrice (price_changed) или кусок загрузки не на своём месте (conflict).","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","description":"Код ошибки: по нему программа решает, что делать. Новые коды могут добавиться.","enum":["conflict","price_changed"]},"message":{"type":"string","description":"Текст для человека: тот же, что на сайте."}},"required":["code","message"]}},"required":["error"]}}}},"Error413":{"description":"Файл или тело запроса больше предела.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","description":"Код ошибки: по нему программа решает, что делать. Новые коды могут добавиться.","enum":["payload_too_large"]},"message":{"type":"string","description":"Текст для человека: тот же, что на сайте."}},"required":["code","message"]}},"required":["error"]}}}},"Error422":{"description":"Модель, режим, параметры или файлы не подходят: что не так, написано в message.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","description":"Код ошибки: по нему программа решает, что делать. Новые коды могут добавиться.","enum":["invalid_request"]},"message":{"type":"string","description":"Текст для человека: тот же, что на сайте."}},"required":["code","message"]}},"required":["error"]}}}},"Error429":{"description":"Слишком много запросов. Повторите через столько секунд, сколько в заголовке Retry-After.","headers":{"Retry-After":{"$ref":"#/components/headers/RetryAfter"}},"content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","description":"Код ошибки: по нему программа решает, что делать. Новые коды могут добавиться.","enum":["rate_limited"]},"message":{"type":"string","description":"Текст для человека: тот же, что на сайте."}},"required":["code","message"]}},"required":["error"]}}}},"Error500":{"description":"Сбой на сервере. Повторите запрос.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","description":"Код ошибки: по нему программа решает, что делать. Новые коды могут добавиться.","enum":["internal_error"]},"message":{"type":"string","description":"Текст для человека: тот же, что на сайте."}},"required":["code","message"]}},"required":["error"]}}}},"Error502":{"description":"Нейросеть не приняла задачу или не ответила.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","description":"Код ошибки: по нему программа решает, что делать. Новые коды могут добавиться.","enum":["model_unavailable"]},"message":{"type":"string","description":"Текст для человека: тот же, что на сайте."}},"required":["code","message"]}},"required":["error"]}}}},"Error503":{"description":"Сервер или нейросети заняты. Повторите позже: через столько секунд, сколько в заголовке Retry-After, если он есть.","headers":{"Retry-After":{"$ref":"#/components/headers/RetryAfter"}},"content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","description":"Код ошибки: по нему программа решает, что делать. Новые коды могут добавиться.","enum":["server_busy"]},"message":{"type":"string","description":"Текст для человека: тот же, что на сайте."}},"required":["code","message"]}},"required":["error"]}}}}},"schemas":{"Error":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string","description":"Код ошибки: по нему программа решает, что делать. Новые коды могут добавиться.","enum":["bad_request","missing_api_key","invalid_api_key","key_revoked","insufficient_balance","key_daily_limit","account_blocked","forbidden","not_found","method_not_allowed","conflict","price_changed","payload_too_large","invalid_request","rate_limited","internal_error","model_unavailable","server_busy"]},"message":{"type":"string","description":"Текст для человека: тот же, что на сайте."}},"required":["code","message"]}},"required":["error"]},"Me":{"type":"object","properties":{"name":{"type":"string","description":"Имя в профиле."},"balance":{"type":"object","properties":{"hypes":{"type":"number","description":"Баланс в хайпах, с копейками."},"kopecks":{"type":"integer","description":"Баланс в копейках хайпа."},"available":{"type":"number","description":"Свободно сейчас, хайпов: ответы чата, которые ещё пишутся, держат свой запас."}},"required":["hypes","kopecks","available"]}},"required":["name","balance"]},"MyPhotos":{"type":"object","properties":{"photos":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"id для photos: { \"source\": \"mine\", \"id\": \"…\" }."},"width":{"type":"integer","description":"Ширина, px."},"height":{"type":"integer","description":"Высота, px."}},"required":["id","width","height"]}}},"required":["photos"]},"Price":{"type":"object","properties":{"price":{"type":"integer","description":"Цена всего запроса, хайпов: при count больше 1 за все картинки."},"count":{"type":"integer","description":"Сколько генераций создаст запрос."},"currency":{"type":"string","description":"Хайпы: 1 хайп = 1 ₽.","enum":["hype"]}},"required":["price","count","currency"]},"UploadRequest":{"description":"Пределы: фото до 25 МБ, видео до 200 МБ, звук до 15 МБ.","oneOf":[{"type":"object","description":"Файл пришлёт программа: PUT на uploadUrl.","properties":{"kind":{"type":"string","description":"Вид файла.","enum":["photo","video","audio"]},"bytes":{"type":"integer","description":"Размер файла, байт.","minimum":1}},"required":["kind","bytes"]},{"type":"object","description":"Файл скачает сервер.","properties":{"kind":{"type":"string","description":"Вид файла.","enum":["photo","video","audio"]},"url":{"type":"string","description":"https-ссылка на публичный адрес.","format":"uri"}},"required":["kind","url"]}]},"Upload":{"type":"object","description":"Новая загрузка.","properties":{"id":{"type":"string","description":"id загрузки."},"kind":{"type":"string","description":"Вид файла.","enum":["photo","video","audio"]},"uploadUrl":{"type":"string","description":"Куда слать файл: PUT без ключа, 60 минут. GET по ней же: состояние загрузки.","format":"uri"},"chunkBytes":{"type":"integer","description":"Удобный размер куска, байт: для загрузки кусками с ?offset=."},"status":{"type":"string","description":"uploading: ждём байты. processing: сервер готовит файл. ready: можно в генерацию. failed: не получилось, причина в error.","enum":["uploading","processing","ready","failed"]},"received":{"type":"integer","description":"Получено байт: следующий кусок с этого места."},"bytes":{"type":"integer","description":"Размер файла, байт."},"seconds":{"type":"number","description":"Длина видео или звука, с."},"error":{"type":"string","description":"Почему не получилось."}},"required":["id","kind","uploadUrl","chunkBytes","status"]},"UploadState":{"type":"object","description":"Состояние загрузки.","properties":{"id":{"type":"string","description":"id загрузки. Нет в ответе на PUT."},"status":{"type":"string","description":"uploading: ждём байты. processing: сервер готовит файл. ready: можно в генерацию. failed: не получилось, причина в error.","enum":["uploading","processing","ready","failed"]},"received":{"type":"integer","description":"Получено байт: следующий кусок с этого места."},"bytes":{"type":"integer","description":"Размер файла, байт."},"seconds":{"type":"number","description":"Длина видео или звука, с."},"error":{"type":"string","description":"Почему не получилось."}},"required":["status"]},"GenerationFile":{"type":"object","properties":{"name":{"type":"string","description":"Имя файла."},"url":{"type":"string","description":"Ссылка: работает с ключом.","format":"uri"},"type":{"type":"string","description":"MIME-тип."},"width":{"type":"integer","description":"Ширина, px."},"height":{"type":"integer","description":"Высота, px."}},"required":["name","url","type"]},"InputClip":{"type":"object","properties":{"url":{"type":"string","description":"Ссылка: работает с ключом.","format":"uri"},"seconds":{"type":"number","description":"Длина, с."}},"required":["url","seconds"]},"Generation":{"type":"object","description":"Генерация: ролик или картинка.","properties":{"id":{"type":"string","description":"id генерации."},"type":{"type":"string","description":"Ролик или картинка.","enum":["video","image"]},"status":{"type":"string","description":"queued: ждёт очереди. generating: нейросеть работает. done: готово, есть files и downloadUrl. failed: не получилось, причина в error, хайпы вернулись на баланс.","enum":["queued","generating","done","failed"]},"mode":{"type":"string","description":"Режим генерации.","enum":["text","image","frames","references","video","motion","photo","upscale"]},"modelId":{"type":"string","description":"id модели."},"modelName":{"type":"string","description":"Название модели."},"prompt":{"type":"string","description":"Промпт. У тренда: подпись с названием тренда."},"params":{"type":"object","description":"Настройки: у ролика все поля, у картинки формат и качество.","properties":{"duration":{"type":"integer","description":"Длина ролика, с."},"aspectRatio":{"type":"string","description":"Формат."},"resolution":{"type":"string","description":"Качество."},"audio":{"type":"boolean","description":"Звук."}},"required":["aspectRatio","resolution"]},"price":{"type":["integer","null"],"description":"Списано хайпов."},"createdAt":{"type":"string","description":"Время запуска, ISO 8601.","format":"date-time"},"files":{"type":["object","null"],"description":"Готовый файл и превью: при status done. Ссылки работают с ключом.","properties":{"result":{"$ref":"#/components/schemas/GenerationFile"},"preview":{"$ref":"#/components/schemas/GenerationFile"}},"required":["result"]},"downloadUrl":{"type":["string","null"],"description":"Ссылка на готовый файл без ключа: 24 часа. Новую даёт GET /generations/{id}.","format":"uri"},"error":{"type":["string","null"],"description":"Почему не получилось: текст для человека. Хайпы уже вернулись."},"inputs":{"type":["object","null"],"description":"Файлы на входе по порядку. Ссылки работают с ключом.","properties":{"photos":{"type":"array","description":"Фото на входе.","items":{"type":"string","format":"uri"}},"videos":{"type":"array","description":"Видео на входе.","items":{"$ref":"#/components/schemas/InputClip"}},"audio":{"type":"array","description":"Звук на входе.","items":{"$ref":"#/components/schemas/InputClip"}}},"required":["photos","videos","audio"]},"trend":{"type":["object","null"],"description":"Ролик тренда.","properties":{"id":{"type":"string","description":"id тренда."},"title":{"type":"string","description":"Название тренда."}},"required":["id","title"]}},"required":["id","type","status","mode","modelId","modelName","prompt","params","price","createdAt","files","downloadUrl","error","inputs","trend"]},"GenerationList":{"type":"object","properties":{"generations":{"type":"array","items":{"$ref":"#/components/schemas/Generation"}}},"required":["generations"]},"GenerationPage":{"type":"object","properties":{"generations":{"type":"array","description":"Новые сверху.","items":{"$ref":"#/components/schemas/Generation"}},"more":{"type":"boolean","description":"Есть ещё. Нет в ответе на ?ids=."},"next":{"type":["string","null"],"description":"id для ?before=: следующая страница. Нет в ответе на ?ids=."}},"required":["generations"]},"ClipLimits":{"type":"object","properties":{"count":{"type":"object","description":"Сколько файлов.","properties":{"min":{"type":"integer"},"max":{"type":"integer"}},"required":["min","max"]},"seconds":{"type":"object","description":"Длина одного файла, с.","properties":{"min":{"type":"number"},"max":{"type":"number"}},"required":["min","max"]},"totalSeconds":{"type":"number","description":"Все файлы вместе, с."},"maxMb":{"type":"number","description":"Размер одного файла, МБ."}},"required":["count","seconds","totalSeconds","maxMb"]},"VideoMode":{"type":"object","properties":{"mode":{"type":"string","description":"Режим: значение mode запроса."},"title":{"type":"string","description":"Название режима на сайте."},"durations":{"type":"array","description":"Длины ролика, с. -1: «по видео», ролик длится как видео на входе.","items":{"type":"integer"}},"formatFromPhoto":{"type":"boolean","description":"Формат ролика берётся из фото, а не из aspectRatio."},"photos":{"type":["object","null"],"description":"Фото на входе: кадры, образцы или фото к видео.","properties":{"min":{"type":"integer"},"max":{"type":"integer"}},"required":["min","max"]},"videos":{"anyOf":[{"$ref":"#/components/schemas/ClipLimits"},{"type":"null"}]},"audio":{"anyOf":[{"$ref":"#/components/schemas/ClipLimits"},{"type":"null"}]},"maxInputPlusOutputSeconds":{"type":["number","null"],"description":"Видео на входе вместе с новым роликом, с: не дольше."},"byVideoMinSeconds":{"type":["number","null"],"description":"Длительность -1 «по видео»: каждое видео на входе не короче, с."},"priceFrom":{"type":"integer","description":"Самая низкая цена в режиме, хайпов."}},"required":["mode","title","durations","formatFromPhoto","photos","videos","audio","maxInputPlusOutputSeconds","byVideoMinSeconds","priceFrom"]},"VideoPrice":{"type":"object","properties":{"duration":{"type":"integer","description":"Длина, с."},"resolution":{"type":"string","description":"Качество."},"audio":{"type":"boolean","description":"Звук."},"price":{"type":"integer","description":"Хайпов."}},"required":["duration","resolution","audio","price"]},"VideoModel":{"type":"object","properties":{"id":{"type":"string","description":"id модели: modelId запроса."},"name":{"type":"string","description":"Название."},"developer":{"type":["string","null"],"description":"Разработчик модели."},"type":{"type":"string","enum":["video"]},"aspectRatios":{"type":"array","description":"Форматы.","items":{"type":"string"}},"resolutions":{"type":"array","description":"Качество.","items":{"type":"string"}},"audio":{"type":"string","description":"Звук. toggle: выбирает params.audio. always: всегда есть. none: нет.","enum":["toggle","always","none"]},"defaults":{"type":"object","description":"Настройки по умолчанию.","properties":{"duration":{"type":"integer"},"aspectRatio":{"type":"string"},"resolution":{"type":"string"},"audio":{"type":"boolean"}},"required":["duration","aspectRatio","resolution","audio"]},"modes":{"type":"array","description":"Режимы модели.","items":{"$ref":"#/components/schemas/VideoMode"}},"prices":{"type":"array","description":"Цена ролика без файлов на входе: каждая длина, качество и звук. С видео на входе и с платными фото цену даёт POST /generations/price.","items":{"$ref":"#/components/schemas/VideoPrice"}},"paidPhotosFrom":{"type":["integer","null"],"description":"С этого по счёту фото на входе фото стоят дополнительно."}},"required":["id","name","developer","type","aspectRatios","resolutions","audio","defaults","modes","prices","paidPhotosFrom"]},"ImageModel":{"type":"object","properties":{"id":{"type":"string","description":"id модели: modelId запроса."},"name":{"type":"string","description":"Название."},"developer":{"type":["string","null"],"description":"Разработчик модели."},"type":{"type":"string","enum":["image"]},"modes":{"type":"array","description":"Режимы модели.","items":{"type":"object","properties":{"mode":{"type":"string","description":"Режим."},"title":{"type":"string","description":"Название режима на сайте."},"photos":{"type":["object","null"],"description":"Фото на входе.","properties":{"min":{"type":"integer"},"max":{"type":"integer"}},"required":["min","max"]}},"required":["mode","title","photos"]}},"aspectRatios":{"type":"array","description":"Форматы.","items":{"type":"string"}},"resolutions":{"type":"array","description":"Качество.","items":{"type":"string"}},"excluded":{"type":"array","description":"Сочетания формата и качества, которых нет.","items":{"type":"object","properties":{"aspectRatio":{"type":"string"},"resolution":{"type":"string"}},"required":["aspectRatio","resolution"]}},"defaults":{"type":"object","description":"Настройки по умолчанию.","properties":{"aspectRatio":{"type":"string"},"resolution":{"type":"string"}},"required":["aspectRatio","resolution"]},"counts":{"type":"array","description":"Картинок за один запрос: значения count.","items":{"type":"integer"}},"prices":{"type":"array","description":"Цена одной картинки по качеству, хайпов.","items":{"type":"object","properties":{"resolution":{"type":"string"},"price":{"type":"integer"}},"required":["resolution","price"]}},"paidPhotosFrom":{"type":["integer","null"],"description":"С этого по счёту фото на входе фото стоят дополнительно."},"priceFrom":{"type":"integer","description":"Самая низкая цена картинки, хайпов."}},"required":["id","name","developer","type","modes","aspectRatios","resolutions","excluded","defaults","counts","prices","paidPhotosFrom","priceFrom"]},"MotionModel":{"type":"object","properties":{"id":{"type":"string","description":"id модели: modelId запроса."},"name":{"type":"string","description":"Название."},"developer":{"type":["string","null"],"description":"Разработчик модели."},"type":{"type":"string","enum":["motion"]},"resolutions":{"type":"array","description":"Качество.","items":{"type":"string"}},"defaultResolution":{"type":"string","description":"Качество по умолчанию."},"video":{"$ref":"#/components/schemas/ClipLimits"},"prices":{"type":"array","description":"Примеры цен: цена за каждую начатую секунду видео.","items":{"type":"object","properties":{"resolution":{"type":"string"},"seconds":{"type":"integer"},"price":{"type":"integer"}},"required":["resolution","seconds","price"]}},"priceFrom":{"type":"integer","description":"Самая низкая цена, хайпов."}},"required":["id","name","developer","type","resolutions","defaultResolution","video","prices","priceFrom"]},"UpscaleModel":{"type":"object","properties":{"id":{"type":"string","description":"id модели: modelId запроса."},"name":{"type":"string","description":"Название."},"developer":{"type":["string","null"],"description":"Разработчик модели."},"type":{"type":"string","enum":["upscale"]},"factors":{"type":["array","null"],"description":"Во сколько раз увеличить: значения factor. null: решает модель.","items":{"type":"integer"}},"factorNote":{"type":["string","null"],"description":"Подпись увеличения, если его выбирает модель."},"photoSide":{"type":"object","description":"Длинная сторона фото, px.","properties":{"min":{"type":"integer"},"max":{"type":"integer"}},"required":["min","max"]},"prices":{"type":"array","description":"Цены: по длинной стороне результата (фото × factor) или одна за картинку.","items":{"type":"object","properties":{"maxSide":{"type":["integer","null"],"description":"Длинная сторона результата, px: не больше. null: одна цена за картинку."},"price":{"type":"integer"}},"required":["maxSide","price"]}},"priceFrom":{"type":"integer","description":"Самая низкая цена, хайпов."}},"required":["id","name","developer","type","factors","factorNote","photoSide","prices","priceFrom"]},"ChatModel":{"type":"object","properties":{"id":{"type":"string","description":"id модели: model запроса."},"name":{"type":"string","description":"Название."},"developer":{"type":"string","description":"Разработчик модели."},"type":{"type":"string","enum":["chat"]},"description":{"type":"string","description":"Чем модель хороша."},"contextTokens":{"type":"integer","description":"Окно контекста, токенов."},"photos":{"type":"boolean","description":"Видит фото."},"pdf":{"type":"boolean","description":"Читает PDF."},"search":{"type":"boolean","description":"Ищет в интернете: web_search_options."},"perMillionTokens":{"type":"object","description":"Хайпов за 1 млн токенов: вход и ответ.","properties":{"input":{"type":"number"},"output":{"type":"number"}},"required":["input","output"]},"typicalAnswer":{"type":"number","description":"Обычный ответ: вопрос 1000 токенов, ответ 700, хайпов."}},"required":["id","name","developer","type","description","contextTokens","photos","pdf","search","perMillionTokens","typicalAnswer"]},"Catalog":{"type":"object","description":"Каталог. С ?type= в ответе только этот вид и limits.","properties":{"video":{"type":"array","items":{"$ref":"#/components/schemas/VideoModel"}},"image":{"type":"array","items":{"$ref":"#/components/schemas/ImageModel"}},"motion":{"type":"array","description":"Модели «Повтора движения».","items":{"$ref":"#/components/schemas/MotionModel"}},"upscale":{"type":"array","description":"Модели «Улучшить качество».","items":{"$ref":"#/components/schemas/UpscaleModel"}},"chat":{"type":"array","items":{"$ref":"#/components/schemas/ChatModel"}},"limits":{"type":"object","description":"Общие пределы запроса.","properties":{"promptMaxChars":{"type":"integer","description":"Длина промпта, символов."},"photoMaxBytes":{"type":"integer","description":"Фото в multipart, байт."},"imageCounts":{"type":"array","description":"Картинок за один запрос.","items":{"type":"integer"}}},"required":["promptMaxChars","photoMaxBytes","imageCounts"]}},"required":["limits"]},"Trend":{"type":"object","properties":{"id":{"type":"string","description":"id тренда: trendId запроса."},"title":{"type":"string","description":"Название."},"hint":{"type":"string","description":"Какие фото загрузить."},"categories":{"type":"array","description":"Разделы каталога трендов.","items":{"type":"string"}},"isNew":{"type":"boolean","description":"Новинка."},"model":{"type":"object","description":"Модель ролика: для справки, тренд создаётся по trendId.","properties":{"id":{"type":"string"},"name":{"type":"string"}},"required":["id","name"]},"duration":{"type":"integer","description":"Длина ролика, с."},"audio":{"type":"boolean","description":"Звук."},"aspectRatios":{"type":"array","description":"Форматы.","items":{"type":"string"}},"defaultAspectRatio":{"type":"string","description":"Формат по умолчанию."},"resolutions":{"type":"array","description":"Качество.","items":{"type":"string"}},"defaultResolution":{"type":"string","description":"Качество по умолчанию."},"photos":{"type":"array","description":"Фото по порядку: n-е фото это n-й элемент photos запроса.","items":{"type":"object","properties":{"label":{"type":"string","description":"Что на фото."},"optional":{"type":"boolean","description":"Можно не присылать."}},"required":["label","optional"]}},"fields":{"type":"array","description":"Поля тренда: их значения идут в trendFields запроса.","items":{"oneOf":[{"type":"object","properties":{"key":{"type":"string","description":"Ключ в trendFields."},"label":{"type":"string","description":"Подпись."},"kind":{"type":"string","enum":["number"]},"maxDigits":{"type":"integer","description":"Цифр, не больше."}},"required":["key","label","kind","maxDigits"]},{"type":"object","properties":{"key":{"type":"string","description":"Ключ в trendFields."},"label":{"type":"string","description":"Подпись."},"kind":{"type":"string","enum":["choice"]},"options":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Значение для trendFields."},"label":{"type":"string","description":"Подпись."}},"required":["id","label"]}}},"required":["key","label","kind","options"]}]}},"prices":{"type":"array","description":"Цена ролика с одним фото по качеству, хайпов.","items":{"type":"object","properties":{"resolution":{"type":"string"},"price":{"type":"integer"}},"required":["resolution","price"]}},"example":{"type":["object","null"],"description":"Ролик-пример и обложка.","properties":{"video":{"type":"string","format":"uri"},"poster":{"type":"string","format":"uri"}},"required":["video","poster"]}},"required":["id","title","hint","categories","isNew","model","duration","audio","aspectRatios","defaultAspectRatio","resolutions","defaultResolution","photos","fields","prices","example"]},"ChatCompletionRequest":{"type":"object","description":"Запрос в формате OpenAI Chat Completions. Поля, которых здесь нет (temperature, max_tokens, tools), не читаются.","properties":{"model":{"type":"string","description":"Модель: id из GET /models?type=chat.","enum":["gpt-6-astra","claude-sonnet-5-5","gemini-4-argon","claude-fable-5","grok-4-7","deepseek-v4-1-flash"],"x-enumDescriptions":{"gpt-6-astra":"GPT-6 Astra, OpenAI. Обычный ответ около 2,29 хайпа","claude-sonnet-5-5":"Claude Sonnet 5.5, Anthropic. Обычный ответ около 0,66 хайпа","gemini-4-argon":"Gemini 4 Argon, Google. Обычный ответ около 0,66 хайпа","claude-fable-5":"Claude Fable 5, Anthropic. Обычный ответ около 3,27 хайпа","grok-4-7":"Grok 4.7, xAI. Обычный ответ около 0,46 хайпа","deepseek-v4-1-flash":"DeepSeek V4.1 Flash, DeepSeek. Обычный ответ около 0,09 хайпа"}},"messages":{"type":"array","description":"Переписка. Историю держит программа: сервер её не хранит.","items":{"$ref":"#/components/schemas/ChatMessage"},"minItems":1},"stream":{"type":"boolean","description":"true: поток SSE, как у OpenAI, в конце data: [DONE]. Без него: ответ целиком."},"web_search_options":{"type":"object","description":"Поиск в интернете: передайте {}. Работает у моделей с search: true.","properties":{},"additionalProperties":true}},"required":["model","messages"]},"ChatMessage":{"type":"object","properties":{"role":{"type":"string","description":"system и developer: инструкция модели. user и assistant: реплики.","enum":["system","developer","user","assistant"]},"content":{"oneOf":[{"type":"string","description":"Текст."},{"type":"array","description":"Части сообщения.","items":{"$ref":"#/components/schemas/ChatContentPart"}},{"type":"null"}]}},"required":["role","content"]},"ChatContentPart":{"oneOf":[{"type":"object","description":"Текст.","properties":{"type":{"type":"string","enum":["text"]},"text":{"type":"string"}},"required":["type","text"]},{"type":"object","description":"Фото: только у user и у моделей с photos: true.","properties":{"type":{"type":"string","enum":["image_url"]},"image_url":{"oneOf":[{"type":"object","properties":{"url":{"type":"string","description":"data:-ссылка или https-ссылка на фото."}},"required":["url"]},{"type":"string","description":"data:-ссылка или https-ссылка на фото."}]}},"required":["type","image_url"]},{"type":"object","description":"PDF: только у user и у моделей с pdf: true.","properties":{"type":{"type":"string","enum":["file"]},"file":{"type":"object","properties":{"file_data":{"type":"string","description":"PDF в base64 или data:application/pdf;base64,…"},"filename":{"type":"string","description":"Имя файла."}},"required":["file_data"]}},"required":["type","file"]}]},"ChatCompletion":{"type":"object","properties":{"id":{"type":"string","description":"id ответа: chatcmpl-…"},"object":{"type":"string","enum":["chat.completion"]},"created":{"type":"integer","description":"Время ответа, unix-секунды."},"model":{"type":"string","description":"id модели."},"choices":{"type":"array","items":{"type":"object","properties":{"index":{"type":"integer"},"message":{"type":"object","properties":{"role":{"type":"string","enum":["assistant"]},"content":{"type":"string","description":"Ответ модели."},"annotations":{"type":"array","description":"Источники поиска.","items":{"type":"object","properties":{"type":{"type":"string","enum":["url_citation"]},"url_citation":{"type":"object","properties":{"url":{"type":"string","format":"uri"},"title":{"type":"string"}},"required":["url","title"]}},"required":["type","url_citation"]}}},"required":["role","content","annotations"]},"finish_reason":{"type":"string","description":"stop: ответ закончен. length: ответ оборвался.","enum":["stop","length"]}},"required":["index","message","finish_reason"]}},"usage":{"type":"object","description":"Токены.","properties":{"prompt_tokens":{"type":"integer"},"completion_tokens":{"type":"integer"},"total_tokens":{"type":"integer"}},"required":["prompt_tokens","completion_tokens","total_tokens"]},"cost":{"type":"integer","description":"Цена ответа в копейках хайпа."},"warning":{"type":"string","description":"Ответ оборвался: текст для человека."}},"required":["id","object","created","model","choices","usage","cost"]},"PhotoSource":{"description":"Фото на входе: JPEG, PNG или WebP. Сервер сам приводит фото к JPEG.","oneOf":[{"type":"object","description":"Фото из «Моих фотографий» на сайте.","properties":{"source":{"type":"string","enum":["mine"]},"id":{"type":"string","description":"id из GET /me/photos."}},"required":["source","id"]},{"type":"object","description":"Фото из загрузки.","properties":{"source":{"type":"string","enum":["file"]},"id":{"type":"string","description":"id загрузки вида photo из POST /uploads."}},"required":["source","id"]},{"type":"object","description":"Фото по ссылке: сервер скачает его сам.","properties":{"source":{"type":"string","enum":["url"]},"url":{"type":"string","description":"https-ссылка на публичный адрес.","format":"uri"}},"required":["source","url"]},{"type":"object","description":"Файл в том же запросе: multipart, поля photo по порядку.","properties":{"source":{"type":"string","enum":["upload"]}},"required":["source"]}]},"ClipSource":{"description":"Видео или звук на входе.","oneOf":[{"type":"object","description":"Файл из загрузки.","properties":{"upload":{"type":"string","description":"id загрузки вида video или audio из POST /uploads."}},"required":["upload"]},{"type":"object","description":"Файл по ссылке: сервер скачает его сам.","properties":{"url":{"type":"string","description":"https-ссылка на публичный адрес.","format":"uri"}},"required":["url"]}]},"VideoGenerationRequest":{"type":"object","description":"Видео во всех режимах, кроме «Повтора движения».","properties":{"kind":{"type":"string","description":"Вид генерации. У видео можно не указывать.","enum":["video"]},"mode":{"type":"string","description":"Режим: что нейросеть получает на входе. text: только промпт. image: одно фото станет первым кадром. frames: два фото, первый и последний кадр. references: от двух фото, люди и предметы с фото в новом ролике. video: видео на входе, фото и звук по желанию. Режимы модели: modes в GET /models?type=video.","enum":["text","image","references","frames","video"]},"modelId":{"type":"string","description":"Модель: id из GET /models?type=video.","enum":["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"],"x-enumDescriptions":{"seedance-2-5":"Seedance 2.5, ByteDance. Режимы: text, image, references, frames, video. Ролик от 109 хайпов","seedance-2-0":"Seedance 2.0, ByteDance. Режимы: text, image, references, frames, video. Ролик от 74 хайпов","seedance-2-0-mini":"Seedance 2.0 Mini, ByteDance. Режимы: text, image, references, frames, video. Ролик от 16 хайпов","kling-3-0":"Kling 3.0, Kuaishou. Режимы: text, image, references, frames. Ролик от 69 хайпов","veo-3-1":"Veo 3.1, Google. Режимы: text, image, frames. Ролик от 227 хайпов","veo-3-1-fast":"Veo 3.1 Fast, Google. Режимы: text, image, references, frames. Ролик от 55 хайпов","gemini-omni-flash-1-1":"Gemini Omni Flash 1.1, Google. Режимы: text, image, references, frames, video. Ролик от 58 хайпов","minimax-h3":"MiniMax H3, MiniMax. Режимы: text, image, references, frames, video. Ролик от 44 хайпов","wan-3-0":"Wan 3.0, Alibaba. Режимы: text, image, references, frames, video. Ролик от 37 хайпов"}},"prompt":{"type":"string","description":"Что происходит в ролике: от 3 до 2000 символов.","minLength":3,"maxLength":2000},"params":{"type":"object","description":"Настройки ролика. Чего нет в запросе, берётся из defaults модели (GET /models).","properties":{"duration":{"type":"integer","description":"Длина ролика, с: одна из durations режима модели. -1: «по видео», ролик повторяет длину видео на входе.","enum":[-1,4,5,6,8,10,15,20,30]},"aspectRatio":{"type":"string","description":"Формат: один из aspectRatios модели. Если у режима formatFromPhoto, формат ролика берётся из фото.","enum":["9:16","16:9","1:1","3:4","4:3","21:9"]},"resolution":{"type":"string","description":"Качество: одно из resolutions модели.","enum":["480p","720p","1080p","4K","360p","768p","2K"]},"audio":{"type":"boolean","description":"Звук. Нужен моделям с audio: toggle, у остальных звук задаёт модель."}}},"photos":{"type":"array","description":"Фото по порядку: первый кадр, кадры или образцы. Сколько можно: photos режима модели.","items":{"$ref":"#/components/schemas/PhotoSource"},"maxItems":9},"videos":{"type":"array","description":"Видео на входе, режим video. Сколько и какой длины: videos режима модели.","items":{"$ref":"#/components/schemas/ClipSource"},"maxItems":3},"audio":{"type":"array","description":"Звук на входе: голос или музыка, режимы references и video. Пределы: audio режима модели.","items":{"$ref":"#/components/schemas/ClipSource"},"maxItems":3},"maxPrice":{"type":"integer","description":"Не дороже, хайпов: цена из POST /generations/price. Если цена выше, ответ 409 price_changed и хайпы не списываются.","minimum":0},"callbackUrl":{"type":"string","description":"Адрес уведомления о готовности: https, публичный. После done или failed сервер пришлёт сюда POST с генерацией.","format":"uri"}},"required":["mode","modelId","prompt"]},"ImageGenerationRequest":{"type":"object","description":"Картинки: «Текст → картинка» и «По фото».","properties":{"kind":{"type":"string","description":"Вид генерации.","enum":["image"]},"mode":{"type":"string","description":"Режим. text: картинка по промпту. photo: по фото, изменить фото или взять с него людей, предметы и стиль.","enum":["text","photo"]},"modelId":{"type":"string","description":"Модель: id из GET /models?type=image.","enum":["nano-banana-pro","nano-banana-2","gpt-image-2-6","gpt-image-2-5","gpt-image-2","seedream-5-pro","flux-2-pro","grok-imagine-2-0"],"x-enumDescriptions":{"nano-banana-pro":"Nano Banana Pro, Google. Картинка от 17 хайпов","nano-banana-2":"Nano Banana 2, Google. Картинка от 8 хайпов","gpt-image-2-6":"GPT Image 2.6, OpenAI. Картинка от 7 хайпов","gpt-image-2-5":"GPT Image 2.5, OpenAI. Картинка от 6 хайпов","gpt-image-2":"GPT Image 2, OpenAI. Картинка от 6 хайпов","seedream-5-pro":"Seedream 5.0 Pro, ByteDance. Картинка от 7 хайпов","flux-2-pro":"Flux 2 Pro, Black Forest Labs. Картинка от 5 хайпов","grok-imagine-2-0":"Grok Imagine 2.0, xAI. Картинка от 4 хайпов"}},"prompt":{"type":"string","description":"Что на картинке: от 3 до 2000 символов.","minLength":3,"maxLength":2000},"params":{"type":"object","description":"Настройки картинки. Чего нет в запросе, берётся из defaults модели (GET /models).","properties":{"aspectRatio":{"type":"string","description":"Формат: один из aspectRatios модели. Сочетания из excluded не подходят.","enum":["1:1","4:5","3:4","2:3","9:16","5:4","4:3","3:2","16:9","21:9"]},"resolution":{"type":"string","description":"Качество: одно из resolutions модели.","enum":["1K","2K","4K"]}}},"count":{"type":"integer","description":"Сколько картинок за раз: каждая станет отдельной генерацией со своей ценой. Нет поля: одна.","enum":[1,2,3,4],"default":1},"photos":{"type":"array","description":"Фото для режима photo: от одного до photos.max модели.","items":{"$ref":"#/components/schemas/PhotoSource"},"maxItems":16},"maxPrice":{"type":"integer","description":"Не дороже, хайпов: цена из POST /generations/price. Если цена выше, ответ 409 price_changed и хайпы не списываются.","minimum":0},"callbackUrl":{"type":"string","description":"Адрес уведомления о готовности: https, публичный. После done или failed сервер пришлёт сюда POST с генерацией.","format":"uri"}},"required":["kind","mode","modelId","prompt"]},"TrendGenerationRequest":{"type":"object","description":"Ролик тренда. Модель, длину, звук и промпт задаёт тренд.","properties":{"kind":{"type":"string","description":"Вид генерации.","enum":["trend"]},"trendId":{"type":"string","description":"Тренд: id из GET /trends."},"photos":{"type":"array","description":"Фото по порядку, как photos тренда: n-е фото станет n-м фото тренда.","items":{"$ref":"#/components/schemas/PhotoSource"},"minItems":1},"params":{"type":"object","description":"Настройки ролика. Чего нет в запросе, берётся из defaultAspectRatio и defaultResolution тренда (GET /trends).","properties":{"aspectRatio":{"type":"string","description":"Формат: один из aspectRatios тренда."},"resolution":{"type":"string","description":"Качество: одно из resolutions тренда."}}},"trendFields":{"type":"object","description":"Поля тренда (fields): ключ это key поля, значение это число цифрами или id варианта.","properties":{},"additionalProperties":{"type":"string"}},"maxPrice":{"type":"integer","description":"Не дороже, хайпов: цена из POST /generations/price. Если цена выше, ответ 409 price_changed и хайпы не списываются.","minimum":0},"callbackUrl":{"type":"string","description":"Адрес уведомления о готовности: https, публичный. После done или failed сервер пришлёт сюда POST с генерацией.","format":"uri"}},"required":["kind","trendId","photos"]},"MotionGenerationRequest":{"type":"object","description":"«Повтор движения». Цена: за каждую начатую секунду видео.","properties":{"kind":{"type":"string","description":"Вид генерации. Можно не указывать.","enum":["video"]},"mode":{"type":"string","description":"«Повтор движения»: человек с фото повторяет движения из видео.","enum":["motion"]},"modelId":{"type":"string","description":"Модель: id из GET /models?type=motion.","enum":["kling-3-0-motion","kling-2-6-motion"],"x-enumDescriptions":{"kling-3-0-motion":"Kling 3.0 Motion Control, Kuaishou. Ролик от 62 хайпов","kling-2-6-motion":"Kling 2.6 Motion Control, Kuaishou. Ролик от 35 хайпов"}},"prompt":{"type":"string","description":"Промпт по желанию, до 2000 символов.","maxLength":2000},"params":{"type":"object","description":"Настройки ролика. Нет resolution: defaultResolution модели (GET /models).","properties":{"resolution":{"type":"string","description":"Качество: одно из resolutions модели.","enum":["720p","1080p"]}}},"photos":{"type":"array","description":"Одно фото человека.","items":{"$ref":"#/components/schemas/PhotoSource"},"minItems":1,"maxItems":1},"videos":{"type":"array","description":"Одно видео с движением: длина ролика по нему. Пределы: video модели.","items":{"$ref":"#/components/schemas/ClipSource"},"minItems":1,"maxItems":1},"maxPrice":{"type":"integer","description":"Не дороже, хайпов: цена из POST /generations/price. Если цена выше, ответ 409 price_changed и хайпы не списываются.","minimum":0},"callbackUrl":{"type":"string","description":"Адрес уведомления о готовности: https, публичный. После done или failed сервер пришлёт сюда POST с генерацией.","format":"uri"}},"required":["mode","modelId","photos","videos"]},"UpscaleGenerationRequest":{"type":"object","description":"«Улучшить качество». Промпта нет.","properties":{"kind":{"type":"string","description":"Вид генерации.","enum":["image"]},"mode":{"type":"string","description":"«Улучшить качество»: картинка станет больше и резче.","enum":["upscale"]},"modelId":{"type":"string","description":"Модель: id из GET /models?type=upscale.","enum":["recraft-crisp-upscale"],"x-enumDescriptions":{"recraft-crisp-upscale":"Recraft Crisp Upscale, Recraft. Цена от 3 хайпов"}},"factor":{"type":"integer","description":"Не нужен: во сколько раз увеличить, выбирает модель."},"photos":{"type":"array","description":"Одно фото.","items":{"$ref":"#/components/schemas/PhotoSource"},"minItems":1,"maxItems":1},"count":{"type":"integer","description":"Улучшить можно одно фото за раз.","enum":[1]},"maxPrice":{"type":"integer","description":"Не дороже, хайпов: цена из POST /generations/price. Если цена выше, ответ 409 price_changed и хайпы не списываются.","minimum":0},"callbackUrl":{"type":"string","description":"Адрес уведомления о готовности: https, публичный. После done или failed сервер пришлёт сюда POST с генерацией.","format":"uri"}},"required":["kind","mode","modelId","photos"]},"GenerationRequest":{"description":"Тело генерации: как у формы сайта.","oneOf":[{"$ref":"#/components/schemas/VideoGenerationRequest"},{"$ref":"#/components/schemas/MotionGenerationRequest"},{"$ref":"#/components/schemas/ImageGenerationRequest"},{"$ref":"#/components/schemas/UpscaleGenerationRequest"},{"$ref":"#/components/schemas/TrendGenerationRequest"}]}}},"x-changelog":[{"date":"2026-11-17","changes":["Улучшить качество: модель topaz-upscale убрана, запрос с ней получает 422 с id доступных моделей. Осталась recraft-crisp-upscale: 3 хайпа за картинку, было 1; во сколько раз увеличить, решает модель, поле factor не нужно."]},{"date":"2026-11-16","changes":["Картинки: новая модель gpt-image-2-6 (GPT Image 2.6) - «Текст → картинка» и «По фото» до 16 фото, 10 форматов, 1K, 2K и 4K. Каждое фото на входе стоит дополнительно, начиная с первого: цену с вашими фото называет POST /generations/price."]},{"date":"2026-11-13","changes":["Тренды: качество по умолчанию - 480p, было 720p. Запрос без params.resolution делает ролик в 480p; для 720p или 1080p передайте params.resolution.","Тренды по ролику: несколько фото - один прогон нейросети, а не проход на каждое фото. Цена с несколькими фото такая же, как с одним, или чуть ниже; prices - цена с одним фото, цену за ваши фото называет POST /generations/price.","«Ваши фото» на сайте теперь называются «Мои фотографии»: там до 30 фото, свои и друзей. GET /me/photos и list_my_photos работают как раньше."]},{"date":"2026-11-12","changes":["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."]},{"date":"2026-11-10","changes":["Первая версия 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, тот же ключ."]}]}