Source: https://ailoot.ai/models/ru/kling-v2-1-master/ Canonical: https://ailoot.ai/models/ru/kling-v2-1-master/ Language: ru # Kling v2.1 Master [Markdown](https://ailoot.ai/models/ru/kling-v2-1-master/index.md) · [JSON](https://ailoot.ai/models/ru/kling-v2-1-master/facts.json) ## [Kling v2.1 Master](https://ailoot.ai/models/ru/kling-v2-1-master/) Kling v2.1 Master создаёт видео по тексту или заданию на основе изображения. Используйте модель для конкретного визуального события: спланируйте главный объект, действие, работу камеры и финал как единый связный короткий план. - [**Ailoot Ultra · Video** `POST /v1/videos` `kling-v2-1-master`](https://ailoot.ai/models/ru/kling-v2-1-master/#method-0) О модели Описание раскрывает возможности модели. Доступные в Ailoot входные данные, результаты и параметры выбранного метода перечислены ниже. Kling v2.1 Master — версия видеомодели Kling, для которой в документированном каталоге указаны создание видео из текста и создание видео из изображения. Выберите текстовое описание сцены, если разрабатываете визуальную идею из текста, или задание на основе изображения, если главный объект и композиция уже определены. В обоих случаях задайте событие, которое должен показать готовый план. При создании по тексту описывайте главный объект, обстановку и действие в понятном порядке. Танцор, пересекающий студию, автомобиль, едущий под деревьями, или стеклянный предмет, на котором меняются блики, дают последовательности конкретную задачу. Включите детали, определяющие внешний вид сцены, и сохраняйте их согласованность во всём задании. При создании на основе изображения подготовьте референс, показывающий особенности, которые нужно сохранить в кадре. Лица, контуры предметов и характерные материалы должны быть видны. Опишите, что меняется относительно исходного вида: жест персонажа, движение окружения или положение камеры. Держите исходное изображение под рукой при просмотре результата. Планируйте действие с учётом его завершения. Если человек ставит предмет, в конце этот предмет должен оказаться в определённом, различимом месте; если кадр раскрывает деталь, она должна быть видна в финале. Это облегчает выбор точки склейки и оценку того, выполнило ли движение свою задачу. В документированном описании модели указаны длительности 5 и 10 секунд, режимы std и pro, а также горизонтальный, вертикальный и квадратный форматы кадра. Выбирайте параметры, доступные в выбранном сценарии работы, и сохраняйте их фактические значения. Оценивайте получившийся клип по задуманному действию и композиции кадра, а не по названию версии модели. Описывайте движение главного объекта и камеры отдельно. Для следящего плана укажите, за каким объектом движется камера и какие части окружения должны проходить через кадр. Для неподвижного плана укажите движение, происходящее внутри него. Связывайте работу камеры с тем, что должен заметить зритель. Проверьте непрерывность всей последовательности. Убедитесь, что важный объект остаётся узнаваемым, взаимодействия пространственно согласованы, а темп оставляет место для задуманной склейки. Следите за изменениями рук, лиц, деталей поверхностей и перекрывающихся объектов. Оценивайте движение наряду с самым удачным отдельным кадром. Храните каждое готовое видео вместе с промптом, референсом и параметрами. При сравнении сцены между версиями используйте одно и то же задание и фиксируйте реальные визуальные различия. Исправляя вариант, опишите наблюдаемую проблему и измените связанную с ней инструкцию, сохранив полезные элементы сцены. **Ailoot Ultra · Video** `POST /v1/videos` `kling-v2-1-master` [`kling-v2-1-master`](https://ailoot.ai/models/ru/#m=kling-v2-1-master&route=Ultra&caller=kling-v2-1-master&fmt=videos) Kling /`kling-v2-1-master` ### Начало Kling v2.1 Master создаёт видео по тексту или заданию на основе изображения. Используйте модель для конкретного визуального события: спланируйте главный объект, действие, работу камеры и финал как единый связный короткий план. Допустимые входные данные Текст Результаты Видео ### Доступно в Ailoot · входные данные и методы **Ailoot Ultra · Video** `POST /v1/videos` Входные данные `text` Результат `video` | Поле | Тип | Требование | Значения и ограничения | По умолчанию | | --- | --- | --- | --- | --- | | Поле`model` | Тип`string` | ТребованиеОбязательно | Значения и ограничения kling-v2-1-master Условия: Используйте этот селектор маршрутизации Ailoot в точности. | По умолчанию— | | Поле`prompt` | Тип`string` | ТребованиеОбязательно | Значения и ограничения Максимальная длина: 500 Условия: | По умолчанию— | | Поле`mode` | Тип`string` | ТребованиеОбязательно | Значения и ограничения std, pro Условия: | По умолчанию— | | Поле`model_name` | Тип`string` | ТребованиеНеобязательно | Значения и ограничения Условия: Необязательное переопределение нативного параметра. Не передавайте его, чтобы автоматически использовать выбранную модель; явно заданное значение сохраняется. | По умолчанию— | | Поле`cfg_scale` | Тип`number` | ТребованиеНеобязательно | Значения и ограничения Минимум: 0 Максимум: 1 Условия: | По умолчанию— | | Поле`aspect_ratio` | Тип`string` | ТребованиеНеобязательно | Значения и ограничения Условия: | По умолчанию— | | Поле`negative_prompt` | Тип`string` | ТребованиеНеобязательно | Значения и ограничения Максимальная длина: 200 Условия: | По умолчанию— | | Поле`duration` | Тип`integer` | ТребованиеНеобязательно | Значения и ограничения 5, 10 Условия: | По умолчанию— | Параметры и жизненный цикл метода | Параметр | Контракт | | --- | --- | | Параметр`content_type` | Контрактapplication/json | | Параметр`required` | Контрактmodel, prompt, mode | | Параметр`optional` | Контрактmodel\_name, cfg\_scale, aspect\_ratio, negative\_prompt, duration | | Параметр`material_types` | Контрактtext | | Параметр`conditions` | КонтрактИспользуйте этот селектор маршрутизации Ailoot в точности., Необязательное переопределение нативного параметра. Не передавайте его, чтобы автоматически использовать выбранную модель; явно заданное значение сохраняется. | Псевдонимы метода: `/v1/videos/generations` Жизненный цикл: `submit_once_poll_original` `GET /v1/videos/{request_id}` `GET /v1/videos/generations/{request_id}` `GET /v1/videos/{request_id}/content` `GET /v1/media/assets` `GET /v1/media/assets/{asset_id}` ### Тарифы ##### Как рассчитывается итоговая плата Отображаемые тарифы позволяют оценить стоимость до генерации. Итоговое списание рассчитывается по стоимости, записанной для исходной генерации. Измеренная длительность результата и прогнозные объёмы не являются итоговым оплачиваемым объёмом. Тарифная справка не добавляет режимы запроса. Поддерживаемые параметры указаны для выбранного метода. Быстрый режим Не указано При выборе быстрого режима Режим flex Не указано При выборе режима flex Максимальная интенсивность рассуждений Не указано При максимальной интенсивности рассуждений с корректировкой по умолчанию (default) #### Оценочные ставки для сравнения #### Цены по конфигурациям Сопоставьте каждую плату с указанными условиями. Для каждого набора альтернативных конфигураций используйте одну ставку. | Конфигурация | Шкала ставок | Прогноз количества | Плата | | --- | --- | --- | --- | | КонфигурацияБазовые тарифы на токены | Шкала ставокБазовая ставка | Прогноз количества— | Плата Вход · Входные токены · Оценка только для сравнения **—** / 1K токенов Выход · Выходные токены · Оценка только для сравнения **—** / 1K токенов Вход · Чтение кэша · Оценка только для сравнения **—** / 1K токенов Вход · Запись в кэш · Оценка только для сравнения **—** / 1K токенов Вход · Запись в кэш, 1 час · Оценка только для сравнения **—** / 1K токенов | | КонфигурацияОриентировочная стоимость генерации | Шкала ставок— | Прогноз количестваОценка для одной генерации | Плата Выход · Оценочная стоимость генерации · Оценка только для сравнения **$6** оценка до генерации Эта оценка не является дополнительным списанием или фиксированным тарифом для завершённой генерации. | Ailoot резервирует расчётную сумму перед запросом. После получения результата списывает итоговую плату по измеренному расходу. Для окончательного списания за потоковый ответ используется итоговая запись расхода. [Как работают резервирование и расчёт →](https://ailoot.ai/docs/ru/billing/reserve/) ### Примеры запросов #### Ailoot Ultra · Video curl · создать один раз и сохранить полный результатПрочитать исходную задачуСохранить каждый готовый материал, принадлежащий вам ```bash set -eu : "${AILOOT_API_KEY:?Set your Ailoot API key}" export AILOOT_API_KEY python3 - <<'PY_REQUEST' import json,os from pathlib import Path p=json.loads('{"model": "kling-v2-1-master", "prompt": "A happy holiday scene at the beach.", "mode": "pro"}') Path("request.json").write_text(json.dumps(p,ensure_ascii=False)) PY_REQUEST curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/videos \ -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \ --data-binary @request.json -D response-headers.txt -o result.json # Submit once. Retain the complete result, original identifiers and every response header. ``` ```bash set -eu : "${AILOOT_API_KEY:?Set your Ailoot API key}" export AILOOT_API_KEY python3 - <<'PY_STATUS' import json,os,subprocess from pathlib import Path from urllib.parse import urljoin,urlsplit r=json.loads(Path("result.json").read_text()) u=urljoin("https://api.ailoot.ai",r["polling_url"]) p=urlsplit(u) if p.scheme!="https" or p.netloc!="api.ailoot.ai" or p.username or p.password: raise SystemExit("Unexpected returned polling URL; preserve the response") subprocess.run(["curl","--fail-with-body","--silent","--show-error",u,"-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"],"-D","status-headers.txt","-o","status.json"],check=True) # Read this same original polling_url again while pending. # Preserve unknown/result_pending_check; do not repeat creation. PY_STATUS ``` ```bash set -eu : "${AILOOT_API_KEY:?Set your Ailoot API key}" export AILOOT_API_KEY python3 - <<'PY_ASSETS' import json,os,subprocess from pathlib import Path from urllib.parse import urljoin,urlsplit r=json.loads(Path("status.json").read_text()) roles={} def visit(v,path=""): if isinstance(v,dict): for k,x in v.items(): visit(x,path+"/"+k) elif isinstance(v,list): for i,x in enumerate(v): visit(x,path+"/"+str(i)) elif isinstance(v,str): u=urljoin("https://api.ailoot.ai",v); p=urlsplit(u) if p.scheme=="https" and p.netloc=="api.ailoot.ai" and not p.username and not p.password and p.path.startswith("/v1/media/assets/") and p.path.endswith("/content"): roles.setdefault(u,[]).append(path) visit(r) if not roles: raise SystemExit("No completed owned assets; retain the original status") manifest=[] for i,(u,paths) in enumerate(roles.items()): target=Path(f"asset-{i}.bin") subprocess.run(["curl","--fail-with-body","--silent","--show-error",u,"-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"],"-o",str(target)],check=True) raw=target.read_bytes() if not raw: raise SystemExit("Empty asset; retain original status and metadata") ext="glb" if raw[:4]==b"glTF" else "png" if raw[:8]==b"\x89PNG\r\n\x1a\n" else "jpg" if raw[:3]==b"\xff\xd8\xff" else "webp" if raw[:4]==b"RIFF" and raw[8:12]==b"WEBP" else "mp4" if raw[4:8]==b"ftyp" else "bin" name=f"asset-{i}.{ext}" if target.name!=name: target.rename(name) manifest.append({"file":name,"response_paths":paths,"bytes":len(raw)}) Path("asset-manifest.json").write_text(json.dumps(manifest,indent=2)) print("Saved",len(manifest),"unique owned assets; every response role retained") PY_ASSETS ``` ### Получить и сохранить результаты #### Ailoot Ultra · Video - `GET /v1/videos/{request_id}` - `GET /v1/videos/generations/{request_id}` - `GET /v1/videos/{request_id}/content` - `GET /v1/media/assets` - `GET /v1/media/assets/{asset_id}` ##### Сохраняйте все готовые результаты Сохраните каждое готовое видео или полученный файл; загрузите содержимое по каждому фактически полученному URL материала. Сохраните полный ответ и заголовки, исходные идентификаторы, каждый фактический результат и все поля использования и учёта. Сохраните каждый уникальный ресурс, принадлежащий Ailoot, и каждую роль, которая на него ссылается. ##### Если нужно проверить исходный ответ Сохраните возвращённый публичный id задачи или операции и все заголовки. Проверяйте только исходную задачу; unknown или result\_pending\_check не разрешают создавать новую. Поля ответа | Поле | Тип | | --- | --- | | Поле`id` | Типstring | | Поле`polling_url` | Типstring | | Поле`provider_task_id` | Типstring | | Поле`data.task_id` | Типstring | | Поле`data.task_status` | Типstring | | Поле`data.task_result.videos[].url` | Типstring | Ошибки и дальнейшие шаги | Ответ | Условие | Следующий шаг | | --- | --- | --- | | Ответ400 · `invalid_request_error` | УсловиеОбязательное поле, селектор модели, тип или представление входных данных недопустимы. | Следующий шагИзучите возвращённые сведения о проверке данных перед подготовкой отдельного запроса. | | Ответ`` | УсловиеИсходный запрос или результат неизвестен либо требует проверки. | Следующий шагСохраните исходные идентификаторы и заголовки; читайте только поддерживаемые записи статуса или библиотеки. Не отправляйте запрос на создание повторно. | ### Псевдонимы #### Псевдонимы моделей **Ailoot Ultra** [`kling-v2-1-master`](https://ailoot.ai/models/ru/#m=kling-v2-1-master&route=Ultra&caller=kling-v2-1-master&fmt=videos) #### Псевдонимы путей метода `/v1/videos/generations` #### Связанные ID для вызова [`kling-v2-1-master`](https://ailoot.ai/models/ru/#m=kling-v2-1-master&route=Ultra&caller=kling-v2-1-master&fmt=videos) FAQ · Kling v2.1 Master Какие входные данные и результаты доступны? `POST /v1/videos` · `kling-v2-1-master`: `text` → `video` Какие поля использует запрос? `POST /v1/videos` · `kling-v2-1-master`: `model`, `prompt`, `mode`, `model_name`, `cfg_scale`, `aspect_ratio`, `negative_prompt`, `duration` Какие ограничения действуют? `POST /v1/videos` · `kling-v2-1-master`: `prompt.maximum_length`: `500`; `cfg_scale.minimum`: `0`; `cfg_scale.maximum`: `1`; `negative_prompt.maximum_length`: `200` Подключите Ailoot к Claude Code, OpenCode, Hermes или своему приложению. ## Компания и портфель её проектов Компания и портфель её проектов: миллионы клиентов; продажи на миллиарды ежемесячно. ## Покупайте токены со скидкой. Скидка по подписке для регулярной работы. Промокоды — до 50% на покупку токенов. Подписка Выберите тариф со скидкой для своих регулярных запросов. Промокод до 50% Введите код при покупке. Цена пересчитается с учётом действующей акции. Расходы в истории Модель, токены и сумма сохраняются для каждого запроса. [Выбрать подписку](https://ailoot.ai/docs/ru/billing/subscriptions/) · [Посмотреть цены моделей](https://ailoot.ai/models/ru/) ## Подключайте API к продукту, который вы продаёте. SaaS, приложения и боты — по оферте и лицензионному договору Ailoot. Для перепродажи запросите реселлерскую лицензию. Коммерческое приложение Встраивайте генерацию текста, картинок, видео и звука в платные функции своего сервиса. Лицензия для реселлера Пришлите описание проекта и схему доступа. Запросите письменные условия использования и перепродажи. Документы на сайте Оферта, лицензионный договор и политика обработки данных доступны до подключения. [Запросить реселлерскую лицензию](mailto:support@ailoot.ai) · [Оферта и лицензионный договор](https://ailoot.ai/legal/offer?lang=ru) ## Ailoot · Компания и портфель её проектов Ailoot опирается на накопленный опыт работы, большую клиентскую базу, стабильный сервис и постоянный контроль KPI. Компания и портфель её проектов: миллионы клиентов; продажи на миллиарды ежемесячно. Этот опыт Ailoot использует для API-доступа к нейросетям в продуктах клиентов, агентах, приложениях и автоматизациях.