Zhipu AI: CogVideoX 3

CogVideoX 3 создаёт видео по тексту, изображению или паре первого и последнего кадров в документированном процессе производителя. Модель поддерживает последовательности длительностью пять или десять секунд, несколько размеров вывода до 4K, 30 или 60 кадров в секунду и необязательные сгенерированные звуковые эффекты.

Ailoot Ultra · Видео POST /v1/videos cogvideox-3

О модели

Описание раскрывает возможности модели. Доступные в Ailoot входные данные, результаты и параметры выбранного метода перечислены ниже.

CogVideoX 3 — видеомодель Zhipu AI с документированной генерацией по тексту, изображению и первому и последнему кадрам. Производитель выделяет стабильность кадров, следование инструкциям и реалистичный или трёхмерный визуальный стиль. Выбирайте текст, когда сцена начинается с письменного задания; одно изображение, когда визуальная основа уже есть; два изображения крайних кадров, когда последовательности нужны заданные начальный и конечный виды.

В текстовом задании опишите объект и одно понятное действие. Укажите окружение, точку наблюдения и важные физические связи, чтобы оценить сцену по ясному замыслу. Персонаж, поднимающий предмет, требует иной последовательности, чем камера, открывающая его вид. Описывайте оба действия лишь тогда, когда их связь важна для кадра.

Для последовательности по изображению подготовьте референс так, чтобы были видны отличительные признаки объекта. Производитель принимает изображения PNG, JPEG и JPG размером не более 5 MB, предоставляемые через URL или закодированными данными изображения. Сохраняйте фактический референс с результатом генерации, чтобы сравнивать внешность и кадрирование с источником, а не с его запомненной версией.

Режим крайних кадров производителя принимает два изображения по порядку: первое задаёт начальный кадр, второе — конечный. Подготовьте их как два нужных состояния одного кадра. Опишите связывающий их переход или действие, затем проверьте согласованность объекта между крайними состояниями. Пара хороших неподвижных изображений сама по себе не показывает соответствие промежуточного движения желаемой истории.

Инструкция может содержать до 512 символов. Используйте доступный текст для действия, его направления и визуальных деталей, отличающих удачный результат. Сосредоточьте задание на происходящем на экране. Если входные изображения уже задают внешность объекта, опишите движение и временное развитие между ними или от них.

Производитель документирует вывод длительностью пять или десять секунд, с пятью секундами по умолчанию, и 30 или 60 кадров в секунду. Поддерживаемые размеры: 1280×720, 720×1280, 1024×1024, 1920×1080, 1080×1920, 2048×1080 и 3840×2160. Выберите размер и длительность под место использования, затем проверьте готовый клип на кадрирование и темп фактического действия.

Режимы качества и скорости документированы отдельно от необязательной настройки звуковых эффектов ИИ. Сохраняйте эти варианты вместе с инструкцией, изображениями и результатом. Визуальные и входные возможности производителя описывают модель; доступные параметры конкретного метода генерации определяются спецификацией этого метода. При сравнении вариантов кадров сохраняйте фактически использованные настройки.

Сохраняйте исходный идентификатор задачи до завершения видео и сохраняйте полученный видеоматериал для монтажа. Проверяйте всю последовательность, включая внешность объекта при значительном движении, взаимодействия с объектами сцены и итоговую композицию. Для работы с крайними кадрами проверяйте оба крайних кадра и переход между ними. Исправляйте конкретное визуальное несоответствие, сохраняя удачные референсы и план кадра, и сравнивайте готовые видео, а не только предпросмотры.

Ailoot Ultra · Видео POST /v1/videos cogvideox-3

cogvideox-3

Zhipu AI /cogvideox-3

Начало

Допустимые входные данные: Текст
Результаты: Видео

Доступно в Ailoot · входные данные и методы

Ailoot Ultra · Видео POST /v1/videos

Входные данные: text
Результат: video

Поле	Тип	Требование	Значения и ограничения	По умолчанию
Поле`model`	Тип`string`	ТребованиеОбязательно	Значения и ограничения cogvideox-3 Условия: Используйте точный идентификатор модели 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.3 за запрос
КонфигурацияОриентировочная стоимость генерации	Шкала ставок—	Прогноз количестваОценка для одной генерации	Расчётное количество—	Плата Выход · Оценочная стоимость генерации · Оценка только для сравнения $0.3 оценка до генерации Эта оценка не является дополнительным списанием или фиксированным тарифом для завершённой генерации.

Ailoot резервирует расчётную сумму перед запросом. После получения результата списывает итоговую плату по измеренному расходу. Для окончательного списания за потоковый ответ используется итоговая запись расхода. Как работают резервирование и расчёт →

Примеры запросов

Ailoot Ultra · Видео

curl · создать один раз и сохранить подтверждениеПрочитать исходную задачуСохранить каждый готовый материал, принадлежащий вам

set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
cat > request.json <<'JSON'
{
  "model": "cogvideox-3",
  "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.

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

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-3

Псевдонимы путей метода

/v1/videos/generations

Связанные ID для вызова

cogvideox-3

FAQ · Zhipu AI: CogVideoX 3

Какие входные данные и результаты доступны?: POST /v1/videos · cogvideox-3: text → video
Какие поля использует запрос?: POST /v1/videos · cogvideox-3: model, prompt, quality, with_audio, size, fps, duration

Zhipu AI: CogVideoX 3