Vidu: Q2 Text-to-Video

Vidu Q2 yozma sahna topshirig‘idan video yaratadi: davomiylik 1–10 soniya, chiqish aniqligi 540p, 720p yoki 1080p va beshta tomon nisbati mavjud. Aynan shu viduq2 profili uslub va harakat uchun promptdan foydalanadi hamda natijani asinxron vazifa orqali qaytaradi.

Ailoot Ultra · Video yaratish POST /v1/videos viduq2

Model haqida

Bu tavsif model imkoniyatlarini yoritadi. Ailoot da tanlangan usul uchun mavjud kirish, chiqish va parametrlar quyida keltirilgan.

Vidu Q2 viduq2 orqali tanlanadigan matndan video yaratish profilida yozma sahnadan video yaratadi. Majburiy kirishlar — modelning aniq identifikatori va sahnani tavsiflovchi prompt. Undan tashqi ko‘rinishi va harakatini so‘z bilan belgilash mumkin bo‘lgan qisqa mahsulot konsepsiyasi, joyni tanishtiruvchi umumiy ko‘rinish yoki personaj harakati uchun foydalaning. Bu sozlangan usul matndan video yaratishdir; uning tavsifi shu model tanloviga alohida tasvir referensi yoki videoni tahrirlash rejimini biriktirmaydi.

Topshiriqni ko‘rinadigan ketma-ketlik atrofida tuzing. Obyekt, joy, harakat, kadr yirikligi, kamera siljishi va yakuniy kompozitsiyani belgilang. Mahsulot konsepsiyasida stol ustidagi buyum, materiali bo‘ylab siljiydigan yorug‘lik va tanish tafsilot ustida tugaydigan sekin kamera yaqinlashuvini tavsiflang. Joy sahnasida markaziy nuqtaga o‘tishdan oldin muhitni tanishtiring. Sahna kerakli yakuniga ulgurishi uchun harakatni tanlangan klip uzunligiga mos saqlang.

Prompt chegarasi 2,000 belgi. Asosiy obyekt va harakatni birinchi o‘ringa qo‘ying, keyin kerakli natijaga ta’sir qiladigan yorug‘lik, material, muhit va kamera tafsilotlarini qo‘shing. Vizual uslubni promptda belgilang. Q2 ga xos qo‘llanma alohida style va movement_amplitude parametrlari bu modelda ta’sir qilmasligini aytadi; shuning uchun general yoki anime tayyor sozlamasi hamda harakat amplitudasi tanlovlari aniq sahna tavsifining o‘rnini bosmaydi.

Modelga xos davomiylik sozlamasi bir soniyadan o‘n soniyagacha butun sonlarni qabul qiladi. Q2 ga xos aniqlik tanlovlari 540p, 720p va 1080p; hujjatlashtirilgan standart 720p. Davomiylik va aniqlikni harakat hamda foydalanish joyiga qarab birga tanlang. Qisqa ochib ko‘rsatish va uzunroq harakat turlicha vaqt talab qiladi; so‘ralgan davomiylikni oshirish o‘zgarmagan topshiriqni shunchaki cho‘zish emas, ko‘rinadigan ketma-ketlikka xizmat qilsin. Yakuniy joylashtirishni tayyorlashda qaytgan klipning haqiqiy o‘lchamlari va uzunligini tekshiring.

Hujjatlashtirilgan aspect_ratio tanlovlari 16:9, 9:16, 3:4, 4:3 va 1:1; standart 16:9. Qo‘llanma Q2 oilasi uchun 3:4 va 4:3 ni ochiq kiritadi. Yaratishdan oldin kadrni tanlang va unga mos kompozitsiyani tavsiflang: tik ko‘rinishda asosiy obyektni ravshan saqlang yoki yotiq kadr kengligidan atrof muhitni ko‘rsatish uchun foydalaning. Yakuniy ko‘rinish kerakli sahifa, taqdimot yoki keyin matn joylash uchun yetarlicha aniq bo‘lsin.

seed maydoni variatsiyani boshqaradi. Uni bermaslik yoki 0 berish tasodifiy qiymatni tanlaydi; noldan farqli qiymat esa takrorlanuvchi yaratish uchun hujjatlashtirilgan o‘zgarmas seed tanlovini belgilaydi. Versiyalarni solishtirishda qaytarilgan seed’ni prompt va sozlamalar bilan saqlang. Umumiy amal audio va off_peak boshqaruvlarini ham aynan Q3 modellari uchun hujjatlashtiradi. O‘sha Q3 tanlovlari ushbu Q2 profiliga biriktirilgan imkoniyatlar emas; bu so‘rovni uning hujjatlashtirilgan matn kirishi va video chiqishi asosida rejalang.

Yaratish asinxron. Yuborish task_id va boshlang‘ich holatni qaytaradi; yangi yaratilgan vazifa uchun created ishlatiladi. Ishlovni kuzatishda vazifaning shu identifikatorini saqlang. Hujjatlashtirilgan natija so‘rovi muvaffaqiyatli natija uchun state=success dan foydalanadi va creations massivini qaytaradi. Har bir elementning video URL’i creations[].url da bo‘ladi; vazifada doimo aynan bitta natija bo‘ladi deb hisoblamasdan, qaytarilgan har bir videoni saqlang.

Natija hujjatlari haqiqiy videoning duration, fps hamda aniqlik eni va bo‘yini ham qaytaradi. Misoldagi kadrlar chastotasi yoki o‘lchamlarni o‘zgarmas Q2 spetsifikatsiyasi deb qabul qilmasdan, qaytarilgan shu qiymatlarni tayyor klip bilan saqlang. Vazifa yaratish javobida so‘rov konfiguratsiyasi yonida credits qiymati ham bor. Har bir video o‘z yaratish sozlamalariga bog‘liq qolishi uchun qaytarilgan shu vazifa metama’lumotlarini va tugallangan vazifaning identifikatorini natija bilan saqlang.

Butun ketma-ketlikni asl topshiriqqa solishtiring: obyekt qiyofasi, buyum shakli, harakat yo‘nalishi, kamera izchilligi va kerakli yakuniy ko‘rinish. Tuzatishda topshiriqqa mos kelmagan aniq tafsilotni belgilang va sahnaning muvaffaqiyatli qismlarini saqlang. Keyingi solishtirish haqiqiy natijalarga asoslanishi uchun prompt, aniq model tanlovi, sozlamalar, vazifa identifikatori va tugallangan videolarni birga saqlang.

Ailoot Ultra · Video yaratish POST /v1/videos viduq2

viduq2

Vidu /viduq2

Boshlash

Qabul qilinadigan kirish ma’lumotlari: Matn
Natijalar: Video

Ailoot da mavjud · kirish ma’lumotlari va usullar

Ailoot Ultra · Video yaratish POST /v1/videos

Kirish: text
Chiqish: video

Maydon	Tur	Talab	Qiymatlar va cheklovlar	Standart
Maydon`model`	Tur`string`	TalabMajburiy	Qiymatlar va cheklovlar viduq2	Standart—
Maydon`prompt`	Tur`string`	TalabMajburiy	Qiymatlar va cheklovlar Shartlar: Yaratiladigan sahnani tasvirlang. Hujjatdagi limit 2000 belgi; Ailoot bo‘sh bo‘lmagan satrni tekshiradi va matnni saqlaydi.	Standart—
Maydon`duration`	Tur`integer`	TalabIxtiyoriy	Qiymatlar va cheklovlar Eng kam: 1 Eng ko‘p: 10 Shartlar: Modelga xos viduq2 tavsifida 1–10 butun soniya ko‘rsatilgan. Modelga xos standart davomiylik hujjatlashtirilmagan. Birlik: soniya	Standart—
Maydon`seed`	Tur`string`	TalabIxtiyoriy	Qiymatlar va cheklovlar Shartlar: Tasodifiylik uchun bermang yoki "0" satrini yuboring. Nol bo‘lmagan seed berilsa, hujjatdagi belgilangan seed bilan ishlash rejimi tanlanadi; sonli oraliq ko‘rsatilmagan.	Standart—
Maydon`aspect_ratio`	Tur`string`	TalabIxtiyoriy	Qiymatlar va cheklovlar 16:9, 9:16, 3:4, 4:3, 1:1	Standart16:9
Maydon`resolution`	Tur`string`	TalabIxtiyoriy	Qiymatlar va cheklovlar 540p, 720p, 1080p Shartlar: Modelga xos viduq2 ro‘yxati bu darajalarni 1–10 soniya uchun hujjatlashtiradi. Umumiy enum va jadvalda 360p ham keltirilgan; uning qo‘llanishi shu ro‘yxatga zid va bu yerda tasdiqlanmaydi.	Standart720p
Maydon`style`	Tur`string`	TalabIxtiyoriy	Qiymatlar va cheklovlar general, anime Shartlar: Umumiy so‘rov bu maydonni qabul qiladi, ammo hujjatda viduq2 uchun uning ta’siri yo‘qligi aniq ko‘rsatilgan.	Standartgeneral
Maydon`movement_amplitude`	Tur`string`	TalabIxtiyoriy	Qiymatlar va cheklovlar auto, small, medium, large Shartlar: Umumiy so‘rov bu maydonni qabul qiladi, ammo hujjatda q2 modellari uchun uning ta’siri yo‘qligi aniq ko‘rsatilgan.	Standartauto

Kirish materiallari birikmalari

Usul parametrlari va hayot sikli

Parametr	Parametr talablari
Parametr`content_type`	Parametr talablariapplication/json
Parametr`required`	Parametr talablarimodel, prompt
Parametr`optional`	Parametr talablariduration, seed, aspect_ratio, resolution, style, movement_amplitude
Parametr`material_types`	Parametr talablaritext
Parametr`additional_properties`	Parametr talablaritrue
Parametr`validation_scope`	Parametr talablariAiloot bo‘sh bo‘lmagan model/prompt satrlarini tekshiradi. Quyidagi ixtiyoriy turlar va limitlar hujjatdagi so‘rov shartnomasidir; boshqa so‘rov maydonlari tanlangan model uchun saqlanadi.

Usul taxalluslari: /v1/videos/generations

Hayot sikli: 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

Bir marta yarating va qaytarilgan ochiq id hamda polling_url ni saqlang.

Dastlabki operatsiya holatini so‘rab tekshiring; success va egalik qilinadigan creations[].url natijasi yakunlanganlik mezonidir.

Qaytarilgan, egalik qilinadigan barcha video URL larini yuklab oling; misoldan chiqishlar soni, davomiyligi yoki kadrlar tezligi o‘zgarmas degan xulosa chiqarmang.

Tariflar

Yakuniy to‘lov qanday hisoblanadi

Ko‘rsatilgan tariflar xarajatni generatsiyadan oldin taxminiy hisoblash uchun xizmat qiladi. Yakuniy to‘lov dastlabki generatsiya uchun qayd etilgan xarajat asosida hisoblanadi. Natijaning o‘lchangan davomiyligi va oldindan taxmin qilingan miqdorlar haq undiriladigan yakuniy miqdor hisoblanmaydi.

Tarif ma’lumotlari so‘rov imkoniyatlarini qo‘shmaydi. Qo‘llab-quvvatlanadigan parametrlar tanlangan usulda ko‘rsatilgan.

Tezkor rejim: Ko‘rsatilmagan Tezkor rejim tanlanganda
Flex rejimi: Ko‘rsatilmagan flex rejimi tanlanganda
Maksimal fikrlash darajasi: Ko‘rsatilmagan Maksimal fikrlash darajasi uchun standart (default) tuzatish qo‘llanganda

Taqqoslash uchun taxminiy tariflar

Sozlamalar bo‘yicha narxlar

Har bir to‘lovni ko‘rsatilgan shartlarga moslang. Har bir muqobil sozlamalar to‘plami uchun bitta tarifdan foydalaning.

Sozlama	Tariflar jadvali	Prognoz miqdori	To‘lov
SozlamaTokenlar uchun bazaviy tariflar	Tariflar jadvaliAsosiy tarif	Prognoz miqdori—	To‘lov Kirish · Kirish tokenlari · Faqat taqqoslash uchun taxmin — / 1K token Chiqish · Chiqish tokenlari · Faqat taqqoslash uchun taxmin — / 1K token Kirish · Keshdan o‘qish · Faqat taqqoslash uchun taxmin — / 1K token Kirish · Keshga yozish · Faqat taqqoslash uchun taxmin — / 1K token Kirish · Keshga yozish, 1 soat · Faqat taqqoslash uchun taxmin — / 1K token
SozlamaYaratishning taxminiy qiymati	Tariflar jadvali—	Prognoz miqdoribir generatsiya uchun taxmin	To‘lov Chiqish · Yaratishning taxminiy narxi · Faqat taqqoslash uchun taxmin $5.12 yaratishdan oldingi taxmin Bu taxmin qo‘shimcha to‘lov ham, tugallangan generatsiya uchun qat’iy tarif ham emas.

Ailoot so‘rovdan oldin taxminiy summani band qiladi. Natijadan keyin o‘lchangan sarf asosidagi yakuniy to‘lovni yechadi. Oqimli javob bo‘yicha yakuniy hisob-kitob yakuniy sarf yozuviga asoslanadi. Summani band qilish va to‘lovni hisoblash tartibi →

So‘rov namunalari

Ailoot Ultra · Video yaratish

curl · Video yaratingcurl · Asl vazifa ma’lumotlarini o‘qingcurl · O‘zingizga tegishli har bir videoni yuklab oling

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

Natijalarni olish va saqlash

Ailoot Ultra · Video yaratish

JSON asl holat va creations massivini saqlaydi, ularga ochiq id/provider_task_id/polling_url qo‘shiladi. Tanlangan video URL lari e’lon qilinishidan oldin bo‘sh bo‘ladi va yakunlangach Ailoot egaligidagi imzolangan URL larga aylanadi.

GET /v1/videos/{request_id}
GET /v1/videos/generations/{request_id}
GET /v1/videos/{request_id}/content
GET /v1/videos/generations/{request_id}/content

Barcha tayyor natijalarni saqlash

Har bir tayyor video yoki qaytarilgan faylni saqlang; har bir haqiqatan qaytarilgan material URL dan kontentni oling.

creations[].url ichida haqiqatda qaytarilgan har bir URL ni yuklab oling; mazmun indeksi haqiqatda qaytarilgan bitta chiqishni belgilaydi.

Asl javobni tekshirish kerak bo‘lsa

Belgilangan deklaratsiyada yakuniy xato holati sanalmagan. Har qanday tanilmagan holat yoki result_pending_check xatosida dastlabki javob/sarlavhalar/id ni saqlang va ayni operatsiyani tekshiring; natijasi noma’lum yaratish so‘rovini hech qachon qayta yubormang.

Javob maydonlari

Maydon	Tur	Ma’nosi
Maydon`id`	Turstring	Ma’nosiQaytarilgan ochiq Ailoot vazifasi yoki operatsiyasi identifikatori.
Maydon`provider_task_id`	Turstring	Ma’nosiOchiq id dan alohida bo‘lgan dastlabki vazifa identifikatori.
Maydon`polling_url`	Turstring	Ma’nosiDastlabki vazifa uchun qaytarilgan Ailoot qidiruv yo‘li.
Maydon`task_id`	Turstring when supplied	Ma’nosiYaratish javobida mavjud dastlabki identifikator.
Maydon`state`	Turstring when supplied	Ma’nosiAsl vazifa holati: belgilangan kutilayotgan holat uchun created, yakunlanish uchun success.
Maydon`err_code`	Turstring when supplied	Ma’nosiVazifa diagnostikasi; saqlangan spetsifikatsiyada xato kodlarining sanab berilgan ro‘yxati e’lon qilinmagan.
Maydon`creations[].url`	Turstring\|string[]	Ma’nosiTanlangan har bir yakunlangan video URL i Ailoot egaligidagi imzolangan URL bilan almashtiriladi.
Maydon`creations[].video.duration`	Turnumber when supplied	Ma’nosiQaytarilgan video davomiyligi; haqiqiy yakunlangan natijani tekshiring.
Maydon`creations[].video.fps`	Turinteger when supplied	Ma’nosiQaytarilgan kadrlar tezligi; o‘zgarmas kadrlar tezligi va’da qilinmaydi.
Maydon`creations[].video.resolution.width`	Turinteger when supplied	Ma’nosiQaytarilgan chiqishning piksellardagi eni.
Maydon`creations[].video.resolution.height`	Turinteger when supplied	Ma’nosiQaytarilgan chiqishning piksellardagi bo‘yi.

Xatolar va keyingi qadamlar

Javob	Shart	Keyingi qadam
Javob400 · `invalid_request_error`	ShartJSON/model yaroqsiz, majburiy satrlar yo‘q yoki bo‘sh yoxud mazmun indeksi yaroqsiz.	Keyingi qadam
Javob401 · `authentication_error`	ShartAiloot API kaliti yaroqsiz.	Keyingi qadam
Javob403 · `permission_error`	ShartAPI kaliti guruhi ushbu media yo‘nalishiga qo‘yilmagan.	Keyingi qadam
Javob404 · `not_found_error`	ShartDastlabki vazifa yoki so‘ralgan chiqish mavjud emas yoxud ayni foydalanuvchi/API kaliti/guruhiga tegishli emas.	Keyingi qadam
Javob502 · `result_pending_check`	ShartDastlabki yuborish yoki holat ma’lumoti to‘liq emas yoxud ularni o‘zaro solishtirib tasdiqlab bo‘lmaydi; dastlabki ID ni saqlang va qayta yubormang.	Keyingi qadam
Javob503 · `result_pending_check`	ShartDastlabki bog‘lanish, yo‘nalish yoki egalik qilinadigan media hali tekshirilmoqda; shu dastlabki operatsiyani tekshirishni davom ettiring.	Keyingi qadam
Javob503 · `server_error`	ShartMedia xizmati yoki dastlabki vazifalar saqlovi mavjud emas.	Keyingi qadam

Taxalluslar

Model taxalluslari

Ailoot Ultra viduq2

Usul yo‘llari taxalluslari

/v1/videos/generations

Chaqirish uchun tegishli ID lar

viduq2

FAQ · Vidu: Q2 Text-to-Video

Qanday kirish ma’lumotlari va natijalar mavjud?: POST /v1/videos · viduq2: text → video
So‘rov qaysi maydonlardan foydalanadi?: POST /v1/videos · viduq2: model, prompt, duration, seed, aspect_ratio, resolution, style, movement_amplitude
Qanday cheklovlar amal qiladi?: POST /v1/videos · viduq2: duration.minimum: 1; duration.maximum: 10

Vidu: Q2 Text-to-Video