models

vidu-q2-reference

Markdown · JSON

vidu-q2-reference

Vidu Q2 Reference жазбаша видео тапсырмасын міндетті емес сурет референстерімен және соңғы суретпен біріктіреді. Ailoot арқылы кадрлауды, ажыратымдылықты және төрт не сегіз секундтық ұзақтықты таңдаңыз.

Модель туралы

Бұл сипаттама модель мүмкіндіктерін қамтиды. Ailoot жүйесінде таңдалған әдіс үшін қолжетімді кіріс, шығыс және параметрлер төменде берілген.

/v1/videos ішінде vidu-q2-reference моделін model және prompt өрістерімен пайдаланыңыз. Сұрауда жол не он жолға дейінгі массив түріндегі image, end_image, aspect_ratio, duration және resolution бар. Төрт не сегіз секундты, 360p, 720p не 1080p және 16:9, 1:1 не 9:16 кадрлауды таңдаңыз.

Референске негізделген қозғалысты және соңғы композицияны сипаттаңыз. Суреттер бергенде әр референстің рөлін және сақталатын нысан бөлшектерін анықтаңыз. Әрекет пен камера бағытын бөлек нұсқаулармен беріп, соңғы қалыпты не кадрлауды анықтаңыз. Дайын видеоны сол материалмен салыстыру үшін таңдалған суреттерді, prompt-ты және міндетті емес соңғы суретті сұраумен бірге сақтаңыз.

Кадрды /v1/videos арқылы бір рет жіберіп, қайтарылған сұрау ID-ін сақтаңыз. /v1/videos/{request_id} арқылы сол операцияның күйін сұрап, содан кейін әр дайын видео нәтижесін және толық жауапты сақтаңыз. Толық әрекет пен соңғы композицияны берілген материалмен және тапсырмамен салыстырыңыз.

Ailoot Ultra · Video POST /v1/videos vidu-q2-reference

vidu-q2-reference

Басқа /vidu-q2-reference

Бастау

Vidu Q2 Reference жазбаша видео тапсырмасын міндетті емес сурет референстерімен және соңғы суретпен біріктіреді. Ailoot арқылы кадрлауды, ажыратымдылықты және төрт не сегіз секундтық ұзақтықты таңдаңыз.

Қабылданатын кіріс деректері
Мәтін · Суреттер
Нәтижелер
Бейне

Ailoot жүйесінде қолжетімді · кіріс деректері мен әдістер

Ailoot Ultra · Video POST /v1/videos
Кіріс
text, image
Шығыс
video
ӨрісТүріТалапМәндер мен шектеулерӘдепкі
ӨрісmodelТүріstringТалапМіндеттіМәндер мен шектеулер
vidu-q2-reference
Шарттар: Ailoot жүйесінің дәл осы маршруттау селекторын пайдаланыңыз.
Әдепкі—
Өрісaspect_ratioТүріstringТалапМіндетті емесМәндер мен шектеулер
16:9, 1:1, 9:16
Шарттар: Таңдалған модельдің құжатталған өрісін және тізімдегі нұсқаларды пайдаланыңыз; міндетті емес мән берілмесе, оны сұрауға қоспаңыз.
Әдепкі—
ӨрісdurationТүріintegerТалапМіндетті емесМәндер мен шектеулер
4, 8
Шарттар: Таңдалған модельдің құжатталған өрісін және тізімдегі нұсқаларды пайдаланыңыз; міндетті емес мән берілмесе, оны сұрауға қоспаңыз.
Әдепкі—
Өрісend_imageТүріstringТалапМіндетті емесМәндер мен шектеулер
Шарттар: Таңдалған модельдің құжатталған өрісін және тізімдегі нұсқаларды пайдаланыңыз; міндетті емес мән берілмесе, оны сұрауға қоспаңыз.
Әдепкі—
ӨрісimageТүріstring or array<string>ТалапМіндетті емесМәндер мен шектеулер
Шарттар: Кескініңіздің нақты қолжетімді URL мекенжайын беріңіз. Тізім параметр схемасында массив көрсетілген жағдайда ғана қабылданады.
Әдепкі—
ӨрісpromptТүріstringТалапМіндеттіМәндер мен шектеулер
Шарттар: Таңдалған модельдің құжатталған өрісін және тізімдегі нұсқаларды пайдаланыңыз; міндетті емес мән берілмесе, оны сұрауға қоспаңыз.
Әдепкі—
ӨрісresolutionТүріstringТалапМіндетті емесМәндер мен шектеулер
360p, 720p, 1080p
Шарттар: Таңдалған модельдің құжатталған өрісін және тізімдегі нұсқаларды пайдаланыңыз; міндетті емес мән берілмесе, оны сұрауға қоспаңыз.
Әдепкі—
Әдіс параметрлері мен өмірлік циклі
ПараметрПараметр талаптары
Параметрcontent_typeПараметр талаптарыapplication/json
ПараметрrequiredПараметр талаптарыmodel, prompt
ПараметрoptionalПараметр талаптарыaspect_ratio, duration, end_image, image, resolution
Параметрmaterial_typesПараметр талаптарыtext, image
ПараметрconditionsПараметр талаптарыAiloot жүйесінің дәл осы маршруттау селекторын пайдаланыңыз., Таңдалған модельдің құжатталған өрісін және тізімдегі нұсқаларды пайдаланыңыз; міндетті емес мән берілмесе, оны сұрауға қоспаңыз., Таңдалған модельдің құжатталған өрісін және тізімдегі нұсқаларды пайдаланыңыз; міндетті емес мән берілмесе, оны сұрауға қоспаңыз., Таңдалған модельдің құжатталған өрісін және тізімдегі нұсқаларды пайдаланыңыз; міндетті емес мән берілмесе, оны сұрауға қоспаңыз., Кескініңіздің нақты қолжетімді URL мекенжайын беріңіз. Тізім параметр схемасында массив көрсетілген жағдайда ғана қабылданады., Таңдалған модельдің құжатталған өрісін және тізімдегі нұсқаларды пайдаланыңыз; міндетті емес мән берілмесе, оны сұрауға қоспаңыз., Таңдалған модельдің құжатталған өрісін және тізімдегі нұсқаларды пайдаланыңыз; міндетті емес мән берілмесе, оны сұрауға қоспаңыз.

Әдістің балама атаулары: /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 режимі таңдалғанда
Ой қорытудың ең жоғары деңгейі
Көрсетілмеген Ой қорыту деңгейі ең жоғары болып, default түзетуі қолданылғанда

Салыстыруға арналған болжамды мөлшерлемелер

Баптаулар бойынша бағалар

Әр төлемді көрсетілген шарттармен салыстырыңыз. Балама баптаулардың әр жиыны үшін бір мөлшерлемені қолданыңыз.

БаптауМөлшерлемелер кестесіБолжамды мөлшерТөлем
БаптауТокендердің базалық тарифтеріМөлшерлемелер кестесіНегізгі мөлшерлемеБолжамды мөлшер—Төлем
Кіріс · Кіріс токендері · Тек салыстыруға арналған бағалау — / 1K токен
Шығыс · Шығыс токендері · Тек салыстыруға арналған бағалау — / 1K токен
Кіріс · Кэшті оқу · Тек салыстыруға арналған бағалау — / 1K токен
Кіріс · Кэшке жазу · Тек салыстыруға арналған бағалау — / 1K токен
Кіріс · Кэшке жазу, 1 сағ · Тек салыстыруға арналған бағалау — / 1K токен
БаптауГенерацияның болжамды құныМөлшерлемелер кестесі—Болжамды мөлшербір генерацияға арналған болжамТөлем
Шығыс · Генерацияның болжамды құны · Тек салыстыруға арналған бағалау $0.2 жасауға дейінгі бағалау

Бұл бағалау қосымша төлем де, аяқталған генерация үшін белгіленген тұрақты тариф те емес.

Ailoot сұрау алдында болжамды соманы резервтейді. Нәтижеден кейін өлшенген пайдалану көлемі бойынша қорытынды төлемді шегереді. Ағындық жауап үшін төлем соңғы пайдалану жазбасы негізінде шегеріледі. Резервтеу мен төлемді есептеу тәртібі →

Сұрау мысалдары

Ailoot Ultra · Video

curl · бір рет құрып, нәтижені толық сақтаңызБастапқы тапсырманы оқыңызӨзіңізге тиесілі толық дайын болған әрбір ресурсты сақтаңыз
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
: "${AILOOT_IMAGE_URL:?Set an actual customer material or documented value}"
export AILOOT_IMAGE_URL
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads('{"model": "vidu-q2-reference", "prompt": "A cat is walking on grass.", "image": "YOUR_ACCESSIBLE_IMAGE_URL"}')
p['image']=os.environ['AILOOT_IMAGE_URL']
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 арқылы мазмұнды алыңыз.

Толық жауап пен тақырыптарды, бастапқы идентификаторларды, әрбір нақты шығыс нәтижесін және пайдалану мен есепке алудың барлық өрістерін сақтаңыз. Иелігіңіздегі әрбір бірегей ресурсты сақтап, оған сілтейтін барлық рөлді сақтаңыз.

Бастапқы жауапты тексеру қажет болса

Қайтарылған ашық тапсырма не операция 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 vidu-q2-reference

Әдіс жолдарының балама атаулары

/v1/videos/generations

Шақыруға арналған байланысты ID

vidu-q2-reference

FAQ · vidu-q2-reference
Қандай кіріс деректері мен нәтижелер қолжетімді?

POST /v1/videos · vidu-q2-reference: text, image → video

Сұрау қандай өрістерді пайдаланады?

POST /v1/videos · vidu-q2-reference: model, aspect_ratio, duration, end_image, image, prompt, resolution

Толығырақ

Ailoot-ты Claude Code, OpenCode, Hermes не қолданбаңызға қосыңыз.

Компания және оның жобалар портфелі

Компания және оның жобалар портфелі: миллиондаған клиент; ай сайынғы сату көлемі миллиардтармен есептеледі.

Токенді жеңілдікпен сатып алыңыз.

Тұрақты жұмысқа жазылым жеңілдігі. Токен сатып алуға промокодтар — 50% дейін.

Жазылым
Тұрақты сұрауыңызға жеңілдікті тариф таңдаңыз.
50% дейінгі промокод
Сатып алғанда код енгізіңіз. Баға қазіргі науқанмен қайта есептеледі.
Тарихтағы шығындар
Әр сұрауға модель, токен және сома сақталады.

Жазылым таңдау · Модель бағасын көру

API-ді сататын өніміңізге қосыңыз.

SaaS, қолданба мен бот Ailoot офертасы және лицензиялық шартына сай. Қайта сатуға реселлер лицензиясын сұраңыз.

Коммерциялық қолданба
Қызметіңіздің ақылы функциясына мәтін, сурет, бейне және дыбыс жасауды қосыңыз.
Реселлер лицензиясы
Жоба сипаттамасы мен кіру схемасын жіберіңіз. Пайдалану мен қайта сатуға жазбаша шарт сұраңыз.
Сайттағы құжаттар
Оферта, лицензиялық шарт және дерек саясаты қоспай тұрып қолжетімді.

Реселлер лицензиясын сұрау · Оферта мен лицензиялық шарт