models

viduq3-pro

Markdown · JSON

viduq3-pro

Vidu Q3 Pro создаёт видео по промпту и обязательному aspect_ratio. В Ailoot доступны настройки длительности, разрешения, стиля, движения и звука для кадра.

О модели

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

Выберите viduq3-pro с полями model, prompt и aspect_ratio в /v1/videos. В запросе доступны длительность от одной до шестнадцати секунд и разрешение 540p, 720p или 1080p; значения по умолчанию — пять секунд и 720p. Также доступны поля Style, movement_amplitude, bgm и audio.

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

Отправьте кадр один раз через /v1/videos и сохраните полученный ID запроса. Опрашивайте ту же операцию через /v1/videos/{request_id}, затем сохраните каждое готовое видео и полный ответ. Проверьте всё действие и конечную композицию по переданным материалам и заданию.

Ailoot Ultra · Video POST /v1/videos viduq3-pro

viduq3-pro

Прочее /viduq3-pro

Начало

Vidu Q3 Pro создаёт видео по промпту и обязательному aspect_ratio. В Ailoot доступны настройки длительности, разрешения, стиля, движения и звука для кадра.

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

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

Ailoot Ultra · Video POST /v1/videos
Входные данные
text, image
Результат
video
ПолеТипТребованиеЗначения и ограниченияПо умолчанию
ПолеmodelТипstringТребованиеОбязательноЗначения и ограничения
viduq3-pro
Условия: Используйте этот селектор маршрутизации Ailoot в точности.
По умолчанию—
ПолеpromptТипstringТребованиеОбязательноЗначения и ограничения
Условия: Используйте документированное поле выбранной модели и перечисленные варианты; не передавайте необязательное значение, если оно не задано.
По умолчанию—
ПолеstyleТипstringТребованиеНеобязательноЗначения и ограничения
Условия: Используйте документированное поле выбранной модели и перечисленные варианты; не передавайте необязательное значение, если оно не задано.
По умолчанию—
Полеaspect_ratioТипstringТребованиеОбязательноЗначения и ограничения
Условия: Используйте документированное поле выбранной модели и перечисленные варианты; не передавайте необязательное значение, если оно не задано.
По умолчанию—
ПолеdurationТипintegerТребованиеНеобязательноЗначения и ограничения
1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16
Условия: Используйте документированное поле выбранной модели и перечисленные варианты; не передавайте необязательное значение, если оно не задано.
По умолчанию5
ПолеresolutionТипstringТребованиеНеобязательноЗначения и ограничения
540p, 720p, 1080p
Условия: Используйте документированное поле выбранной модели и перечисленные варианты; не передавайте необязательное значение, если оно не задано.
По умолчанию720p
Полеmovement_amplitudeТипstringТребованиеНеобязательноЗначения и ограничения
Условия: Используйте документированное поле выбранной модели и перечисленные варианты; не передавайте необязательное значение, если оно не задано.
По умолчанию—
ПолеbgmТипbooleanТребованиеНеобязательноЗначения и ограничения
Условия: Используйте документированное поле выбранной модели и перечисленные варианты; не передавайте необязательное значение, если оно не задано.
По умолчанию—
ПолеaudioТипbooleanТребованиеНеобязательноЗначения и ограничения
Условия: Используйте документированное поле выбранной модели и перечисленные варианты; не передавайте необязательное значение, если оно не задано.
По умолчанию—
Параметры и жизненный цикл метода
ПараметрКонтракт
Параметрcontent_typeКонтрактapplication/json
ПараметрrequiredКонтрактmodel, prompt, aspect_ratio
ПараметрoptionalКонтрактstyle, duration, resolution, movement_amplitude, bgm, audio
Параметрmaterial_typesКонтрактtext, image
Параметр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 токенов
КонфигурацияОриентировочная стоимость генерацииШкала ставок—Прогноз количестваОценка для одной генерацииПлата
Выход · Оценочная стоимость генерации · Оценка только для сравнения $0.14 оценка до генерации

Эта оценка не является дополнительным списанием или фиксированным тарифом для завершённой генерации.

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

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

Ailoot Ultra · Video

curl · создать один раз и сохранить полный результатПрочитать исходную задачуСохранить каждый готовый материал, принадлежащий вам
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
: "${AILOOT_ASPECT_RATIO:?Set an actual customer material or documented value}"
export AILOOT_ASPECT_RATIO
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads('{"model": "viduq3-pro", "prompt": "A cat is walking on grass.", "aspect_ratio": "YOUR_DOCUMENTED_ASPECT_RATIO"}')
p['aspect_ratio']=os.environ['AILOOT_ASPECT_RATIO']
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.
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 · 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
Полеtask_idТипstring
ПолеstatusТипstring
Полеvideo_urlТипstring
Ошибки и дальнейшие шаги
ОтветУсловиеСледующий шаг
Ответ400 · invalid_request_errorУсловиеОбязательное поле, селектор модели, тип или представление входных данных недопустимы.Следующий шагИзучите возвращённые сведения о проверке данных перед подготовкой отдельного запроса.
ОтветУсловиеИсходный запрос или результат неизвестен либо требует проверки.Следующий шагСохраните исходные идентификаторы и заголовки; читайте только поддерживаемые записи статуса или библиотеки. Не отправляйте запрос на создание повторно.

Псевдонимы

Псевдонимы моделей

Ailoot Ultra viduq3-pro

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

/v1/videos/generations

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

viduq3-pro

FAQ · viduq3-pro
Какие входные данные и результаты доступны?

POST /v1/videos · viduq3-pro: text, image → video

Какие поля использует запрос?

POST /v1/videos · viduq3-pro: model, prompt, style, aspect_ratio, duration, resolution, movement_amplitude, bgm, audio

Подробнее

Подключите Ailoot к Claude Code, OpenCode, Hermes или своему приложению.

Компания и портфель её проектов

Компания и портфель её проектов: миллионы клиентов; продажи на миллиарды ежемесячно.

Покупайте токены со скидкой.

Скидка по подписке для регулярной работы. Промокоды — до 50% на покупку токенов.

Подписка
Выберите тариф со скидкой для своих регулярных запросов.
Промокод до 50%
Введите код при покупке. Цена пересчитается с учётом действующей акции.
Расходы в истории
Модель, токены и сумма сохраняются для каждого запроса.

Выбрать подписку · Посмотреть цены моделей

Подключайте API к продукту, который вы продаёте.

SaaS, приложения и боты — по оферте и лицензионному договору Ailoot. Для перепродажи запросите реселлерскую лицензию.

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

Запросить реселлерскую лицензию · Оферта и лицензионный договор