HeyGen: HeyGen Video
HeyGen Video matn, birinchi rasm yoki vizual va audio namunalardan dialog, muhit va effektlar bilan 5–15 soniyalik sahnalar yaratadi. Uning umumiy maqsadli heygen-video-1 modeli namuna boshqaruvlari va MP4 chiqish bilan mahsulot va qahramon kadrlarini qo‘llab-quvvatlaydi. Aniq, chegaralangan harakatlar unga foydali ishlab chiqarish topshirig‘ini beradi.
Model haqida
Bu tavsif model imkoniyatlarini yoritadi. Ailoot da tanlangan usul uchun mavjud kirish, chiqish va parametrlar quyida keltirilgan.
HeyGen Video — ishlab chiqaruvchi heygen-video-1 deb belgilagan HeyGen ning umumiy maqsadli sahna yaratish modeli. U ijodiy topshiriqdan obyekt, joy, yorug‘lik va tovushni birga yaratadi. Har bir klip 5–15 soniya bo‘lib, dialog, muhit va effektlarni o‘z ichiga olgan yaratilgan audio yo‘liga ega. Foydali ishlab chiqarish kirishlari sahna tavsifi, mahsulot fotosi yoki shaxs, joy yoxud harakatni belgilovchi materialni o‘z ichiga oladi. Natijadagi material mahsulot taqdimoti, tanishtirish lavhasi, ko‘chmas mulk ko‘rinishi yoki boshqa montaj ishi uchun qisqa sahnadir.
Uch rejim kirishlarga turli rol beradi. Matndan video ko‘rsatmadan sahna yaratadi. Rasmdan video aynan berilgan rasmdan boshlanib, keyin harakat topshirig‘iga ergashadi. Namunalardan video yangi tuzilgan sahnani yo‘naltirish uchun berilgan rasm, video va ixtiyoriy audiodan foydalanadi; kamida bitta namuna rasm yoki video talab qiladi. Ochilish kompozitsiyasi statik rasmga mos bo‘lishi kerak bo‘lsa birinchi kadr rasmini, taniqli buyum boshqa kompozitsiyada paydo bo‘lishi kerak bo‘lsa namunalarni tanlang. Bu sahna modeli HeyGen ning avatar render dvigatellari va Video Agent kompozitsiya jarayonidan alohida.
Yaratuvchi qo‘llanmasi batafsil, aniq kadr yo‘riqlarini afzal ko‘radi: bitta obyekt, bitta joy va bitta chegaralangan harakat, mahkamlangan yoki yengil harakatlanuvchi kamera bilan. Kamera joyi, obyektiv yoki fokus chuqurligi niyati, yorug‘lik, sirt teksturasi va rang ishlovini tasvirlang. Harakat kontaktga bog‘liq bo‘lsa, buyumlar qayerda tegishini tushuntiring. Asl mahsulot misolida sayohat termosi fotosini namuna qiling va termos yog‘och peshtaxtada turganda yonida taqdimotchi gapirishini, kamera termosga ozgina yaqinlashishini so‘rang. Natijada termos shakli, joylashuvi va ko‘rinadigan belgilarini tekshiring.
Namuna ro‘yxatlari to‘qqiztagacha rasm, uchta video va uchta audio elementni, jami ko‘pi bilan o‘n ikki namunani qo‘llab-quvvatlaydi. Ishlab chiqaruvchi ko‘rsatma formatida rasm, video va audio alohida raqamlanadi: birinchi rasm <Picture 1>, birinchi video <Video 1>. Har bir namunaga rol bering va topshiriqda uni aniq belgilang. Model har bir namuna videoning dastlabki besh soniyasini o‘qiydi, shuning uchun tegishli qismni boshiga tayyorlang. API ma’lumotnomasi namuna video nisbatlarini 1:4 bilan 4:1 orasida ham belgilaydi. Kerakli harakat faqat oxirida bo‘lgan uzun klip shu besh soniyalik kirish oynasi uchun yomon tayyorgarlikdir.
Hujjatlashtirilgan namuna interfeysi bevosita ochiladigan HTTPS resurs, yuklangan material identifikatori yoki matn ichidagi base64 ni qabul qiladi. Qo‘llanma rasmlar uchun URL orqali eng katta 16 MB, ichkarida 5 MB ni sanaydi; video yoki audio URL orqali 32 MB gacha va ichkarida 16 MB gacha bo‘lishi mumkin. Muhim obyekt oson farqlanadigan va turli namunalarda raqobatlashuvchi yo‘riqlar yo‘q ravshan manba materialini tayyorlang. Birinchi kadr rasmida kerakli yo‘nalishni saqlang. Bu kirish tafsilotlari yaratuvchining namuna jarayoniga tegishli va tanlangan rejim uchun ijodiy materiallarni tashkil qilishga yordam beradi.
Tovushni tasvir bilan bir topshiriqda boshqaring. Dialog, ovoz ijrosi, xona shovqini va aniq effektlarni, jumladan tovush yaqinmi yoki uzoqmi, ayting. Sahna faqat nutq va muhitdan iborat bo‘lishi kerak bo‘lsa, kerakli musiqa ishlovini belgilang. Qo‘llanma rejalash taxmini sifatida soniyasiga taxminan 2.5 ta aytiladigan so‘zga joy ajratishni maslahat beradi; pauza va ko‘rinadigan harakatga ham joy qoldiring. Qisqa kirishni bitta gapdan keyin mahsulotni ochuvchi lahza sifatida rejalash mumkin. Haqiqiy so‘zlar hamda yaratilgan tovush joy va harakatga mosligini tinglang.
Chiqish davomiyligi beshdan o‘n beshgacha butun soniyalarda tanlanadi; standart besh soniya. Aniqlik o‘lcham sinfidir: 480p, 768p, 1080p yoki 2k. Hujjatlashtirilgan kadr tanlovlari 21:9, 16:9, 4:3, 1:1, 3:4 va 9:16. 1080p yoki 2k da matndan va namunalardan video uchun 16:9 yoki 9:16 ni tanlang; moslashuvchan namuna kadr tuzilishi 480p va 768p da hujjatlashtirilgan. Rasmdan video birinchi rasm nisbatiga ergashadi, shuning uchun kerakli shakl o‘zgarsa yaratishdan oldin qirqing. O‘lcham sinfi yorlig‘i bitta odatiy piksel juftini anglatadi deb taxmin qilmay, tugallangan natijaning haqiqiy o‘lchamlarini tekshiring.
Model qo‘llanmasi H.264 tasvir kodlashi va 32 kHz stereo AAC audio bilan MP4 videoni belgilaydi. Yaratish asinxron qayta ishlanadi; tugallangan vazifa ijro etiladigan video manzili, davomiylik va o‘lchamlarni beradi. Vazifani qayta olish orqali imzolangan video manzilini yangilash mumkin. Montaj tekshiruvi uchun haqiqiy klip, namuna materiallari va topshiriqni saqlang. Kutilayotgan yoki ishlanayotgan qayd yaratishni kuzatadi; tugallangan video esa tasvir, nutq va tovush bo‘yicha baholanadigan ishlab chiqarish artefakti.
Ishlab chiqaruvchi ko‘rsatmani yaxshilash tanlovlari sifatida turbo, quality va disabled ni hujjatlashtiradi; disabled tayyor so‘zlarni yozilganicha saqlaydi. Boshqa kirishlarni saqlab, bitta iboradagi o‘zgarishni solishtirganda qat’iy seed foydali. Tanlangan seed va sozlamalarni kadr topshirig‘i bilan qayd eting. Ekrandagi yozuvda kerakli iborani qisqa tuting va aniq yozing; qo‘llanma abzaslar, mayda yozuvlar va yorliqli diagrammalarni keyin kompoziting qilishni tavsiya qiladi. So‘zlar to‘g‘ri takrorlangan deb taxmin qilmay, yaratilgan sarlavhadagi har bir ko‘rinadigan belgini tekshiring.
Qo‘llanma uzun ekran matni, gulbarg, qog‘oz yoki soch kabi yumshoq organik harakat va qo‘lning yaqin ishlashini kamroq ishonchli sohalar sifatida belgilaydi. Jarayon tushuntirishida tasvir barqaror odam yoki buyumni ko‘rsatib tursin, qadamlarni esa aniq yozilgan gap yetkazsin; jismoniy amalning o‘zi aniq bo‘lishi kerak bo‘lsa, alohida tekshirilgan tasvirlardan foydalaning. Butun kadrni buyum ko‘rinishining izchilligi, kontakt, yuz va qo‘l detallari, dialog hamda tovush bo‘yicha tekshiring. Keyingi dublda nima o‘zgarishi kerakligining qisqa ro‘yxati batafsil ishlab chiqarish topshirig‘ini amaliy saqlaydi.
Ailoot Ultra · Video POST /v1/videos heygen/heygen-video-1
heygen/heygen-video-1Boshlash
HeyGen Video matn, birinchi rasm yoki vizual va audio namunalardan dialog, muhit va effektlar bilan 5–15 soniyalik sahnalar yaratadi. Uning umumiy maqsadli heygen-video-1 modeli namuna boshqaruvlari va MP4 chiqish bilan mahsulot va qahramon kadrlarini qo‘llab-quvvatlaydi. Aniq, chegaralangan harakatlar unga foydali ishlab chiqarish topshirig‘ini beradi.
- Qabul qilinadigan kirish ma’lumotlari
- Matn · Rasmlar · Audio · Video
- Natijalar
- Video
Ailoot da mavjud · kirish ma’lumotlari va usullar
Ailoot Ultra · Video POST /v1/videos
- Kirish
text,image,audio,video- Chiqish
video- Chiqish formati
- asl MP4 baytlari; normallashtirishsiz/qayta kodlashsiz
| Maydon | Tur | Talab | Qiymatlar va cheklovlar | Standart |
|---|---|---|---|---|
Maydonmodel | Turstring | TalabMajburiy | Qiymatlar va cheklovlar heygen/heygen-video-1 | Standart— |
Maydonprompt | Turstring | TalabMajburiy | Qiymatlar va cheklovlar | Standart— |
Maydonduration | Turinteger | TalabMajburiy | Qiymatlar va cheklovlar 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 Eng kam: 1 Eng ko‘p: 600 | Standart— |
Maydonresolution | Turstring | TalabIxtiyoriy | Qiymatlar va cheklovlar 480p, 768p, 2K | Standart— |
Maydonaspect_ratio | Turstring | TalabIxtiyoriy | Qiymatlar va cheklovlar 21:9, 16:9, 4:3, 1:1, 3:4, 9:16 | Standart— |
Maydongenerate_audio | Turboolean | TalabIxtiyoriy | Qiymatlar va cheklovlar false | Standart— |
Maydonframe_images | Turarray | TalabIxtiyoriy | Qiymatlar va cheklovlar Elementlarning eng kam soni: 1 Elementlarning eng ko‘p soni: 1 Kirish kontenti: Kadr obyektlari massivi. Har bir obyektda type=image_url, url saqlovchi image_url va frame_type mavjud. HTTPS rasm URL idan foydalaning va frame_type qiymatini first_frame qilib belgilang. Har bir kadr vazifasi ko‘pi bilan bir marta uchraydi. Aniq kalitlar: type, image_url, frame_type Shartlar: Bu kalitlar har bir kadr obyektini tavsiflaydi; image_url faqat url ni saqlaydi. Faqat matnli so‘rov uchun frame_images ni yubormang. | Standart— |
Maydoninput_references | Turarray | TalabIxtiyoriy | Qiymatlar va cheklovlar | Standart— |
Maydonseed | Turinteger | TalabIxtiyoriy | Qiymatlar va cheklovlar Eng kam: -9 223 372 036 854 775 808 Eng ko‘p: 9 223 372 036 854 775 807 | Standart— |
Maydoncallback_url | Turstring | TalabIxtiyoriy | Qiymatlar va cheklovlar Andoza: ^https:// | Standart— |
Maydonsession_id | Turstring | TalabIxtiyoriy | Qiymatlar va cheklovlar | Standart— |
Maydontrace | Turobject | TalabIxtiyoriy | Qiymatlar va cheklovlar | Standart— |
Maydonuser | Turstring | TalabIxtiyoriy | Qiymatlar va cheklovlar | Standart— |
Kirish materiallari birikmalari
Matndan video · Yozma ko‘rsatma. · Majburiy: model, prompt, duration
prompt ni matn, duration ni butun soniyalarda bering. Qo‘llab-quvvatlanadigan aniqlikni va, zarur bo‘lsa, tomonlar nisbatini tanlang.
model: Turi: string · heygen/heygen-video-1
prompt: Turi: string · UTF-8 baytlarining eng ko‘p soni: 10 000 · Bo‘shliq belgisi bo‘lmagan kamida bitta belgi talab qilinadi: Ha
Rasmdan video · Yozma ko‘rsatma va birinchi kadr rasmi. · Majburiy: model, prompt, duration, frame_images
frame_images — massiv. Har bir kadr obyektida type, image_url va frame_type mavjud; image_url ichida url bo‘ladi. type qiymatini image_url qilib belgilang. first_frame dan foydalaning. Har bir kadr vazifasi ko‘pi bilan bir marta uchraydi. Har bir kadr uchun ochiq HTTPS rasm URL ini bering. Qo‘llab-quvvatlanadigan aniqlikni va, zarur bo‘lsa, tomonlar nisbatini tanlang.
Aniq kalitlar: type, image_url, frame_type
model: Turi: string · heygen/heygen-video-1
prompt: Turi: string · UTF-8 baytlarining eng ko‘p soni: 10 000 · Bo‘shliq belgisi bo‘lmagan kamida bitta belgi talab qilinadi: Ha
Reference to video · Yozma ko‘rsatma va qo‘llab-quvvatlanadigan rasm, video, audio referenslar. · Majburiy: model, prompt, duration, input_references
input_references — obyektlar massivi. type qiymatini image_url, video_url, audio_url qilib belgilang va url saqlovchi mos maydondan foydalaning. Ochiq HTTPS URL laridan foydalaning. Referens rejimini tanlash uchun frame_images ni yubormang. Qo‘llab-quvvatlanadigan aniqlikni va, zarur bo‘lsa, tomonlar nisbatini tanlang.
model: Turi: string · heygen/heygen-video-1
prompt: Turi: string · UTF-8 baytlarining eng ko‘p soni: 10 000 · Bo‘shliq belgisi bo‘lmagan kamida bitta belgi talab qilinadi: Ha
Usul parametrlari va hayot sikli
| Parametr | Parametr talablari |
|---|---|
Parametrcontent_type | Parametr talablariapplication/json |
Parametrrequired | Parametr talablarimodel, prompt, duration |
Parametrmaterial_types | Parametr talablaritext, image, audio, video |
Parametradditional_properties | Parametr talablarifalse |
Parametroptional_controls | Parametr talablariresolution, aspect_ratio, generate_audio, frame_images, input_references, seed, callback_url, session_id, trace, user |
Hayot sikli: submit_once_poll_original
GET /v1/videos/{public_id}
GET /v1/videos/{public_id}/content
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 | Hisob birligi | To‘lovni hisoblash shartlari | To‘lov |
|---|---|---|---|---|---|
| SozlamaTokenlar uchun bazaviy tariflar | Tariflar jadvaliAsosiy tarif | Prognoz miqdori— | Hisob birligi— | To‘lovni hisoblash shartlari— | 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 |
| SozlamaVideo narxi | Tariflar jadvali— | Prognoz miqdori— | Hisob birligivideo soniyasi uchun | To‘lovni hisoblash shartlariresolution: 2k | To‘lov Chiqish · Video narxi · Faqat taqqoslash uchun taxmin $0.2 video soniyasi uchun |
| SozlamaVideo narxi | Tariflar jadvali— | Prognoz miqdori— | Hisob birligivideo soniyasi uchun | To‘lovni hisoblash shartlariresolution: 480p | To‘lov Chiqish · Video narxi · Faqat taqqoslash uchun taxmin $0.04 video soniyasi uchun |
| SozlamaVideo narxi | Tariflar jadvali— | Prognoz miqdori— | Hisob birligivideo soniyasi uchun | To‘lovni hisoblash shartlariresolution: 768p | To‘lov Chiqish · Video narxi · Faqat taqqoslash uchun taxmin $0.072 video soniyasi uchun |
| SozlamaVideo narxi | Tariflar jadvali— | Prognoz miqdori— | Hisob birligivideo soniyasi uchun | To‘lovni hisoblash shartlariyaratish rejimi: reference; aniqlik: 2k | To‘lov Chiqish · Video narxi · Faqat taqqoslash uchun taxmin $0.36 video soniyasi uchun |
| SozlamaVideo narxi | Tariflar jadvali— | Prognoz miqdori— | Hisob birligivideo soniyasi uchun | To‘lovni hisoblash shartlariyaratish rejimi: reference; aniqlik: 480p | To‘lov Chiqish · Video narxi · Faqat taqqoslash uchun taxmin $0.14 video soniyasi uchun |
| SozlamaVideo narxi | Tariflar jadvali— | Prognoz miqdori— | Hisob birligivideo soniyasi uchun | To‘lovni hisoblash shartlariyaratish rejimi: reference; aniqlik: 768p | To‘lov Chiqish · Video narxi · Faqat taqqoslash uchun taxmin $0.2 video soniyasi uchun |
| Sozlamakirish referens rasmi | Tariflar jadvali— | Prognoz miqdori— | Hisob birliginamuna kirish rasmi uchun | To‘lovni hisoblash shartlari— | To‘lov Kirish · kirish referens rasmi · Faqat taqqoslash uchun taxmin $0.08 namuna kirish rasmi uchun |
| SozlamaYaratishning taxminiy qiymati | Tariflar jadvali— | Prognoz miqdoribir generatsiya uchun taxmin | Hisob birligi— | To‘lovni hisoblash shartlari— | To‘lov Chiqish · Yaratishning taxminiy narxi · Faqat taqqoslash uchun taxmin $0.2 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 →
Ma’lumot uchun tarif tafsilotlari
Modelning ma’lumot jadvallari usul tanlash, narx hisobi yoki to‘lovlarni o‘zgartirmaydi. Amaldagi to‘lovlar tanlangan Ailoot usuli tariflari bo‘yicha hisoblanadi.
Video sozlamalari narxiga havolalar
Sozlamalar bo‘yicha narxlar
Har bir to‘lovni ko‘rsatilgan shartlarga moslang. Har bir muqobil sozlamalar to‘plami uchun bitta tarifdan foydalaning.
| Sozlama | To‘lovni hisoblash shartlari | To‘lov |
|---|---|---|
| SozlamaVideo narxi | To‘lovni hisoblash shartlariresolution: 2k | To‘lov Chiqish · Video narxi $0.18 video soniyasi uchun Ko‘rsatilgan konfiguratsiya uchun e’lon qilingan narx ma’lumoti. Yakuniy to‘lovlar haq undirishda amalda qo‘llangan konfiguratsiya asosida hisoblanadi. |
| SozlamaVideo narxi | To‘lovni hisoblash shartlariresolution: 480p | To‘lov Chiqish · Video narxi $0.04 video soniyasi uchun Ko‘rsatilgan konfiguratsiya uchun e’lon qilingan narx ma’lumoti. Yakuniy to‘lovlar haq undirishda amalda qo‘llangan konfiguratsiya asosida hisoblanadi. |
| SozlamaVideo narxi | To‘lovni hisoblash shartlariresolution: 768p | To‘lov Chiqish · Video narxi $0.06 video soniyasi uchun Ko‘rsatilgan konfiguratsiya uchun e’lon qilingan narx ma’lumoti. Yakuniy to‘lovlar haq undirishda amalda qo‘llangan konfiguratsiya asosida hisoblanadi. |
| SozlamaVideo narxi | To‘lovni hisoblash shartlariyaratish rejimi: reference; aniqlik: 2k | To‘lov Chiqish · Video narxi $0.36 video soniyasi uchun Ko‘rsatilgan konfiguratsiya uchun e’lon qilingan narx ma’lumoti. Yakuniy to‘lovlar haq undirishda amalda qo‘llangan konfiguratsiya asosida hisoblanadi. |
| SozlamaVideo narxi | To‘lovni hisoblash shartlariyaratish rejimi: reference; aniqlik: 480p | To‘lov Chiqish · Video narxi $0.08 video soniyasi uchun Ko‘rsatilgan konfiguratsiya uchun e’lon qilingan narx ma’lumoti. Yakuniy to‘lovlar haq undirishda amalda qo‘llangan konfiguratsiya asosida hisoblanadi. |
| SozlamaVideo narxi | To‘lovni hisoblash shartlariyaratish rejimi: reference; aniqlik: 768p | To‘lov Chiqish · Video narxi $0.12 video soniyasi uchun Ko‘rsatilgan konfiguratsiya uchun e’lon qilingan narx ma’lumoti. Yakuniy to‘lovlar haq undirishda amalda qo‘llangan konfiguratsiya asosida hisoblanadi. |
So‘rov namunalari
Ailoot Ultra · Video
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_REQUEST'
from pathlib import Path
Path('request.json').write_text('{"aspect_ratio":"16:9","duration":8,"model":"heygen/heygen-video-1","prompt":"A serene mountain landscape at sunset","resolution":"480p"}', encoding='utf-8')
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
python3 - <<'PY_RESULT'
import json
from pathlib import Path
r=json.loads(Path('result.json').read_text())
print(json.dumps(r,ensure_ascii=False,indent=2))
print('Keep the complete JSON and response headers; do not resubmit an unknown creation.')
PY_RESULT
Natijalarni olish va saqlash
Ailoot Ultra · Video
egalik qilinadigan mazmunning imzolangan URL lari
GET /v1/videos/{public_id}GET /v1/videos/{public_id}/content
Vazifa holatini tekshirish
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_STATUS_URL'
import json
from pathlib import Path
from urllib.parse import quote
r=json.loads(Path('result.json').read_text())
if not isinstance(r.get('id'),str) or not r['id']:raise SystemExit('Keep the original response and headers for reconciliation; no returned ID')
Path('status-url.txt').write_text('https://api.ailoot.ai/v1/videos/'+quote(r['id'],safe=''))
PY_STATUS_URL
curl --fail-with-body --silent --show-error "$(cat status-url.txt)" \
-H "Authorization: Bearer $AILOOT_API_KEY" -D status-headers.txt -o status.json
python3 - <<'PY_RESULT'
import json
from pathlib import Path
r=json.loads(Path('status.json').read_text())
print(json.dumps(r,ensure_ascii=False,indent=2))
print('Keep the complete JSON and response headers; do not resubmit an unknown creation.')
PY_RESULT
Boshqa kontentni o‘qish
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())
if r.get('status')!='completed':raise SystemExit('Keep the original ID and read its status; never recreate an unknown job')
if not isinstance(r.get('data'),list) or not r['data']:raise SystemExit('Keep the complete original status; no completed outputs supplied')
urls=[]
for i,u in enumerate(r.get('data',[])):
if not isinstance(u,str):raise SystemExit('Keep the original response; unexpected asset shape')
urls.append((str(i),u))
for label,path in urls:
u=urljoin('https://api.ailoot.ai',path);z=urlsplit(u)
if z.scheme!='https' or z.netloc!='api.ailoot.ai' or z.username or z.password:raise SystemExit('Use the actual returned Ailoot owned content URL')
target=Path('owned-'+label+'.bin')
subprocess.run(['curl','--fail-with-body','--silent','--show-error',u,'-H','Authorization: Bearer '+os.environ['AILOOT_API_KEY'],'-D',str(target)+'.headers','-o',str(target)],check=True)
print('All returned owned URLs saved; complete metadata, timing and usage remain in the JSON.')
PY_ASSETS
Barcha tayyor natijalarni saqlash
Har bir tayyor video yoki qaytarilgan faylni saqlang; har bir haqiqatan qaytarilgan material URL dan kontentni oling.
Egalik qilinadigan har bir haqiqiy chiqish natijasini va u bilan qaytarilgan o‘lchangan metama’lumotlarni saqlang.
Asl javobni tekshirish kerak bo‘lsa
503 result_pending_check + dastlabki id + X-Should-Retry:false; dastlabki so‘rovni hech qachon qayta yubormang
Javob maydonlari
| Maydon | Tur | Ma’nosi |
|---|---|---|
Maydonindex | Turinteger | Ma’nosiUshbu videoning chiqishlar ro‘yxatidagi noldan boshlanuvchi o‘rni. |
Maydoncontent_url | Turstring | Ma’nosiUshbu yakunlangan video uchun imzolangan HTTPS yuklab olish URL i. |
Maydonsha256 | Turstring | null | Ma’nosiDastlabki video baytlarining SHA-256 xeshi; mavjud bo‘lmasa null. |
Maydonsize_bytes | Turinteger | null | Ma’nosiDastlabki video faylining baytlardagi hajmi; mavjud bo‘lmasa null. |
Maydonduration_ms | Turinteger | null | Ma’nosiVideoning millisoniyalarda o‘lchangan davomiyligi; mavjud bo‘lmasa null. |
Maydonwidth | Turinteger | null | Ma’nosiVideoning piksellardagi eni; mavjud bo‘lmasa null. |
Maydonheight | Turinteger | null | Ma’nosiVideoning piksellardagi bo‘yi; mavjud bo‘lmasa null. |
Maydonvideo_codec | Turstring | null | Ma’nosiVideo kodeki identifikatori; qayd etilmagan bo‘lsa null. |
Maydonhas_audio | Turboolean | null | Ma’nosiVideoda audio yo‘lak bor-yo‘qligi; o‘lchanmagan bo‘lsa null. |
Maydonaudio_codec | Turstring | null | Ma’nosiAudio kodeki identifikatori; identifikator qayd etilmagan bo‘lsa null. |
Xatolar va keyingi qadamlar
| Javob | Shart | Keyingi qadam |
|---|---|---|
Javob404 · not_found_error | ShartVideoga kirish mavjud emas yoki ushbu video ID si topilmadi. | Keyingi qadamVideoga kirishni tekshiring. Mavjud video uchun uning dastlabki ochiq ID si va ayni API kalitidan foydalaning. |
Javob401 · authentication_error | ShartAPI kaliti autentifikatsiyadan o‘tgan hisobga mos kelmaydi. | Keyingi qadamYuborishdan oldin API kalitingiz va hisobga kirishingizni tekshiring. |
Javob400 · invalid_request_error | ShartSo‘rovni o‘qib bo‘lmadi yoki yuklab olish indeksi yaroqsiz. | Keyingi qadamSo‘rov tanasini tuzating. Yuklab olish uchun dastlabki vazifa qaytargan chiqish indeksini tanlang. |
Javob422 · price_unavailable | ShartTanlangan video sozlamasining narxini hisoblab bo‘lmaydi. | Keyingi qadamTuzatilgan so‘rovni yuborishdan oldin qo‘llab-quvvatlanadigan video sozlamasini tanlang va uning majburiy parametrlarini to‘ldiring. |
Javob422 · invalid_request_error | ShartVideo kirishi yoki dastlabki davom ettirish vazifasi yaroqsiz. | Keyingi qadamYaroqli HTTPS kirishlaridan foydalaning. Davom ettirish uchun yakunlangan dastlabki videongizning ochiq ID si va ayni API kalitidan foydalaning. |
Javob402 · billing_error | ShartMavjud balans yoki limitlar mablag‘ni band qilishga imkon bermaydi. | Keyingi qadamYangi so‘rov yuborishdan oldin mavjud balans va limitlaringizni tekshiring. |
Javob503 · server_error | ShartVideoni tekshirish, saqlash yoki xizmatga kirish vaqtincha mavjud emas. | Keyingi qadamXizmat mavjud bo‘lishini kuting. Video ID si allaqachon bo‘lsa, boshqa yaratishni boshlash o‘rniga shu dastlabki vazifani tekshiring. |
Javob503 · result_pending_check | ShartDastlabki video natijasi va to‘lovni tekshirish kerak. | Keyingi qadamQaytarilgan video ID sini saqlang va shu vazifani tekshiring. U tekshirilayotgan paytda o‘rniga boshqa yaratish so‘rovini yubormang. |
Javob503 · owned_result_unavailable | ShartMavjud videoni yuklab olish vaqtincha ishlamayapti. | Keyingi qadamKeyinroq ayni video vazifasini tekshiring va uning mavjud chiqishini yuklab oling. Yangi yaratish alohida operatsiya hosil qiladi. |
Javob409 · video_not_ready | ShartVideo mazmuni e’lon qilinmagan. | Keyingi qadamDastlabki vazifa holatini tekshiring. completed bildirgach yuklab oling; failed bildirsa, uning to‘lovni tekshirish bildirishnomasiga rioya qiling. |
Taxalluslar
Model taxalluslari
Ailoot Ultra heygen/heygen-video-1
Usul yo‘llari taxalluslari
Yuqorida ko‘rsatilgan usul yo‘llaridan foydalaning.
Chaqirish uchun tegishli ID lar
FAQ · HeyGen: HeyGen Video
- Qanday kirish ma’lumotlari va natijalar mavjud?
POST /v1/videos·heygen/heygen-video-1:text,image,audio,video→video- So‘rov qaysi maydonlardan foydalanadi?
POST /v1/videos·heygen/heygen-video-1:model,prompt,duration,resolution,aspect_ratio,generate_audio,frame_images,input_references,seed,callback_url,session_id,trace,user- Qanday cheklovlar amal qiladi?
POST /v1/videos·heygen/heygen-video-1:duration.minimum:1;duration.maximum:600;frame_images.max_items:1;frame_images.min_items:1;seed.minimum:-9223372036854775808;seed.maximum:9223372036854775807