Source: https://ailoot.ai/models/ru/cogvideox-2/ Canonical: https://ailoot.ai/models/ru/cogvideox-2/ Language: ru # Zhipu AI: CogVideoX 2 [Markdown](https://ailoot.ai/models/ru/cogvideox-2/index.md) · [JSON](https://ailoot.ai/models/ru/cogvideox-2/facts.json) ## [Zhipu AI: CogVideoX 2](https://ailoot.ai/models/ru/cogvideox-2/) CogVideoX 2 генерирует видео по текстовому описанию или предоставленному изображению. Производитель документирует выбор размеров кадра, 30 или 60 кадров в секунду, режимы качества или скорости и необязательные сгенерированные звуковые эффекты для короткой визуальной сцены. - [**Ailoot Ultra · Видео** `POST /v1/videos` `cogvideox-2`](https://ailoot.ai/models/ru/cogvideox-2/#method-0) О модели Описание раскрывает возможности модели. Доступные в Ailoot входные данные, результаты и параметры выбранного метода перечислены ниже. CogVideoX 2 — модель генерации видео от Zhipu AI по письменному описанию сцены или предоставленному изображению. Текст задаёт объект, окружение и действие; изображение может служить визуальной основой создаваемой последовательности. Выберите вход, лучше всего представляющий уже имеющийся материал для кадра, затем опишите видимое движение, которое должно быть в готовом видео. Для создания по тексту определите одно связное событие. Человек открывает дверь мастерской, небольшая лодка проходит мимо причала или предмет поворачивается при постоянном освещении — каждое действие даёт кадру понятную цель. Укажите важные признаки объекта, точку наблюдения и направление движения. Выберите окончание, пригодное для предполагаемого монтажа, не оставляя итоговую композицию сцены неопределённой. Для создания по изображению подготовьте ясный вид объекта и опишите движение сцены от этого исходного состояния. Производитель принимает референсы PNG, JPEG и JPG до 5 MB, предоставляемые URL изображения или закодированными данными изображения. Сохраняйте важные края, черты лица и детали объекта видимыми на референсе и оставляйте в композиции пространство для запрошенного действия. Производитель ограничивает письменную инструкцию 512 символами. Используйте этот объём для решающих деталей: объекта, действия, окружения и точки наблюдения. Краткое описание того, какой предмет движется, а что остаётся неподвижным, проще оценить, чем перечень общих стилевых прилагательных. Если результат не достигает цели, измените инструкцию, связанную с замеченной проблемой движения или кадрирования. Опубликованные размеры вывода включают квадратные, горизонтальные и вертикальные форматы с вариантами от 720×480 до 3840×2160 пикселей. Производитель также документирует 30 или 60 кадров в секунду. Выбирайте форму и частоту кадров под место использования до генерации, затем проверяйте на самом клипе, остаются ли объект и важные детали читаемыми в таком кадрировании. Качество и скорость — именованные режимы вывода в процессе производителя. Необязательные звуковые эффекты, сгенерированные ИИ, управляются отдельно от визуального задания. Сохраняйте выбранный режим и настройку звуковых эффектов вместе с инструкцией и референсом, если он использовался, чтобы сравнивать варианты клипов по фактическим настройкам генерации. Генерация асинхронна: идентификатор задачи возвращается до доступности готового видео. Сохраняйте его при проверке результата и сохраняйте все завершённые видеофайлы, связанные с операцией. Для редактирования сохраняйте сам клип вместе с исходным изображением, если оно использовалось, не полагаясь на временное расположение результата или кадр предпросмотра. Проверяйте всю последовательность на непрерывность, темп и запрошенное действие. Товарному кадру нужны стабильные форма и детали материала в движении; кадру с персонажем — согласованные внешность и жесты. Проверяйте итоговую композицию и сгенерированный звук по назначению кадра. Сохраняйте удачные элементы сцены при исправлении конкретного несоответствия и сравнивайте исходное и изменённое видео в одинаковых условиях просмотра. **Ailoot Ultra · Видео** `POST /v1/videos` `cogvideox-2` [`cogvideox-2`](https://ailoot.ai/models/ru/#m=cogvideox-2&route=Ultra&caller=cogvideox-2&fmt=videos) Zhipu AI /`cogvideox-2` ### Начало CogVideoX 2 генерирует видео по текстовому описанию или предоставленному изображению. Производитель документирует выбор размеров кадра, 30 или 60 кадров в секунду, режимы качества или скорости и необязательные сгенерированные звуковые эффекты для короткой визуальной сцены. Допустимые входные данные Текст Результаты Видео ### Доступно в Ailoot · входные данные и методы **Ailoot Ultra · Видео** `POST /v1/videos` Входные данные `text` Результат `video` | Поле | Тип | Требование | Значения и ограничения | По умолчанию | | --- | --- | --- | --- | --- | | Поле`model` | Тип`string` | ТребованиеОбязательно | Значения и ограничения cogvideox-2 Условия: Используйте точный идентификатор модели Ailoot. | По умолчанию— | | Поле`prompt` | Тип`string` | ТребованиеОбязательно | Значения и ограничения Условия: Опишите сцену и движение. | По умолчанию— | | Поле`quality` | Тип`boolean` | ТребованиеНеобязательно | Значения и ограничения Условия: Необязательный параметр качества; эта выбранная схема не задаёт совместимое перечисление допустимых значений или значение по умолчанию. | По умолчанию— | | Поле`with_audio` | Тип`boolean` | ТребованиеНеобязательно | Значения и ограничения Условия: При включении генерирует звуковые эффекты с помощью AI. | По умолчаниюfalse | | Поле`size` | Тип`string` | ТребованиеНеобязательно | Значения и ограничения Условия: При выборе явных размеров передайте документированную строку size. | По умолчанию— | | Поле`fps` | Тип`string` | ТребованиеНеобязательно | Значения и ограничения 30, 60 Условия: В этом выбранном нативном методе частота кадров передаётся строкой. | По умолчанию30 | | Поле`duration` | Тип`string` | ТребованиеНеобязательно | Значения и ограничения 5, 10 Условия: В этом выбранном нативном методе длительность в секундах передаётся строкой. | По умолчанию5 | Параметры и жизненный цикл метода | Параметр | Контракт | | --- | --- | | Параметр`content_type` | Контрактapplication/json | | Параметр`required` | Контрактmodel, prompt | | Параметр`optional` | Контрактquality, with\_audio, size, fps, duration | | Параметр`material_types` | Контрактtext | | Параметр`conditions` | КонтрактИспользуйте точный идентификатор модели Ailoot., Опишите сцену и движение., Необязательный параметр качества; эта выбранная схема не задаёт совместимое перечисление допустимых значений или значение по умолчанию., При включении генерирует звуковые эффекты с помощью AI., При выборе явных размеров передайте документированную строку size., В этом выбранном нативном методе частота кадров передаётся строкой., В этом выбранном нативном методе длительность в секундах передаётся строкой. | Псевдонимы метода: `/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 токенов | | КонфигурацияЗа запрос | Шкала ставок— | Прогноз количества— | Расчётное количествоОдин запрос | Плата Вход · Оценка только для сравнения **$0.2** за запрос | | КонфигурацияОриентировочная стоимость генерации | Шкала ставок— | Прогноз количестваОценка для одной генерации | Расчётное количество— | Плата Выход · Оценочная стоимость генерации · Оценка только для сравнения **$0.2** оценка до генерации Эта оценка не является дополнительным списанием или фиксированным тарифом для завершённой генерации. | Ailoot резервирует расчётную сумму перед запросом. После получения результата списывает итоговую плату по измеренному расходу. Для окончательного списания за потоковый ответ используется итоговая запись расхода. [Как работают резервирование и расчёт →](https://ailoot.ai/docs/ru/billing/reserve/) ### Примеры запросов #### Ailoot Ultra · Видео curl · создать один раз и сохранить подтверждениеПрочитать исходную задачуСохранить каждый готовый материал, принадлежащий вам ```bash set -eu : "${AILOOT_API_KEY:?Set your Ailoot API key}" cat > request.json <<'JSON' { "model": "cogvideox-2", "prompt": "A cat is walking on grass." } JSON 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 # Create once; retain id, polling_url, original task identifiers and every 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 · Видео - `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 | | Поле`id` | Типstring | | Поле`task_status` | Типstring | | Поле`video_result[].url` | Типstring | ### Псевдонимы #### Псевдонимы моделей **Ailoot Ultra** [`cogvideox-2`](https://ailoot.ai/models/ru/#m=cogvideox-2&route=Ultra&caller=cogvideox-2&fmt=videos) #### Псевдонимы путей метода `/v1/videos/generations` #### Связанные ID для вызова [`cogvideox-2`](https://ailoot.ai/models/ru/#m=cogvideox-2&route=Ultra&caller=cogvideox-2&fmt=videos) FAQ · Zhipu AI: CogVideoX 2 Какие входные данные и результаты доступны? `POST /v1/videos` · `cogvideox-2`: `text` → `video` Какие поля использует запрос? `POST /v1/videos` · `cogvideox-2`: `model`, `prompt`, `quality`, `with_audio`, `size`, `fps`, `duration` Подключите 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-доступа к нейросетям в продуктах клиентов, агентах, приложениях и автоматизациях.