PixVerse v5
PixVerse v5 создаёт короткие видео из текста или изображений. Используйте конкретное задание на действие, при необходимости подготовленный референс и документированные параметры кадрирования и разрешения, чтобы разработать сцену с подходящим финалом.
О модели
Описание раскрывает возможности модели. Доступные в Ailoot входные данные, результаты и параметры выбранного метода перечислены ниже.
PixVerse v5 — видеомодель для создания видео из текста и изображений. Текстовое задание определяет событие, а необязательное референсное изображение задаёт исходный внешний вид и композицию. Используйте каждый сгенерированный план для определённой задачи, например представить главный объект, показать жест или раскрыть визуальную деталь.
Описывайте действие через наблюдаемые признаки. Рука, открывающая коробку, фигура, пересекающая двор, или предмет, перемещающийся в освещённую область, дают последовательности различимое изменение. Укажите, какой объект движется, что его окружает и чем должно закончиться событие. Сохраните детали, делающие сцену узнаваемой.
При создании на основе изображения выберите референс, уже подходящий задуманной композиции. Сохраните видимость отличительных особенностей и оставьте место для нужного движения. Объясните, как сцена развивается из этого изображения. Храните источник вместе с готовым видео, чтобы оценивать непрерывность прямым сравнением.
Документированный каталог моделей содержит несколько форматов кадра и вариантов разрешения, а также длительности 5 и 8 секунд. Выберите сочетание, доступное в сценарии работы, и запишите его фактические значения. Спланируйте действие и финал с учётом выбранной длительности плана и целевого кадра.
Используйте указания для камеры, чтобы направлять внимание. Неподвижный ракурс может подчеркнуть действие главного объекта, а движущийся — раскрыть обстановку или деталь. Объясните связь камеры с главным объектом, чтобы движение работало на сцену. Проверьте финал: остаётся ли в нём видимой нужная информация.
Для серии связанных планов сохраняйте согласованность описаний повторяющихся объектов и обстановки в соответствующих заданиях. Храните каждый референс и выбранную модель вместе с результатом. Соберите готовые клипы в нужном порядке и проверьте изменения внешнего вида, освещения и пространственных отношений на протяжении монтажа.
Проверяйте каждое видео целиком на заданное действие, непрерывность и темп. Следите за руками, лицами, контурами предметов и деталями материалов, если они важны для сцены. Проверьте моменты, когда объекты перекрываются или поворачиваются к другому ракурсу. Пригодный план остаётся понятным и за пределами своего самого удачного статичного кадра.
Сохраните готовое видео вместе с промптом, исходным изображением и параметрами. Если вариант требует доработки, определите конкретное несоответствие и измените связанную с ним инструкцию. Сохраняйте удачные решения по композиции и внешнему виду, чтобы следующий результат можно было сравнить с той же визуальной целью.
Ailoot Ultra · Video POST /v1/videos pixverse-v5
pixverse-v5Начало
PixVerse v5 создаёт короткие видео из текста или изображений. Используйте конкретное задание на действие, при необходимости подготовленный референс и документированные параметры кадрирования и разрешения, чтобы разработать сцену с подходящим финалом.
- Допустимые входные данные
- Текст · Картинки
- Результаты
- Видео
Доступно в Ailoot · входные данные и методы
Ailoot Ultra · Video POST /v1/videos
- Входные данные
text,image- Результат
video
| Поле | Тип | Требование | Значения и ограничения | По умолчанию |
|---|---|---|---|---|
Полеmodel | Типstring | ТребованиеОбязательно | Значения и ограничения pixverse-v5 Условия: Используйте этот селектор маршрутизации Ailoot в точности. | По умолчанию— |
Полеprompt | Типstring | ТребованиеОбязательно | Значения и ограничения Условия: Опишите сцену и движение в ней. | По умолчанию— |
Полеaspect_ratio | Типstring | ТребованиеНеобязательно | Значения и ограничения 16:9, 4:3, 1:1, 3:4, 9:16 Условия: Используйте одно из указанных соотношений сторон для выбранной модели. | По умолчанию— |
Полеquality | Типstring | ТребованиеНеобязательно | Значения и ограничения 360p, 540p, 720p, 1080p Условия: Используйте указанное значение качества для выбранной модели. | По умолчанию— |
Полеmotion_mode | Типstring | ТребованиеНеобязательно | Значения и ограничения normal, fast Условия: Используйте указанный режим движения для выбранной модели. | По умолчанию— |
Полеduration | Типinteger | ТребованиеНеобязательно | Значения и ограничения 5, 8 Условия: Используйте указанную длительность; не подразумевайте значение по умолчанию, если оно не указано. | По умолчанию— |
Полеend_image | Типstring | ТребованиеНеобязательно | Значения и ограничения Условия: Если указан необязательный конечный кадр, выбирается поддерживаемый режим работы с изображениями. | По умолчанию— |
Полеlip_sync_tts_content | Типstring | ТребованиеНеобязательно | Значения и ограничения Условия: Необязательное содержимое речи для выбранной модели. | По умолчанию— |
Полеlip_sync_tts_speaker_id | Типstring | ТребованиеНеобязательно | Значения и ограничения Условия: Используйте реальный идентификатор голоса, поддерживаемый поставщиком; не придумывайте идентификатор голоса. | По умолчанию— |
Полеimage | Типstring or array<string> | ТребованиеНеобязательно | Значения и ограничения Условия: Используйте фактический общедоступный URL вашего изображения или изображение в base64; выбранная модель поддерживает изображения на входе. | По умолчанию— |
Полеnegative_prompt | Типstring | ТребованиеНеобязательно | Значения и ограничения Условия: Опишите содержимое, которого следует избегать. | По умолчанию— |
Параметры и жизненный цикл метода
| Параметр | Контракт |
|---|---|
Параметрcontent_type | Контрактapplication/json |
Параметрrequired | Контрактmodel, prompt |
Параметрoptional | Контрактaspect_ratio, quality, motion_mode, duration, end_image, lip_sync_tts_content, lip_sync_tts_speaker_id, image, negative_prompt |
Параметрmaterial_types | Контрактtext, image |
Параметрconditions | КонтрактИспользуйте этот селектор маршрутизации Ailoot в точности., Опишите сцену и движение в ней., Используйте одно из указанных соотношений сторон для выбранной модели., Используйте указанное значение качества для выбранной модели., Используйте указанный режим движения для выбранной модели., Используйте указанную длительность; не подразумевайте значение по умолчанию, если оно не указано., Если указан необязательный конечный кадр, выбирается поддерживаемый режим работы с изображениями., Необязательное содержимое речи для выбранной модели., Используйте реальный идентификатор голоса, поддерживаемый поставщиком; не придумывайте идентификатор голоса., Используйте фактический общедоступный URL вашего изображения или изображение в base64; выбранная модель поддерживает изображения на входе., Опишите содержимое, которого следует избегать. |
Псевдонимы метода: /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 оценка до генерации Эта оценка не является дополнительным списанием или фиксированным тарифом для завершённой генерации. |
Ailoot резервирует расчётную сумму перед запросом. После получения результата списывает итоговую плату по измеренному расходу. Для окончательного списания за потоковый ответ используется итоговая запись расхода. Как работают резервирование и расчёт →
Примеры запросов
Ailoot Ultra · Video
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
cat > request.json <<'JSON'
{
"model": "pixverse-v5",
"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 · Video
GET /v1/videos/{request_id}GET /v1/videos/generations/{request_id}GET /v1/videos/{request_id}/contentGET /v1/media/assetsGET /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 |
Псевдонимы
Псевдонимы моделей
Ailoot Ultra pixverse-v5
Псевдонимы путей метода
/v1/videos/generations
Связанные ID для вызова
FAQ · PixVerse v5
- Какие входные данные и результаты доступны?
POST /v1/videos·pixverse-v5:text,image→video- Какие поля использует запрос?
POST /v1/videos·pixverse-v5:model,prompt,aspect_ratio,quality,motion_mode,duration,end_image,lip_sync_tts_content,lip_sync_tts_speaker_id,image,negative_prompt