Vidu: Q2 Text-to-Video
Vidu Q2 мәтіндік көрініс тапсырмасынан бейне жасайды: ұзақтығы 1–10 секунд, шығыс ажыратымдылығы 540p, 720p немесе 1080p және бес арақатынас қолжетімді. Осы нақты viduq2 профилі стиль мен қозғалыс үшін мәтіндік сұрауды пайдаланып, нәтижені асинхронды тапсырма арқылы қайтарады.
Модель туралы
Бұл сипаттама модель мүмкіндіктерін қамтиды. Ailoot жүйесінде таңдалған әдіс үшін қолжетімді кіріс, шығыс және параметрлер төменде берілген.
Vidu Q2 viduq2 арқылы таңдалатын мәтіннен бейне жасау профилімен жазбаша көріністен бейне жасайды. Міндетті кірістері — модельдің дәл идентификаторы және көріністі сипаттайтын мәтіндік сұрау. Оны сыртқы түрі мен қозғалысын сөзбен белгілеуге болатын қысқа тауар тұжырымына, орынның жалпы көрінісіне немесе кейіпкер әрекетіне пайдаланыңыз. Бұл бапталған әдіс мәтіннен бейне жасайды; оның сипаттамасы селекторға бөлек референс кескін немесе бейне өңдеу режимін тағайындамайды.
Тапсырманы көрінетін реттілікке негіздеңіз. Нысанды, орынды, әрекетті, план ірілігін, камера қозғалысын және соңғы композицияны көрсетіңіз. Тауар тұжырымы үшін үстелдегі затты, оның материалының үстімен жылжыған жарықты және танылатын бөлшекке дейін баяу жақындаған камераны сипаттаңыз. Орын көрінісінде назар нүктесіне жылжымас бұрын ортаны көрсетіңіз. Көріністің көзделген аяқталуына уақыт қалуы үшін әрекетті таңдалған клип ұзақтығына сәйкестендіріңіз.
Мәтіндік сұраудың шегі — 2 000 таңба. Алдымен негізгі нысан мен әрекетті, содан соң қажетті нәтижені өзгертетін жарық, материал, орта және камера туралы мәліметтерді қосыңыз. Визуалды стильді мәтінде көрсетіңіз. Q2-ге арналған нұсқаулықта бөлек style және movement_amplitude параметрлері бұл модельге әсер етпейтіні айтылған, сондықтан general немесе anime алдын ала баптауы мен қозғалыс амплитудасы опциялары анық көрініс сипаттамасын алмастырмайды.
Модельге арналған ұзақтық баптауы бірден онға дейінгі бүтін секундтарды қабылдайды. Q2 ажыратымдылық нұсқалары — 540p, 720p және 1080p, құжатталған әдепкісі — 720p. Ұзақтық пен ажыратымдылықты әрекетке және қолданылатын орынға сай бірге таңдаңыз. Қысқа ашып көрсету мен ұзағырақ қозғалысқа әртүрлі уақыт қажет; сұралған ұзақтықты арттыру өзгеріссіз тапсырманы жай созбай, көрінетін реттілікке қызмет етуі керек. Соңғы орналастыруға дайындағанда қайтарылған клиптің нақты өлшемдері мен ұзақтығын тексеріңіз.
Құжатталған aspect_ratio нұсқалары: 16:9, 9:16, 3:4, 4:3 және 1:1, әдепкісі — 16:9. Нұсқаулық Q2 тобы үшін 3:4 және 4:3 арақатынастарын нақты қамтиды. Генерациядан бұрын кадрды таңдап, соған сай композицияны сипаттаңыз: тік көріністе негізгі нысанды анық сақтаңыз немесе айналадағы ортаны көрсету үшін көлденең кадрдың енін пайдаланыңыз. Қажетті бетке, таныстырылымға немесе кейін жазу қосуға жарайтындай соңғы көріністі айқын қалдырыңыз.
seed өрісі нұсқалардың өзгеруін басқарады. Оны бермеу немесе 0 беру кездейсоқ мәнді таңдайды; нөлден өзге мән нәтижені қайталап алуға арналған құжатталған бекітілген seed опциясын таңдайды. Нұсқаларды салыстырғанда қайтарылған seed мәнін мәтінмен және баптаулармен бірге сақтаңыз. Ортақ операцияның құжаттамасында audio және off_peak баптаулары да арнайы Q3 модельдері үшін көрсетілген. Бұл Q3 опциялары осы Q2 профиліне тағайындалған мүмкіндіктер емес; сұрауды оның құжатталған мәтін кірісі мен бейне шығысына сүйеніп жоспарлаңыз.
Генерация асинхронды жүреді. Жіберу task_id және бастапқы күйді қайтарады, жаңа жасалған тапсырма үшін created қолданылады. Өңдеуді қадағалағанда осы тапсырма идентификаторын сақтаңыз. Құжатталған нәтиже сұрауы сәтті нәтиже үшін state=success пайдаланып, creations массивін қайтарады. Әр элементтің бейне URL мекенжайы creations[].url ішінде орналасады; тапсырмада әрдайым дәл бір нәтиже болады деп ойламай, қайтарылған әр бейнені сақтаңыз.
Нәтиже құжаттамасы нақты бейненің ұзақтығын, fps мәнін, кадрдың ені мен биіктігін де хабарлайды. Мысалдағы кадр жиілігін немесе өлшемдерді тұрақты Q2 сипаттамасы деп қабылдамай, осы хабарланған мәндерді дайын клиппен бірге сақтаңыз. Тапсырма жасау жауабында сұрау конфигурациясымен бірге credits мәні беріледі. Әр бейне өз генерация баптауларымен байланысты қалуы үшін осы хабарланған тапсырма метадеректерін және аяқталған тапсырманың идентификаторын нәтижемен бірге сақтаңыз.
Бүкіл реттілікті бастапқы тапсырмамен салыстырыңыз: нысанның сыртқы түрін, зат пішінін, қозғалыс бағытын, камера қозғалысының сабақтастығын және көзделген соңғы көріністі тексеріңіз. Түзету үшін тапсырмаға сәйкес келмеген нақты бөлшекті атап, көріністің сәтті бөліктерін сақтаңыз. Кейінгі салыстыру нақты материалдарға негізделуі үшін мәтіндік сұрауды, дәл селекторды, баптауларды, тапсырма идентификаторын және дайын бейнелерді бірге сақтаңыз.
Ailoot Ultra · Бейне POST /v1/videos viduq2
viduq2Бастау
Vidu Q2 мәтіндік көрініс тапсырмасынан бейне жасайды: ұзақтығы 1–10 секунд, шығыс ажыратымдылығы 540p, 720p немесе 1080p және бес арақатынас қолжетімді. Осы нақты viduq2 профилі стиль мен қозғалыс үшін мәтіндік сұрауды пайдаланып, нәтижені асинхронды тапсырма арқылы қайтарады.
- Қабылданатын кіріс деректері
- Мәтін
- Нәтижелер
- Бейне
Ailoot жүйесінде қолжетімді · кіріс деректері мен әдістер
Ailoot Ultra · Бейне POST /v1/videos
- Кіріс
text- Шығыс
video
| Өріс | Түрі | Талап | Мәндер мен шектеулер | Әдепкі |
|---|---|---|---|---|
Өрісmodel | Түріstring | ТалапМіндетті | Мәндер мен шектеулер viduq2 | Әдепкі— |
Өрісprompt | Түріstring | ТалапМіндетті | Мәндер мен шектеулер Шарттар: Жасалатын көріністі сипаттаңыз. Құжатта көрсетілген шек — 2000 таңба; Ailoot жолдың бос еместігін тексеріп, мәтінді сақтайды. | Әдепкі— |
Өрісduration | Түріinteger | ТалапМіндетті емес | Мәндер мен шектеулер Ең азы: 1 Ең көбі: 10 Шарттар: viduq2 моделіне арналған сипаттамада 1–10 бүтін секунд көрсетілген. Модельге тән әдепкі ұзақтық құжатталмаған. Бірлік: секунд | Әдепкі— |
Өрісseed | Түріstring | ТалапМіндетті емес | Мәндер мен шектеулер Шарттар: Кездейсоқ нәтиже үшін өрісті қоспаңыз немесе "0" жолын жіберіңіз. Нөлден өзге seed мәні берілсе, құжатталған тұрақты seed тәртібі таңдалады; сандық аралық көрсетілмеген. | Әдепкі— |
Өрісaspect_ratio | Түріstring | ТалапМіндетті емес | Мәндер мен шектеулер 16:9, 9:16, 3:4, 4:3, 1:1 | Әдепкі16:9 |
Өрісresolution | Түріstring | ТалапМіндетті емес | Мәндер мен шектеулер 540p, 720p, 1080p Шарттар: viduq2 моделіне арналған тізімде бұл деңгейлер 1–10 секунд үшін құжатталған. Ортақ санамаланған мәндер мен кестеде 360p де аталады; оның қолданылуы сол тізімге қайшы келеді және мұнда расталмайды. | Әдепкі720p |
Өрісstyle | Түріstring | ТалапМіндетті емес | Мәндер мен шектеулер general, anime Шарттар: Ортақ сұрау бұл өрісті қабылдайды, бірақ құжаттамада оның viduq2 үшін әсер етпейтіні тікелей көрсетілген. | Әдепкіgeneral |
Өрісmovement_amplitude | Түріstring | ТалапМіндетті емес | Мәндер мен шектеулер auto, small, medium, large Шарттар: Ортақ сұрау бұл өрісті қабылдайды, бірақ құжаттамада оның q2 модельдеріне әсер етпейтіні тікелей көрсетілген. | Әдепкіauto |
Кіріс материалдарының үйлесімдері
Әдіс параметрлері мен өмірлік циклі
| Параметр | Параметр талаптары |
|---|---|
Параметрcontent_type | Параметр талаптарыapplication/json |
Параметрrequired | Параметр талаптарыmodel, prompt |
Параметрoptional | Параметр талаптарыduration, seed, aspect_ratio, resolution, style, movement_amplitude |
Параметрmaterial_types | Параметр талаптарыtext |
Параметрadditional_properties | Параметр талаптарыtrue |
Параметрvalidation_scope | Параметр талаптарыAiloot model/prompt жолдарының бос еместігін тексереді. Төмендегі міндетті емес түрлер мен шектер сұраудың құжатталған шарттарын құрайды; сұраудың басқа өрістері таңдалған модель үшін сақталады. |
Әдістің балама атаулары: /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/videos/generations/{request_id}/content
Бір рет жасап, қайтарылған ашық id және polling_url мәндерін сақтаңыз.
Бастапқы операцияны мезгіл-мезгіл сұрап, state өрісін оқыңыз; success күйі мен иелігіңіздегі creations[].url нәтижесі аяқталу межесін белгілейді.
Қайтарылған, иелігіңіздегі әрбір бейненің URL мекенжайы бойынша файлды жүктеп алыңыз; мысалға қарап нәтиже саны, ұзақтығы немесе кадр жиілігі тұрақты деп тұжырымдамаңыз.
Тарифтер
Қорытынды төлем қалай есептеледі
Көрсетілген тарифтер генерация басталғанға дейінгі құнын бағалауға арналған. Соңғы төлем бастапқы генерация үшін тіркелген құннан есептеледі. Нәтиженің өлшенген ұзақтығы мен болжамды көлемдер төлемге негіз болатын түпкілікті көлем болып саналмайды.
Тариф анықтамасы сұрау мүмкіндіктерін қоспайды. Қолдау көрсетілетін параметрлер таңдалған әдісте берілген.
- Жылдам режим
- Көрсетілмеген Жылдам режим таңдалғанда
- Икемді режим
- Көрсетілмеген flex режимі таңдалғанда
- Ой қорытудың ең жоғары деңгейі
- Көрсетілмеген Ой қорыту деңгейі ең жоғары болып, default түзетуі қолданылғанда
Салыстыруға арналған болжамды мөлшерлемелер
Баптаулар бойынша бағалар
Әр төлемді көрсетілген шарттармен салыстырыңыз. Балама баптаулардың әр жиыны үшін бір мөлшерлемені қолданыңыз.
| Баптау | Мөлшерлемелер кестесі | Болжамды мөлшер | Төлем |
|---|---|---|---|
| БаптауТокендердің базалық тарифтері | Мөлшерлемелер кестесіНегізгі мөлшерлеме | Болжамды мөлшер— | Төлем Кіріс · Кіріс токендері · Тек салыстыруға арналған бағалау — / 1K токен Шығыс · Шығыс токендері · Тек салыстыруға арналған бағалау — / 1K токен Кіріс · Кэшті оқу · Тек салыстыруға арналған бағалау — / 1K токен Кіріс · Кэшке жазу · Тек салыстыруға арналған бағалау — / 1K токен Кіріс · Кэшке жазу, 1 сағ · Тек салыстыруға арналған бағалау — / 1K токен |
| БаптауГенерацияның болжамды құны | Мөлшерлемелер кестесі— | Болжамды мөлшербір генерацияға арналған болжам | Төлем Шығыс · Генерацияның болжамды құны · Тек салыстыруға арналған бағалау $5.12 жасауға дейінгі бағалау Бұл бағалау қосымша төлем де, аяқталған генерация үшін белгіленген тұрақты тариф те емес. |
Ailoot сұрау алдында болжамды соманы резервтейді. Нәтижеден кейін өлшенген пайдалану көлемі бойынша қорытынды төлемді шегереді. Ағындық жауап үшін төлем соңғы пайдалану жазбасы негізінде шегеріледі. Резервтеу мен төлемді есептеу тәртібі →
Сұрау мысалдары
Ailoot Ultra · Бейне
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
cat > request.json <<'JSON_REQUEST'
{"model":"viduq2","prompt":"In an ultra-realistic fashion photography style featuring light blue and pale amber tones, an astronaut in a spacesuit walks through the fog. The background consists of enchanting white and golden lights, creating a minimalist still life and an impressive panoramic scene."}
JSON_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
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_POLL'
import json
from pathlib import Path
from urllib.parse import quote,urljoin,urlsplit
r=json.loads(Path("result.json").read_text())
i=r.get("id")
if not isinstance(i,str) or not i:raise SystemExit("Keep original response/headers/id; do not resubmit creation.")
u=urljoin("https://api.ailoot.ai",r.get("polling_url") or "/v1/videos/"+quote(i,safe=""))
p=urlsplit(u)
if p.scheme!="https" or p.netloc!="api.ailoot.ai" or not p.path.startswith("/v1/videos/"):raise SystemExit("Use the actual Ailoot lookup path.")
Path("poll-url.txt").write_text(u)
PY_POLL
curl --fail-with-body --silent --show-error "$(cat poll-url.txt)" -H "Authorization: Bearer $AILOOT_API_KEY" -D status-headers.txt -o status.json
set -eu
python3 - <<'PY_ASSETS'
import json
from pathlib import Path
from urllib.parse import urlsplit
r=json.loads(Path("status.json").read_text())
if r.get("state")!="success":raise SystemExit("Poll the same original job until its owned result is returned.")
creations=r.get("creations")
if not isinstance(creations,list) or not creations:raise SystemExit("No completed video creations.")
urls=[]
for item in creations:
value=item.get("url") if isinstance(item,dict) else None
values=[value] if isinstance(value,str) else value
if not isinstance(values,list) or not values:raise SystemExit("No completed video URL.")
for u in values:
if not isinstance(u,str):raise SystemExit("Invalid returned URL.")
p=urlsplit(u)
if p.scheme!="https" or p.netloc!="api.ailoot.ai" or not p.path.startswith("/v1/media/assets/") or not p.path.endswith("/content") or not p.query:raise SystemExit("Wait for the actual Ailoot-owned signed result.")
urls.append(u)
Path("asset-urls.txt").write_text("\n".join(urls)+"\n")
PY_ASSETS
index=0
while IFS= read -r asset_url; do
curl --fail-with-body --silent --show-error "$asset_url" -o "video-${index}.bin"
index=$((index + 1))
done < asset-urls.txt
Нәтижелерді алу және сақтау
Ailoot Ultra · Бейне
JSON төл state және creations массивін сақтайды, оған ашық id/provider_task_id/polling_url қосылады. Таңдалған бейне URL мекенжайлары жарияланғанға дейін бос болады, ал аяқталғаннан кейін Ailoot иелігіндегі қолтаңбасы бар URL мекенжайларына айналады.
GET /v1/videos/{request_id}GET /v1/videos/generations/{request_id}GET /v1/videos/{request_id}/contentGET /v1/videos/generations/{request_id}/content
Барлық дайын нәтижені сақтау
Әр дайын бейнені немесе қайтарылған файлды сақтаңыз; нақты қайтарылған әр материал URL арқылы мазмұнды алыңыз.
creations[].url ішіндегі нақты қайтарылған әрбір URL бойынша файлды жүктеп алыңыз; мазмұн индексі бір нақты қайтарылған шығыс нәтижесін анықтайды.
Бастапқы жауапты тексеру қажет болса
Бекітілген декларацияда түпкілікті сәтсіздік күйі көрсетілмеген. Бастапқы жауапты, тақырыптарды және id мәнін сақтап, танылмаған күй немесе result_pending_check қатесі кезінде сол операцияны тексеріңіз; нәтижесі белгісіз жасау сұрауын ешқашан қайта жібермеңіз.
Жауап өрістері
| Өріс | Түрі | Мағынасы |
|---|---|---|
Өрісid | Түріstring | МағынасыҚайтарылған ашық Ailoot тапсырмасының немесе операциясының идентификаторы. |
Өрісprovider_task_id | Түріstring | МағынасыАшық id мәнінен бөлек бастапқы тапсырма идентификаторы. |
Өрісpolling_url | Түріstring | МағынасыБастапқы тапсырма үшін қайтарылған Ailoot іздеп алу жолы. |
Өрісtask_id | Түріstring when supplied | МағынасыЖасау жауабында бар бастапқы идентификатор. |
Өрісstate | Түріstring when supplied | МағынасыТөл тапсырма күйі: бекітілген күту күйі үшін created, ал аяқталу үшін success. |
Өрісerr_code | Түріstring when supplied | МағынасыТапсырма диагностикасы; сақталған сипаттамада санамаланған қате кодтарының тізімі көрсетілмеген. |
Өрісcreations[].url | Түріstring|string[] | МағынасыТаңдалған әрбір аяқталған бейненің URL мекенжайы Ailoot иелігіндегі қолтаңбасы бар URL мекенжайымен ауыстырылады. |
Өрісcreations[].video.duration | Түріnumber when supplied | МағынасыҚайтарылған бейненің ұзақтығы; нақты аяқталған нәтижені тексеріңіз. |
Өрісcreations[].video.fps | Түріinteger when supplied | МағынасыҚайтарылған кадр жиілігі; тұрақты кадр жиілігіне уәде берілмейді. |
Өрісcreations[].video.resolution.width | Түріinteger when supplied | МағынасыҚайтарылған шығыс нәтижесінің пиксельмен өлшенетін ені. |
Өрісcreations[].video.resolution.height | Түріinteger when supplied | МағынасыҚайтарылған шығыс нәтижесінің пиксельмен өлшенетін биіктігі. |
Қателер және келесі қадамдар
| Жауап | Шарт | Келесі қадам |
|---|---|---|
Жауап400 · invalid_request_error | ШартJSON немесе модель жарамсыз, міндетті жолдар жоқ не бос немесе мазмұн индексі қате. | Келесі қадам |
Жауап401 · authentication_error | ШартAiloot API кілті жарамсыз. | Келесі қадам |
Жауап403 · permission_error | ШартAPI кілтінің тобына бұл медиа маршрутын пайдалануға рұқсат берілмеген. | Келесі қадам |
Жауап404 · not_found_error | ШартБастапқы тапсырма немесе сұралған нәтиже жоқ не сол пайдаланушыға, API кілтіне немесе топқа тиесілі емес. | Келесі қадам |
Жауап502 · result_pending_check | ШартБастапқы жіберу немесе күй туралы мәлімет толық емес не оларды өзара сәйкестендіру мүмкін емес; бастапқы ID мәнін сақтап, қайта жібермеңіз. | Келесі қадам |
Жауап503 · result_pending_check | ШартБастапқы байланыс, маршрут немесе иелігіңіздегі медиа әлі тексерілуде; сол бастапқы операцияны тексеруді жалғастырыңыз. | Келесі қадам |
Жауап503 · server_error | ШартМедиа қызметі немесе бастапқы тапсырмалар қоймасы қолжетімді емес. | Келесі қадам |
Балама атаулар
Модельдердің балама атаулары
Ailoot Ultra viduq2
Әдіс жолдарының балама атаулары
/v1/videos/generations
Шақыруға арналған байланысты ID
FAQ · Vidu: Q2 Text-to-Video
- Қандай кіріс деректері мен нәтижелер қолжетімді?
POST /v1/videos·viduq2:text→video- Сұрау қандай өрістерді пайдаланады?
POST /v1/videos·viduq2:model,prompt,duration,seed,aspect_ratio,resolution,style,movement_amplitude- Қандай шектеулер қолданылады?
POST /v1/videos·viduq2:duration.minimum:1;duration.maximum:10