ltx принимает письменное описание и необязательное изображение через /v1/videos и создаёт видео. Пример задачи — анимировать переданную фотографию продукта в концептуальном кадре, описав движение текстом. Выбирайте маршрут, когда предполагается использование референсного изображения.
Предоставляются параметры model, prompt, image и negative_prompt. Запись не закрепляет конкретную редакцию LTX и не предоставляет настройки длительности, разрешения, частоты кадров или аудио. Контракт позволяет запросить сцену по референсу, но не обещает точные параметры клипа, отсутствующие в методе. Отправьте запрос один раз, сохраните исходные идентификаторы задания и получите все фактические результаты завершённого задания.
", "aboutText": "ltx принимает письменное описание и необязательное изображение через /v1/videos и создаёт видео. Пример задачи — анимировать переданную фотографию продукта в концептуальном кадре, описав движение текстом. Выбирайте маршрут, когда предполагается использование референсного изображения. Предоставляются параметры model, prompt, image и negative_prompt. Запись не закрепляет конкретную редакцию LTX и не предоставляет настройки длительности, разрешения, частоты кадров или аудио. Контракт позволяет запросить сцену по референсу, но не обещает точные параметры клипа, отсутствующие в методе. Отправьте запрос один раз, сохраните исходные идентификаторы задания и получите все фактические результаты завершённого задания.", "editorialOverlay": { "copy_fields": { "about_html": "ltx принимает письменное описание и необязательное изображение через /v1/videos и создаёт видео. Пример задачи — анимировать переданную фотографию продукта в концептуальном кадре, описав движение текстом. Выбирайте маршрут, когда предполагается использование референсного изображения.
Предоставляются параметры model, prompt, image и negative_prompt. Запись не закрепляет конкретную редакцию LTX и не предоставляет настройки длительности, разрешения, частоты кадров или аудио. Контракт позволяет запросить сцену по референсу, но не обещает точные параметры клипа, отсутствующие в методе. Отправьте запрос один раз, сохраните исходные идентификаторы задания и получите все фактические результаты завершённого задания.
", "short_text": "Генерация видео по тексту и необязательному референсному изображению с поддержкой negative_prompt." }, "copy_sha256": "cd3d774ab80c11fb2a1aee8db8e6b8e34856932f028c0f6a5a5d82b3cddbf061", "copy_source": { "locale": "ru", "pack_sha256": "0f56d90ba41881e1134accf82e57338f246f8753ca4c0cee929aaffada5d10e7", "record_model_id": "ltx", "source_facts_sha256": "d0bbb3192016a6afe076164d0f83ddc7a1eeb3b88248cd3ea35845564e471b15", "validation_sha256": "a2ac2f28056280fc0b2ea34a501bf156d5ce155406e57e708edf30bfdf6bfdc6" }, "html_sha256": "1ba230e63f4c9cff24da22e720de7c49f7b07822fa0cfee3f5d942ca05c52ccf", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "ru", "methods": [ { "html": "ltxГенерация видео по тексту и необязательному референсному изображению с поддержкой negative_prompt.
Описание раскрывает возможности модели. Доступные в Ailoot входные данные, результаты и параметры выбранного метода перечислены ниже.
ltx принимает письменное описание и необязательное изображение через /v1/videos и создаёт видео. Пример задачи — анимировать переданную фотографию продукта в концептуальном кадре, описав движение текстом. Выбирайте маршрут, когда предполагается использование референсного изображения.
Предоставляются параметры model, prompt, image и negative_prompt. Запись не закрепляет конкретную редакцию LTX и не предоставляет настройки длительности, разрешения, частоты кадров или аудио. Контракт позволяет запросить сцену по референсу, но не обещает точные параметры клипа, отсутствующие в методе. Отправьте запрос один раз, сохраните исходные идентификаторы задания и получите все фактические результаты завершённого задания.
POST /v1/videostext, imagevideo| Поле | Тип | Требование | Значения и ограничения | По умолчанию |
|---|---|---|---|---|
Полеmodel | Типstring | ТребованиеОбязательно | Значения и ограничения ltx Условия: Используйте этот селектор маршрутизации Ailoot в точности. | По умолчанию— |
Полеprompt | Типstring | ТребованиеОбязательно | Значения и ограничения Условия: Опишите сцену и движение в ней. | По умолчанию— |
Полеimage | Типstring or array<string> | ТребованиеНеобязательно | Значения и ограничения Условия: Используйте фактический общедоступный URL вашего изображения или изображение в base64; выбранная модель поддерживает изображения на входе. | По умолчанию— |
Полеnegative_prompt | Типstring | ТребованиеНеобязательно | Значения и ограничения Условия: Опишите содержимое, которого следует избегать. | По умолчанию— |
| Параметр | Контракт |
|---|---|
Параметрcontent_type | Контрактapplication/json |
Параметрrequired | Контрактmodel, prompt |
Параметрoptional | Контракт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}
Отображаемые тарифы позволяют оценить стоимость до генерации. Итоговое списание рассчитывается по стоимости, записанной для исходной генерации. Измеренная длительность результата и прогнозные объёмы не являются итоговым оплачиваемым объёмом.
Тарифная справка не добавляет режимы запроса. Поддерживаемые параметры указаны для выбранного метода.
Сопоставьте каждую плату с указанными условиями. Для каждого набора альтернативных конфигураций используйте одну ставку.
| Конфигурация | Шкала ставок | Прогноз количества | Расчётное количество | Плата |
|---|---|---|---|---|
| КонфигурацияБазовые тарифы на токены | Шкала ставокБазовая ставка | Прогноз количества— | Расчётное количество— | Плата Вход · Входные токены · Оценка только для сравнения — / 1K токенов Выход · Выходные токены · Оценка только для сравнения — / 1K токенов Вход · Чтение кэша · Оценка только для сравнения — / 1K токенов Вход · Запись в кэш · Оценка только для сравнения — / 1K токенов Вход · Запись в кэш, 1 час · Оценка только для сравнения — / 1K токенов |
| КонфигурацияЗа запрос | Шкала ставок— | Прогноз количества— | Расчётное количествоОдин запрос | Плата Вход · Оценка только для сравнения $0.1 за запрос |
| КонфигурацияОриентировочная стоимость генерации | Шкала ставок— | Прогноз количестваОценка для одной генерации | Расчётное количество— | Плата Выход · Оценочная стоимость генерации · Оценка только для сравнения $0.1 оценка до генерации Эта оценка не является дополнительным списанием или фиксированным тарифом для завершённой генерации. |
Ailoot резервирует расчётную сумму перед запросом. После получения результата списывает итоговую плату по измеренному расходу. Для окончательного списания за потоковый ответ используется итоговая запись расхода. Как работают резервирование и расчёт →
set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\ncat > request.json <<'JSON'\n{\n "model": "ltx",\n "prompt": "A cat is walking on grass."\n}\nJSON\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/videos \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \\\n --data-binary @request.json -D response-headers.txt -o result.json\n# Create once; retain id, polling_url, original task identifiers and every header.\nset -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\nexport AILOOT_API_KEY\npython3 - <<'PY_STATUS'\nimport json,os,subprocess\nfrom pathlib import Path\nfrom urllib.parse import urljoin,urlsplit\nr=json.loads(Path("result.json").read_text())\nu=urljoin("https://api.ailoot.ai",r["polling_url"])\np=urlsplit(u)\nif p.scheme!="https" or p.netloc!="api.ailoot.ai" or p.username or p.password:\n raise SystemExit("Unexpected returned polling URL; preserve the response")\nsubprocess.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)\n# Read this same original polling_url again while pending.\n# Preserve unknown/result_pending_check; do not repeat creation.\nPY_STATUS\nset -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\nexport AILOOT_API_KEY\npython3 - <<'PY_ASSETS'\nimport json,os,subprocess\nfrom pathlib import Path\nfrom urllib.parse import urljoin,urlsplit\nr=json.loads(Path("status.json").read_text())\nroles={}\ndef visit(v,path=""):\n if isinstance(v,dict):\n for k,x in v.items(): visit(x,path+"/"+k)\n elif isinstance(v,list):\n for i,x in enumerate(v): visit(x,path+"/"+str(i))\n elif isinstance(v,str):\n u=urljoin("https://api.ailoot.ai",v); p=urlsplit(u)\n 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"):\n roles.setdefault(u,[]).append(path)\nvisit(r)\nif not roles: raise SystemExit("No completed owned assets; retain the original status")\nmanifest=[]\nfor i,(u,paths) in enumerate(roles.items()):\n target=Path(f"asset-{i}.bin")\n subprocess.run(["curl","--fail-with-body","--silent","--show-error",u,"-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"],"-o",str(target)],check=True)\n raw=target.read_bytes()\n if not raw: raise SystemExit("Empty asset; retain original status and metadata")\n 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"\n name=f"asset-{i}.{ext}"\n if target.name!=name: target.rename(name)\n manifest.append({"file":name,"response_paths":paths,"bytes":len(raw)})\nPath("asset-manifest.json").write_text(json.dumps(manifest,indent=2))\nprint("Saved",len(manifest),"unique owned assets; every response role retained")\nPY_ASSETS\nGET /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 ltx
/v1/videos/generations