HeyGen: HeyGen Video
HeyGen Video iš teksto, pirmojo vaizdo arba vaizdo ir garso orientyrų generuoja 5–15 sekundžių scenas su dialogu, aplinkos garsais ir efektais. Jo bendros paskirties heygen-video-1 modelis palaiko produktų bei personažų planus, orientyrų valdiklius ir MP4 išvestį. Aiškūs, apibrėžti veiksmai suteikia jam naudingą gamybos užduotį.
Apie modelį
Šis aprašas apima modelio galimybes. Pasirinktam metodui Ailoot prieinamos įvestys, išvestys ir parinktys nurodytos toliau.
HeyGen Video yra HeyGen bendros paskirties scenų generavimo modelis, gamintojo identifikuojamas kaip heygen-video-1. Pagal kūrybinę užduotį jis kartu kuria objektą, aplinką, šviesą ir garsą. Kiekvienas klipas trunka 5–15 sekundžių ir turi sugeneruotą garso takelį, įskaitant dialogą, aplinkos garsus bei efektus. Naudinga gamybos įvestis apima scenos aprašymą, produkto nuotrauką arba medžiagą, nustatančią žmogų, vietą ar judesį. Gautas failas yra trumpa scena produkto pristatymui, įvadiniam intarpui, nekilnojamojo turto vaizdui ar kitam montuojamam vaizdo darbui.
Trys režimai suteikia įvestims skirtingus vaidmenis. Kūrimas iš teksto kuria sceną pagal užklausą. Kūrimas iš vaizdo prasideda tiksliai pateiktu vaizdu, tada vykdo veiksmo užduotį. Kūrimas iš orientyrų naudoja pateiktus vaizdus, vaizdo įrašus ir pasirenkamą garsą naujai komponuojamai scenai nukreipti; jam reikia bent vieno orientyrinio vaizdo arba vaizdo įrašo. Pirmojo kadro vaizdą rinkitės tada, kai pradžios kompozicija turi sutapti su nuotrauka, o orientyrus – kai žinomas daiktas turi atsirasti kitoje kompozicijoje. Šis scenų modelis skiriasi nuo HeyGen avatarų atvaizdavimo variklių ir Video Agent kompozicijos eigos.
Gamintojo vadovas teikia pirmenybę išsamiems, konkretiems plano nurodymams: vienas objektas, viena vieta ir vienas apibrėžtas veiksmas, naudojant fiksuotą arba švelniai judančią kamerą. Aprašykite kameros padėtį, objektyvo arba ryškumo gylio sumanymą, šviesą, paviršiaus tekstūrą ir spalvų stilistiką. Paaiškinkite, kur objektai liečiasi, kai veiksmas priklauso nuo sąlyčio. Originaliam produkto pavyzdžiui naudokite orientyrinę kelioninio termoso nuotrauką ir paprašykite, kad jis stovėtų ant medinio stalviršio, šalia kalbant pristatytojui, kamerai truputį artėjant prie termoso. Rezultate patikrinkite termoso formą, vietą ir matomą žymėjimą.
Orientyrų sąrašai palaiko iki devynių vaizdų, trijų vaizdo įrašų ir trijų garso elementų, iš viso daugiausia dvylika orientyrų. Vaizdai, vaizdo įrašai ir garsas gamintojo užklausos formate numeruojami atskirai: pirmas vaizdas yra <Picture 1>, o pirmas vaizdo įrašas – <Video 1>. Kiekvienam orientyrui suteikite vaidmenį ir jį aiškiai įvardykite užduotyje. Modelis skaito pirmąsias penkias kiekvieno orientyrinio vaizdo įrašo sekundes, todėl svarbią atkarpą paruoškite pradžioje. API žinynas taip pat nurodo orientyrinio vaizdo proporcijas nuo 1:4 iki 4:1. Ilgas klipas, kuriame norimas judesys yra tik pabaigoje, netinka šiam penkių sekundžių įvesties langui.
Dokumentuota orientyrų sąsaja priima tiesiogiai pasiekiamą HTTPS išteklių, įkelto failo identifikatorių arba įterptą base64. Vadove nurodyti maksimalūs vaizdų dydžiai: 16 MB pateikiant URL ir 5 MB įterpiant; vaizdo arba garso failai gali būti iki 32 MB per URL ir 16 MB įterpti. Paruoškite aiškią pradinę medžiagą, kurioje svarbus objektas lengvai atskiriamas, o skirtingi orientyrai nepateikia konkuruojančių nurodymų. Pirmojo kadro vaizde išlaikykite norimą orientaciją. Šios įvesties detalės taikomos gamintojo orientyrų eigai ir padeda sutvarkyti kūrybinę medžiagą pasirinktam režimui.
Garsą režisuokite toje pačioje užduotyje kaip vaizdą. Nurodykite dialogą, balso atlikimą, patalpos foną ir konkrečius efektus, įskaitant tai, ar garsas turi skambėti arti, ar toli. Jei scenoje turi būti tik kalba ir aplinkos garsai, aprašykite norimą muzikos naudojimą. Vadovas siūlo planuojant skaičiuoti maždaug 2,5 tariamo žodžio per sekundę, todėl palikite laiko pauzėms ir matomam veiksmui. Trumpą įžangą galima suplanuoti kaip vieną repliką, po kurios seka produkto atskleidimo akimirka. Klausykite tikrųjų žodžių ir ar sugeneruotas garsas dera prie erdvės bei veiksmo.
Rezultato trukmė pasirenkama sveikomis sekundėmis nuo penkių iki penkiolikos, numatytoji – penkios sekundės. Raiška yra dydžio klasė: 480p, 768p, 1080p arba 2k. Dokumentuoti kadravimo variantai yra 21:9, 16:9, 4:3, 1:1, 3:4 ir 9:16. Kuriant iš teksto arba orientyrų 1080p ar 2k raiška, rinkitės 16:9 arba 9:16; prisitaikantis orientyrų kadravimas dokumentuotas 480p ir 768p raiškoms. Kūrimas iš vaizdo seka pirmojo vaizdo proporcijas, todėl apkirpkite prieš generavimą, kai reikia kitos formos. Peržiūrėkite tikruosius užbaigto rezultato matmenis, užuot manę, kad dydžio klasės žyma reiškia vieną įprastą pikselių porą.
Modelio vadovas nurodo MP4 vaizdą su H.264 vaizdo kodavimu ir AAC 32 kHz stereogarsu. Generavimas apdorojamas asinchroniškai, o užbaigta užduotis pateikia paleidžiamo vaizdo vietą, trukmę bei matmenis. Pasirašytą vaizdo vietą galima atnaujinti dar kartą gaunant užduotį. Išsaugokite patį klipą, orientyrinę medžiagą ir užduotį montažo peržiūrai. Laukimo ar apdorojimo įrašas seka generavimą; užbaigtas vaizdo įrašas yra gamybos rezultatas, kurio vaizdą, kalbą ir garsą reikia įvertinti.
Gamintojas dokumentuoja užklausos pagerinimo pasirinkimus turbo, quality ir disabled; disabled išlaiko paruoštą formuluotę tokią, kokia parašyta. Fiksuotas pradinis atsitiktinumo skaičius naudingas lyginant vienos frazės pakeitimą, išlaikant kitas įvestis. Pasirinktą skaičių ir nustatymus įrašykite su plano užduotimi. Ekrano užrašams norimą frazę laikykite trumpą ir parašykite tiksliai; vadovas rekomenduoja pastraipas, smulkų tekstą ir pažymėtas diagramas įkomponuoti vėliau. Sugeneruotame pavadinime patikrinkite kiekvieną matomą simbolį, užuot manę, kad tekstas atkartotas teisingai.
Vadovas kaip mažiau patikimas sritis įvardija ilgą ekrano tekstą, švelnų organinį judėjimą, pavyzdžiui, žiedlapių, popieriaus ar plaukų, ir smulkius rankų veiksmus iš arti. Procedūriniam paaiškinimui leiskite aiškiai parašytai replikai perteikti žingsnius, o vaizde rodykite stabilų žmogų arba daiktą; kai pats fizinis veiksmas turi būti tikslus, naudokite atskirai patikrintus vaizdus. Peržiūrėkite visą planą pagal daikto vientisumą, sąlytį, veido bei rankų detales, dialogą ir garsą. Trumpas sąrašas to, ką keisti kitame bandyme, išlaiko išsamią gamybos užduotį praktišką.
Ailoot Ultra · Vaizdo įrašai POST /v1/videos heygen/heygen-video-1
heygen/heygen-video-1Pradžia
HeyGen Video iš teksto, pirmojo vaizdo arba vaizdo ir garso orientyrų generuoja 5–15 sekundžių scenas su dialogu, aplinkos garsais ir efektais. Jo bendros paskirties heygen-video-1 modelis palaiko produktų bei personažų planus, orientyrų valdiklius ir MP4 išvestį. Aiškūs, apibrėžti veiksmai suteikia jam naudingą gamybos užduotį.
- Leidžiamos įvestys
- Tekstas · Vaizdai · Garsas · Vaizdo įrašai
- Rezultatai
- Vaizdo įrašai
Prieinama Ailoot · įvestys ir metodai
Ailoot Ultra · Vaizdo įrašai POST /v1/videos
- Įvestis
text,image,audio,video- Išvestis
video- Išvesties formatas
- originalūs MP4 baitai; be normalizavimo ar perkodavimo
| Laukas | Tipas | Reikalavimas | Reikšmės ir ribos | Numatyta |
|---|---|---|---|---|
Laukasmodel | Tipasstring | ReikalavimasPrivaloma | Reikšmės ir ribos heygen/heygen-video-1 | Numatyta— |
Laukasprompt | Tipasstring | ReikalavimasPrivaloma | Reikšmės ir ribos | Numatyta— |
Laukasduration | Tipasinteger | ReikalavimasPrivaloma | Reikšmės ir ribos 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 Mažiausia reikšmė: 1 Didžiausia reikšmė: 600 | Numatyta— |
Laukasresolution | Tipasstring | ReikalavimasNeprivaloma | Reikšmės ir ribos 480p, 768p, 2K | Numatyta— |
Laukasaspect_ratio | Tipasstring | ReikalavimasNeprivaloma | Reikšmės ir ribos 21:9, 16:9, 4:3, 1:1, 3:4, 9:16 | Numatyta— |
Laukasgenerate_audio | Tipasboolean | ReikalavimasNeprivaloma | Reikšmės ir ribos false | Numatyta— |
Laukasframe_images | Tipasarray | ReikalavimasNeprivaloma | Reikšmės ir ribos Mažiausias elementų skaičius: 1 Didžiausias elementų skaičius: 1 Įvesties turinys: Kadrų objektų masyvas. Kiekviename objekte yra type=image_url, image_url su url ir frame_type. Naudokite HTTPS paveikslėlio URL ir nustatykite frame_type reikšmę first_frame. Kiekviena kadro paskirtis nurodoma daugiausia vieną kartą. Tikslūs raktai: type, image_url, frame_type Sąlygos: Šie raktai apibūdina kiekvieną kadro objektą; image_url turi tik url. Jei užklausoje yra tik tekstas, praleiskite frame_images. | Numatyta— |
Laukasinput_references | Tipasarray | ReikalavimasNeprivaloma | Reikšmės ir ribos | Numatyta— |
Laukasseed | Tipasinteger | ReikalavimasNeprivaloma | Reikšmės ir ribos Mažiausia reikšmė: −9 223 372 036 854 775 808 Didžiausia reikšmė: 9 223 372 036 854 775 807 | Numatyta— |
Laukascallback_url | Tipasstring | ReikalavimasNeprivaloma | Reikšmės ir ribos Šablonas: ^https:// | Numatyta— |
Laukassession_id | Tipasstring | ReikalavimasNeprivaloma | Reikšmės ir ribos | Numatyta— |
Laukastrace | Tipasobject | ReikalavimasNeprivaloma | Reikšmės ir ribos | Numatyta— |
Laukasuser | Tipasstring | ReikalavimasNeprivaloma | Reikšmės ir ribos | Numatyta— |
Įvesties medžiagos deriniai
Iš teksto į vaizdo įrašą · Tekstinė užklausa. · Privaloma: model, prompt, duration
Pateikite prompt kaip tekstą ir duration sveikomis sekundėmis. Pasirinkite palaikomą skiriamąją gebą ir, jei reikia, kraštinių santykį.
model: Tipas: string · heygen/heygen-video-1
prompt: Tipas: string · Didžiausias UTF-8 baitų skaičius: 10 000 · Būtinas bent vienas simbolis, nepriskiriamas tarpų simboliams: Taip
Iš vaizdo į vaizdo įrašą · Tekstinė užklausa ir pirmojo kadro paveikslėlis. · Privaloma: model, prompt, duration, frame_images
frame_images yra masyvas. Kiekviename kadro objekte yra type, image_url ir frame_type; image_url turi url lauką. Nustatykite type reikšmę image_url. Naudokite first_frame. Kiekviena kadro paskirtis gali būti nurodyta daugiausia vieną kartą. Kiekvienam kadrui pateikite viešą HTTPS paveikslėlio URL. Pasirinkite palaikomą skiriamąją gebą ir, jei reikia, kraštinių santykį.
Tikslūs raktai: type, image_url, frame_type
model: Tipas: string · heygen/heygen-video-1
prompt: Tipas: string · Didžiausias UTF-8 baitų skaičius: 10 000 · Būtinas bent vienas simbolis, nepriskiriamas tarpų simboliams: Taip
Reference to video · Tekstinė užklausa ir palaikoma pavyzdinė medžiaga: paveikslėliai, vaizdo įrašai, garsas. · Privaloma: model, prompt, duration, input_references
input_references yra objektų masyvas. Nustatykite type reikšmę image_url, video_url, audio_url ir naudokite atitinkamą lauką su url. Naudokite viešus HTTPS URL. Kad pasirinktumėte pavyzdinės medžiagos režimą, praleiskite frame_images. Pasirinkite palaikomą skiriamąją gebą ir, jei reikia, kraštinių santykį.
model: Tipas: string · heygen/heygen-video-1
prompt: Tipas: string · Didžiausias UTF-8 baitų skaičius: 10 000 · Būtinas bent vienas simbolis, nepriskiriamas tarpų simboliams: Taip
Metodo parametrai ir gyvavimo ciklas
| Parametras | Specifikacija |
|---|---|
Parametrascontent_type | Specifikacijaapplication/json |
Parametrasrequired | Specifikacijamodel, prompt, duration |
Parametrasmaterial_types | Specifikacijatext, image, audio, video |
Parametrasadditional_properties | Specifikacijafalse |
Parametrasoptional_controls | Specifikacijaresolution, aspect_ratio, generate_audio, frame_images, input_references, seed, callback_url, session_id, trace, user |
Gyvavimo ciklas: submit_once_poll_original
GET /v1/videos/{public_id}
GET /v1/videos/{public_id}/content
Planai
Kaip apskaičiuojamas galutinis mokestis
Rodomi įkainiai leidžia įvertinti kainą prieš generavimą. Galutinė suma apskaičiuojama pagal užfiksuotą pradinio generavimo kainą. Išmatuota rezultato trukmė ir prognozuoti kiekiai nėra galutinis apmokestinamas kiekis.
Tarifų informacija neprideda užklausos parinkčių. Palaikomi parametrai nurodyti prie pasirinkto metodo.
- Spartusis režimas
- Nenurodyta Pasirinkus spartųjį režimą
- Flex režimas
- Nenurodyta Pasirinkus flex režimą
- Didžiausios samprotavimo pastangos
- Nenurodyta Kai didžiausioms samprotavimo pastangoms taikomas numatytasis koregavimas (default)
Numatomi įkainiai palyginimui
Kainos pagal konfigūraciją
Kiekvieną mokestį susiekite su nurodytomis sąlygomis. Kiekvienam alternatyvių konfigūracijų rinkiniui taikykite vieną įkainį.
| Konfigūracija | Įkainių lentelė | Numatomas kiekis | Apskaitos vienetas | Apmokestinimo sąlygos | Mokestis |
|---|---|---|---|---|---|
| KonfigūracijaBaziniai žetonų įkainiai | Įkainių lentelėBazinis įkainis | Numatomas kiekis— | Apskaitos vienetas— | Apmokestinimo sąlygos— | Mokestis Įvestis · Įvesties tokenai · Įvertis tik palyginimui — / 1K tokenų Išvestis · Išvesties tokenai · Įvertis tik palyginimui — / 1K tokenų Įvestis · Talpyklos skaitymas · Įvertis tik palyginimui — / 1K tokenų Įvestis · Rašymas į talpyklą · Įvertis tik palyginimui — / 1K tokenų Įvestis · Rašymas į talpyklą, 1 val · Įvertis tik palyginimui — / 1K tokenų |
| KonfigūracijaVaizdo įrašo kaina | Įkainių lentelė— | Numatomas kiekis— | Apskaitos vienetasuž vaizdo įrašo sekundę | Apmokestinimo sąlygosresolution: 2k | Mokestis Išvestis · Vaizdo įrašo kaina · Įvertis tik palyginimui $0.2 už vaizdo įrašo sekundę |
| KonfigūracijaVaizdo įrašo kaina | Įkainių lentelė— | Numatomas kiekis— | Apskaitos vienetasuž vaizdo įrašo sekundę | Apmokestinimo sąlygosresolution: 480p | Mokestis Išvestis · Vaizdo įrašo kaina · Įvertis tik palyginimui $0.04 už vaizdo įrašo sekundę |
| KonfigūracijaVaizdo įrašo kaina | Įkainių lentelė— | Numatomas kiekis— | Apskaitos vienetasuž vaizdo įrašo sekundę | Apmokestinimo sąlygosresolution: 768p | Mokestis Išvestis · Vaizdo įrašo kaina · Įvertis tik palyginimui $0.072 už vaizdo įrašo sekundę |
| KonfigūracijaVaizdo įrašo kaina | Įkainių lentelė— | Numatomas kiekis— | Apskaitos vienetasuž vaizdo įrašo sekundę | Apmokestinimo sąlygosgeneravimo režimas: reference; skiriamoji geba: 2k | Mokestis Išvestis · Vaizdo įrašo kaina · Įvertis tik palyginimui $0.36 už vaizdo įrašo sekundę |
| KonfigūracijaVaizdo įrašo kaina | Įkainių lentelė— | Numatomas kiekis— | Apskaitos vienetasuž vaizdo įrašo sekundę | Apmokestinimo sąlygosgeneravimo režimas: reference; skiriamoji geba: 480p | Mokestis Išvestis · Vaizdo įrašo kaina · Įvertis tik palyginimui $0.14 už vaizdo įrašo sekundę |
| KonfigūracijaVaizdo įrašo kaina | Įkainių lentelė— | Numatomas kiekis— | Apskaitos vienetasuž vaizdo įrašo sekundę | Apmokestinimo sąlygosgeneravimo režimas: reference; skiriamoji geba: 768p | Mokestis Išvestis · Vaizdo įrašo kaina · Įvertis tik palyginimui $0.2 už vaizdo įrašo sekundę |
| Konfigūracijareferencinis įvesties vaizdas | Įkainių lentelė— | Numatomas kiekis— | Apskaitos vienetasuž pavyzdinį įvesties vaizdą | Apmokestinimo sąlygos— | Mokestis Įvestis · referencinis įvesties vaizdas · Įvertis tik palyginimui $0.08 už pavyzdinį įvesties vaizdą |
| KonfigūracijaNumatoma generavimo kaina | Įkainių lentelė— | Numatomas kiekisvieno generavimo įvertis | Apskaitos vienetas— | Apmokestinimo sąlygos— | Mokestis Išvestis · Numatoma generavimo kaina · Įvertis tik palyginimui $0.2 įvertis prieš generavimą Šis įvertis nėra papildomas mokestis ar fiksuotas užbaigto generavimo įkainis. |
Ailoot prieš užklausą rezervuoja numatomą sumą. Gavus rezultatą, galutinis mokestis nuskaitomas pagal išmatuotą naudojimą. Srautinio atsakymo atsiskaitymui naudojamas galutinis naudojimo įrašas. Kaip veikia rezervavimas ir atsiskaitymas →
Informacinio tarifo duomenys
Modelio informacinės lentelės nekeičia metodo pasirinkimo, kainos įverčių ar mokesčių. Galiojantys mokesčiai nustatomi pagal pasirinkto Ailoot metodo įkainius.
Vaizdo įrašo konfigūracijų kainų nuorodos
Kainos pagal konfigūraciją
Kiekvieną mokestį susiekite su nurodytomis sąlygomis. Kiekvienam alternatyvių konfigūracijų rinkiniui taikykite vieną įkainį.
| Konfigūracija | Apmokestinimo sąlygos | Mokestis |
|---|---|---|
| KonfigūracijaVaizdo įrašo kaina | Apmokestinimo sąlygosresolution: 2k | Mokestis Išvestis · Vaizdo įrašo kaina $0.18 už vaizdo įrašo sekundę Paskelbta orientacinė rodomos konfigūracijos kaina. Galutiniai mokesčiai nustatomi pagal faktiškai apmokestintą konfigūraciją. |
| KonfigūracijaVaizdo įrašo kaina | Apmokestinimo sąlygosresolution: 480p | Mokestis Išvestis · Vaizdo įrašo kaina $0.04 už vaizdo įrašo sekundę Paskelbta orientacinė rodomos konfigūracijos kaina. Galutiniai mokesčiai nustatomi pagal faktiškai apmokestintą konfigūraciją. |
| KonfigūracijaVaizdo įrašo kaina | Apmokestinimo sąlygosresolution: 768p | Mokestis Išvestis · Vaizdo įrašo kaina $0.06 už vaizdo įrašo sekundę Paskelbta orientacinė rodomos konfigūracijos kaina. Galutiniai mokesčiai nustatomi pagal faktiškai apmokestintą konfigūraciją. |
| KonfigūracijaVaizdo įrašo kaina | Apmokestinimo sąlygosgeneravimo režimas: reference; skiriamoji geba: 2k | Mokestis Išvestis · Vaizdo įrašo kaina $0.36 už vaizdo įrašo sekundę Paskelbta orientacinė rodomos konfigūracijos kaina. Galutiniai mokesčiai nustatomi pagal faktiškai apmokestintą konfigūraciją. |
| KonfigūracijaVaizdo įrašo kaina | Apmokestinimo sąlygosgeneravimo režimas: reference; skiriamoji geba: 480p | Mokestis Išvestis · Vaizdo įrašo kaina $0.08 už vaizdo įrašo sekundę Paskelbta orientacinė rodomos konfigūracijos kaina. Galutiniai mokesčiai nustatomi pagal faktiškai apmokestintą konfigūraciją. |
| KonfigūracijaVaizdo įrašo kaina | Apmokestinimo sąlygosgeneravimo režimas: reference; skiriamoji geba: 768p | Mokestis Išvestis · Vaizdo įrašo kaina $0.12 už vaizdo įrašo sekundę Paskelbta orientacinė rodomos konfigūracijos kaina. Galutiniai mokesčiai nustatomi pagal faktiškai apmokestintą konfigūraciją. |
Užklausų pavyzdžiai
Ailoot Ultra · Vaizdo įrašai
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
Gauti ir išsaugoti rezultatus
Ailoot Ultra · Vaizdo įrašai
pasirašyti jums priklausančio turinio URL
GET /v1/videos/{public_id}GET /v1/videos/{public_id}/content
Tikrinti užduoties būseną
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
Kito turinio skaitymas
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
Išsaugoti visus baigtus rezultatus
Išsaugokite kiekvieną baigtą vaizdo įrašą arba grąžintą failą; gaukite turinį iš kiekvieno faktiškai grąžinto medžiagos URL.
Išsaugokite kiekvieną tikrą jums priklausantį rezultatą ir grąžintus išmatuotus jo metaduomenis.
Jei reikia patikrinti pradinį atsakymą
503 result_pending_check + pradinis id + X-Should-Retry:false; niekada nekartokite pradinės užklausos
Atsakymo laukai
| Laukas | Tipas | Reikšmė |
|---|---|---|
Laukasindex | Tipasinteger | ReikšmėŠio vaizdo įrašo pozicija rezultatų sąraše, skaičiuojama nuo nulio. |
Laukascontent_url | Tipasstring | ReikšmėPasirašytas HTTPS atsisiuntimo URL šiam užbaigtam vaizdo įrašui. |
Laukassha256 | Tipasstring | null | ReikšmėPradinio vaizdo įrašo baitų SHA-256 santrauka; null, jei nepasiekiama. |
Laukassize_bytes | Tipasinteger | null | ReikšmėPradinio vaizdo įrašo failo dydis baitais; null, jei nepasiekiamas. |
Laukasduration_ms | Tipasinteger | null | ReikšmėIšmatuota vaizdo įrašo trukmė milisekundėmis; null, jei nepasiekiama. |
Laukaswidth | Tipasinteger | null | ReikšmėVaizdo įrašo plotis pikseliais; null, jei nepasiekiamas. |
Laukasheight | Tipasinteger | null | ReikšmėVaizdo įrašo aukštis pikseliais; null, jei nepasiekiamas. |
Laukasvideo_codec | Tipasstring | null | ReikšmėVaizdo kodeko identifikatorius; null, jei neužregistruotas. |
Laukashas_audio | Tipasboolean | null | ReikšmėAr vaizdo įraše yra garso takelis; null, jei nenustatyta. |
Laukasaudio_codec | Tipasstring | null | ReikšmėGarso kodeko identifikatorius; null, kai identifikatorius neužregistruotas. |
Klaidos ir tolesni veiksmai
| Atsakymas | Sąlyga | Kitas žingsnis |
|---|---|---|
Atsakymas404 · not_found_error | SąlygaPrieiga prie vaizdo įrašo nepasiekiama arba šis vaizdo įrašo ID nerastas. | Kitas žingsnisPatikrinkite prieigą prie vaizdo įrašo. Jei vaizdo įrašas jau yra, naudokite jo pradinį viešą ID ir tą patį API raktą. |
Atsakymas401 · authentication_error | SąlygaAPI raktas neatitinka autentifikuotos paskyros. | Kitas žingsnisPrieš pateikdami patikrinkite savo API raktą ir paskyros prieigą. |
Atsakymas400 · invalid_request_error | SąlygaNepavyko nuskaityti užklausos arba atsisiuntimo indeksas netinkamas. | Kitas žingsnisPataisykite užklausos turinį. Atsisiuntimui pasirinkite išvesties indeksą, kurį grąžino pradinė užduotis. |
Atsakymas422 · price_unavailable | SąlygaPasirinktos vaizdo įrašo konfigūracijos kainos nustatyti negalima. | Kitas žingsnisPasirinkite palaikomą vaizdo įrašo konfigūraciją ir prieš pateikdami pataisytą užklausą užpildykite jos privalomas parinktis. |
Atsakymas422 · invalid_request_error | SąlygaVaizdo įrašo įvestis arba pradinė tęsinio užduotis netinkama. | Kitas žingsnisNaudokite tinkamą HTTPS įvestį. Tęsiniui naudokite užbaigto pradinio vaizdo įrašo viešą ID ir tą patį API raktą. |
Atsakymas402 · billing_error | SąlygaTurimas likutis arba limitai neleidžia rezervuoti lėšų. | Kitas žingsnisPrieš siųsdami naują užklausą patikrinkite turimą likutį ir limitus. |
Atsakymas503 · server_error | SąlygaVaizdo įrašo patikra, saugykla arba prieiga prie paslaugos laikinai nepasiekiama. | Kitas žingsnisPalaukite, kol paslauga taps pasiekiama. Jei jau turite vaizdo įrašo ID, tikrinkite tą pradinę užduotį, užuot pradėję kitą generavimą. |
Atsakymas503 · result_pending_check | SąlygaReikia patikrinti pradinį vaizdo įrašo rezultatą ir mokestį. | Kitas žingsnisIšsaugokite grąžintą vaizdo įrašo ID ir tikrinkite tą užduotį. Kol ji tikrinama, nesiųskite ją pakeičiančios generavimo užklausos. |
Atsakymas503 · owned_result_unavailable | SąlygaEsamo vaizdo įrašo atsisiuntimas laikinai nepasiekiamas. | Kitas žingsnisVėliau patikrinkite tą pačią vaizdo įrašo užduotį ir atsisiųskite jos esamą rezultatą. Naujas generavimas sukuria atskirą operaciją. |
Atsakymas409 · video_not_ready | SąlygaVaizdo įrašo turinys nepaskelbtas. | Kitas žingsnisPatikrinkite pradinės užduoties būseną. Atsisiųskite, kai ji praneša completed; jei praneša failed, vadovaukitės jos pranešimu apie mokesčio patikrą. |
Pseudonimai
Modelių pseudonimai
Ailoot Ultra heygen/heygen-video-1
Metodų kelių pseudonimai
Naudokite aukščiau nurodytus metodų kelius.
Susiję ID iškvietimui
FAQ · HeyGen: HeyGen Video
- Kokios įvestys ir rezultatai prieinami?
POST /v1/videos·heygen/heygen-video-1:text,image,audio,video→video- Kokius laukus naudoja užklausa?
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- Kokie apribojimai taikomi?
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