HeyGen: HeyGen Video
HeyGen Video generuje scény 5–15 sekund s dialogem, atmosférou a efekty z textu, prvního obrázku nebo vizuálních a zvukových referencí. Jeho univerzální model heygen-video-1 podporuje produktové záběry i postavy, s referenčním ovládáním a výstupem MP4. Jasné, ohraničené akce mu dávají užitečné produkční zadání.
O modelu
Tento popis zahrnuje schopnosti modelu. Vstupy, výstupy a možnosti dostupné v Ailoot jsou uvedeny níže pro vybranou metodu.
HeyGen Video je univerzální model generování scén od HeyGen, výrobcem identifikovaný jako heygen-video-1. Vytváří objekt, prostředí, světlo a zvuk společně z tvůrčího zadání. Každý klip trvá 5–15 sekund a obsahuje generovanou zvukovou stopu včetně dialogu, atmosféry a efektů. Užitečné produkční vstupy zahrnují popis scény, fotografii produktu nebo materiál stanovující osobu, místo či pohyb. Výsledným podkladem je krátká scéna pro produktovou prezentaci, úvodní instruktážní vložku, pohled na nemovitost nebo jinou práci s upravovaným videem.
Tři režimy dávají vstupům odlišné role. Převod textu na video vytváří scénu z promptu. Převod obrázku na video doslova začíná dodaným obrázkem a potom sleduje zadání akce. Převod referencí na video používá dodané obrázky, video a volitelný zvuk pro vedení nově sestavené scény; vyžaduje alespoň jeden referenční obrázek nebo video. Obrázek prvního snímku vyberte, má-li úvodní kompozice odpovídat statickému obrázku, a reference, má-li se známý předmět objevit v jiné kompozici. Tento model scén se liší od renderovacích enginů avatarů HeyGen i od kompozičního postupu Video Agent.
Příručka výrobce upřednostňuje podrobné, konkrétní vedení záběru: jeden objekt, jedno místo a jednu ohraničenou akci, s pevnou nebo jemně se pohybující kamerou. Popište polohu kamery, záměr objektivu nebo hloubky ostrosti, světlo, texturu povrchu a barevné zpracování. Pokud akce závisí na kontaktu, vysvětlete místa dotyku předmětů. U původního produktového příkladu použijte referenční fotografii cestovní termosky a požádejte, aby stála na dřevěném pultu, zatímco vedle ní mluví moderátor, s malým pohybem kamery k termosce. Ve výsledku zkontrolujte tvar, umístění a viditelné označení termosky.
Seznamy referencí podporují až devět obrázků, tři videa a tři zvukové položky, s maximem dvanáct referencí celkem. Obrázky, videa a zvuk se ve formátu promptu výrobce číslují samostatně: první obrázek je <Picture 1> a první video <Video 1>. Každé referenci dejte roli a v zadání ji výslovně určete. Model čte prvních pět sekund každého referenčního videa, proto relevantní úsek připravte na začátku. Referenční příručka API také stanovuje poměry referenčního videa mezi 1:4 a 4:1. Dlouhý klip obsahující požadovaný pohyb až na konci je nevhodnou přípravou pro toto pětisekundové vstupní okno.
Dokumentované referenční rozhraní přijímá přímo přístupný zdroj HTTPS, identifikátor nahraného podkladu nebo vložené base64. Příručka uvádí maximální velikosti obrázku 16 MB přes URL a 5 MB vloženě; video nebo zvuk mohou mít až 32 MB přes URL a 16 MB vloženě. Připravte čitelné zdrojové materiály se snadno rozlišitelným důležitým objektem a bez soupeřících pokynů různých referencí. V obrázku prvního snímku zachovejte zamýšlenou orientaci. Tyto vstupní podrobnosti se týkají referenčního postupu výrobce a pomáhají uspořádat tvůrčí materiály pro vybraný režim.
Zvuk režírujte ve stejném zadání jako obraz. Uveďte dialog, hlasový přednes, zvuk místnosti a konkrétní efekty včetně jejich blízkosti či vzdálenosti. Pokud má scéna obsahovat pouze řeč a atmosféru, určete zamýšlené hudební zpracování. Příručka jako plánovací odhad navrhuje přibližně 2.5 mluveného slova za sekundu, proto ponechte prostor pro pauzy a viditelnou akci. Krátký úvod lze naplánovat jako jednu repliku následovanou okamžikem odhalení produktu. Poslechněte skutečná slova a ověřte, zda generovaný zvuk odpovídá prostoru a akci.
Výstupní délka se vybírá v celých sekundách od pěti do patnácti s výchozími pěti sekundami. Rozlišení je velikostní třída: 480p, 768p, 1080p nebo 2k. Dokumentované volby rámování jsou 21:9, 16:9, 4:3, 1:1, 3:4 a 9:16. U převodu textu a referencí na video při 1080p nebo 2k vyberte 16:9 nebo 9:16; adaptivní referenční rámování je dokumentováno při 480p a 768p. Převod obrázku na video sleduje proporce prvního obrázku, proto při změně požadovaného tvaru ořízněte vstup před generováním. Ověřte skutečné rozměry hotového výsledku, místo předpokladu, že označení velikostní třídy znamená jednu běžnou dvojici pixelů.
Modelová příručka stanovuje video MP4 s obrazovým kódováním H.264 a stereofonním zvukem AAC při 32 kHz. Generování se zpracovává asynchronně a dokončený úkol dodává umístění přehratelného videa, délku a rozměry. Podepsané umístění videa lze obnovit opětovným načtením úkolu. Skutečný klip, referenční materiály a zadání uchovejte pro střihovou kontrolu. Čekající nebo zpracovávaný záznam sleduje generování; hotové video je produkčním výstupem k posouzení obrazu, řeči a zvuku.
Výrobce dokumentuje volby vylepšení promptu turbo, quality a disabled; disabled ponechává připravené znění tak, jak bylo napsáno. Pevný seed se hodí při porovnávání změny jedné věty při zachování ostatních vstupů. Vybraný seed a nastavení zaznamenejte se zadáním záběru. U nápisů v obraze udržujte zamýšlenou frázi krátkou a přesně ji zapište; příručka doporučuje odstavce, drobný text a označené diagramy skládat dodatečně. U generovaného titulku kontrolujte každý viditelný znak, místo předpokladu správného reprodukování znění.
Příručka označuje za méně spolehlivé oblasti dlouhý text na obrazovce, jemný organický pohyb okvětních lístků, papíru nebo vlasů a manipulaci rukou v detailu. U vysvětlení postupu nechte jasně napsanou repliku sdělit kroky a obrazem ukažte stabilní osobu nebo předmět; má-li být samotná fyzická operace přesná, použijte samostatně ověřené vizuály. Celý záběr zkontrolujte z hlediska návaznosti předmětů, kontaktu, detailů tváře a rukou, dialogu i zvuku. Stručný seznam změn pro další verzi udržuje podrobné produkční zadání praktické.
Ailoot Ultra · Video POST /v1/videos heygen/heygen-video-1
heygen/heygen-video-1Úvod
HeyGen Video generuje scény 5–15 sekund s dialogem, atmosférou a efekty z textu, prvního obrázku nebo vizuálních a zvukových referencí. Jeho univerzální model heygen-video-1 podporuje produktové záběry i postavy, s referenčním ovládáním a výstupem MP4. Jasné, ohraničené akce mu dávají užitečné produkční zadání.
- Přijímané vstupy
- Text · Obrázky · Zvuk · Video
- Výsledky
- Video
Dostupné v Ailoot · vstupy a metody
Ailoot Ultra · Video POST /v1/videos
- Vstup
text,image,audio,video- Výstup
video- Výstupní formát
- původní bajty MP4; bez normalizace a překódování
| Pole | Typ | Požadavek | Hodnoty a limity | Výchozí |
|---|---|---|---|---|
Polemodel | Typstring | PožadavekPovinné | Hodnoty a limity heygen/heygen-video-1 | Výchozí— |
Poleprompt | Typstring | PožadavekPovinné | Hodnoty a limity | Výchozí— |
Poleduration | Typinteger | PožadavekPovinné | Hodnoty a limity 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 Minimum: 1 Maximum: 600 | Výchozí— |
Poleresolution | Typstring | PožadavekVolitelné | Hodnoty a limity 480p, 768p, 2K | Výchozí— |
Poleaspect_ratio | Typstring | PožadavekVolitelné | Hodnoty a limity 21:9, 16:9, 4:3, 1:1, 3:4, 9:16 | Výchozí— |
Polegenerate_audio | Typboolean | PožadavekVolitelné | Hodnoty a limity false | Výchozí— |
Poleframe_images | Typarray | PožadavekVolitelné | Hodnoty a limity Minimální počet položek: 1 Maximální počet položek: 1 Vstupní obsah: Pole objektů snímků. Každý objekt obsahuje type=image_url, image_url obsahující url a frame_type. Použijte HTTPS URL obrázku a nastavte frame_type na first_frame. Každá role snímku se smí vyskytnout nejvýše jednou. Přesné klíče: type, image_url, frame_type Podmínky: Tyto klíče popisují každý objekt snímku; image_url obsahuje pouze url. Pro požadavek obsahující pouze text vynechte frame_images. | Výchozí— |
Poleinput_references | Typarray | PožadavekVolitelné | Hodnoty a limity | Výchozí— |
Poleseed | Typinteger | PožadavekVolitelné | Hodnoty a limity Minimum: -9 223 372 036 854 775 808 Maximum: 9 223 372 036 854 775 807 | Výchozí— |
Polecallback_url | Typstring | PožadavekVolitelné | Hodnoty a limity Vzor: ^https:// | Výchozí— |
Polesession_id | Typstring | PožadavekVolitelné | Hodnoty a limity | Výchozí— |
Poletrace | Typobject | PožadavekVolitelné | Hodnoty a limity | Výchozí— |
Poleuser | Typstring | PožadavekVolitelné | Hodnoty a limity | Výchozí— |
Kombinace vstupních materiálů
Text na video · Textové zadání. · Povinné: model, prompt, duration
Zadejte prompt jako text a duration v celých sekundách. Vyberte podporované rozlišení a případně poměr stran.
model: Typ: string · heygen/heygen-video-1
prompt: Typ: string · Maximální počet bajtů UTF-8: 10 000 · Vyžadován obsah kromě bílých znaků: Ano
Obrázek na video · Textové zadání a obrázek prvního snímku. · Povinné: model, prompt, duration, frame_images
frame_images je pole. Každý objekt snímku obsahuje type, image_url a frame_type; image_url obsahuje url. Nastavte type na image_url. Použijte first_frame. Každá role snímku se smí vyskytnout nejvýše jednou. Pro každý snímek zadejte veřejnou HTTPS URL obrázku. Zvolte podporované rozlišení a případně poměr stran.
Přesné klíče: type, image_url, frame_type
model: Typ: string · heygen/heygen-video-1
prompt: Typ: string · Maximální počet bajtů UTF-8: 10 000 · Vyžadován obsah kromě bílých znaků: Ano
Reference to video · Textové zadání a podporované obrazové, video a zvukové reference. · Povinné: model, prompt, duration, input_references
input_references je pole objektů. Nastavte type na image_url, video_url nebo audio_url a použijte odpovídající pole obsahující url. Používejte veřejné HTTPS URL. Vynecháním frame_images zvolíte režim referencí. Vyberte podporované rozlišení a případně poměr stran.
model: Typ: string · heygen/heygen-video-1
prompt: Typ: string · Maximální počet bajtů UTF-8: 10 000 · Vyžadován obsah kromě bílých znaků: Ano
Parametry a životní cyklus metody
| Parametr | Kontrakt |
|---|---|
Parametrcontent_type | Kontraktapplication/json |
Parametrrequired | Kontraktmodel, prompt, duration |
Parametrmaterial_types | Kontrakttext, image, audio, video |
Parametradditional_properties | Kontraktfalse |
Parametroptional_controls | Kontraktresolution, aspect_ratio, generate_audio, frame_images, input_references, seed, callback_url, session_id, trace, user |
Životní cyklus: submit_once_poll_original
GET /v1/videos/{public_id}
GET /v1/videos/{public_id}/content
Tarify
Jak se vypočítá konečný poplatek
Zobrazené sazby slouží k odhadu ceny před generováním. Konečný poplatek se vypočítá z nákladů zaznamenaných u původního generování. Naměřená délka výstupu ani odhadovaná množství nejsou konečným účtovaným množstvím.
Údaje o tarifech nepřidávají možnosti požadavku. Podporované parametry jsou uvedeny u vybrané metody.
- Rychlý režim
- Neuvedeno Při výběru rychlého režimu
- Režim flex
- Neuvedeno Při výběru režimu flex
- Maximální intenzita uvažování
- Neuvedeno Když se při maximální intenzitě uvažování použije výchozí úprava (default)
Odhadované sazby pro srovnání
Ceny podle konfigurace
Přiřaďte každý poplatek k uvedeným podmínkám. Pro každou sadu alternativních konfigurací použijte jednu sazbu.
| Konfigurace | Tabulka sazeb | Předpokládané množství | Účtovací jednotka | Podmínky účtování | Poplatek |
|---|---|---|---|---|---|
| KonfiguraceZákladní sazby za tokeny | Tabulka sazebZákladní sazba | Předpokládané množství— | Účtovací jednotka— | Podmínky účtování— | Poplatek Vstup · Vstupní tokeny · Odhad pouze pro srovnání — / 1K tokenů Výstup · Výstupní tokeny · Odhad pouze pro srovnání — / 1K tokenů Vstup · Čtení z mezipaměti · Odhad pouze pro srovnání — / 1K tokenů Vstup · Zápis do mezipaměti · Odhad pouze pro srovnání — / 1K tokenů Vstup · Zápis do mezipaměti, 1 hodina · Odhad pouze pro srovnání — / 1K tokenů |
| KonfiguraceCena videa | Tabulka sazeb— | Předpokládané množství— | Účtovací jednotkaza sekundu videa | Podmínky účtováníresolution: 2k | Poplatek Výstup · Cena videa · Odhad pouze pro srovnání $0.2 za sekundu videa |
| KonfiguraceCena videa | Tabulka sazeb— | Předpokládané množství— | Účtovací jednotkaza sekundu videa | Podmínky účtováníresolution: 480p | Poplatek Výstup · Cena videa · Odhad pouze pro srovnání $0.04 za sekundu videa |
| KonfiguraceCena videa | Tabulka sazeb— | Předpokládané množství— | Účtovací jednotkaza sekundu videa | Podmínky účtováníresolution: 768p | Poplatek Výstup · Cena videa · Odhad pouze pro srovnání $0.072 za sekundu videa |
| KonfiguraceCena videa | Tabulka sazeb— | Předpokládané množství— | Účtovací jednotkaza sekundu videa | Podmínky účtovánírežim generování: reference; rozlišení: 2k | Poplatek Výstup · Cena videa · Odhad pouze pro srovnání $0.36 za sekundu videa |
| KonfiguraceCena videa | Tabulka sazeb— | Předpokládané množství— | Účtovací jednotkaza sekundu videa | Podmínky účtovánírežim generování: reference; rozlišení: 480p | Poplatek Výstup · Cena videa · Odhad pouze pro srovnání $0.14 za sekundu videa |
| KonfiguraceCena videa | Tabulka sazeb— | Předpokládané množství— | Účtovací jednotkaza sekundu videa | Podmínky účtovánírežim generování: reference; rozlišení: 768p | Poplatek Výstup · Cena videa · Odhad pouze pro srovnání $0.2 za sekundu videa |
| Konfiguracereferenční vstupní obrázek | Tabulka sazeb— | Předpokládané množství— | Účtovací jednotkaza vstupní referenční obrázek | Podmínky účtování— | Poplatek Vstup · referenční vstupní obrázek · Odhad pouze pro srovnání $0.08 za vstupní referenční obrázek |
| KonfiguraceOdhadovaná cena generování | Tabulka sazeb— | Předpokládané množstvíodhad pro jedno generování | Účtovací jednotka— | Podmínky účtování— | Poplatek Výstup · Odhadovaná cena generování · Odhad pouze pro srovnání $0.2 odhad před generováním Tento odhad není dodatečným poplatkem ani pevnou sazbou za dokončené generování. |
Ailoot před požadavkem rezervuje odhadovanou částku. Po výsledku vyúčtuje konečný poplatek podle naměřeného využití. Při streamování se účtování řídí konečným záznamem využití. Jak funguje rezervace a vyúčtování →
Podrobnosti referenčního tarifu
Referenční tabulky modelu nemění výběr metody, cenové nabídky ani poplatky. Skutečné poplatky používají sazby vybrané metody Ailoot.
Cenové reference konfigurací videa
Ceny podle konfigurace
Přiřaďte každý poplatek k uvedeným podmínkám. Pro každou sadu alternativních konfigurací použijte jednu sazbu.
| Konfigurace | Podmínky účtování | Poplatek |
|---|---|---|
| KonfiguraceCena videa | Podmínky účtováníresolution: 2k | Poplatek Výstup · Cena videa $0.18 za sekundu videa Zveřejněná referenční cena pro zobrazenou konfiguraci. Konečné poplatky odpovídají skutečně účtované konfiguraci. |
| KonfiguraceCena videa | Podmínky účtováníresolution: 480p | Poplatek Výstup · Cena videa $0.04 za sekundu videa Zveřejněná referenční cena pro zobrazenou konfiguraci. Konečné poplatky odpovídají skutečně účtované konfiguraci. |
| KonfiguraceCena videa | Podmínky účtováníresolution: 768p | Poplatek Výstup · Cena videa $0.06 za sekundu videa Zveřejněná referenční cena pro zobrazenou konfiguraci. Konečné poplatky odpovídají skutečně účtované konfiguraci. |
| KonfiguraceCena videa | Podmínky účtovánírežim generování: reference; rozlišení: 2k | Poplatek Výstup · Cena videa $0.36 za sekundu videa Zveřejněná referenční cena pro zobrazenou konfiguraci. Konečné poplatky odpovídají skutečně účtované konfiguraci. |
| KonfiguraceCena videa | Podmínky účtovánírežim generování: reference; rozlišení: 480p | Poplatek Výstup · Cena videa $0.08 za sekundu videa Zveřejněná referenční cena pro zobrazenou konfiguraci. Konečné poplatky odpovídají skutečně účtované konfiguraci. |
| KonfiguraceCena videa | Podmínky účtovánírežim generování: reference; rozlišení: 768p | Poplatek Výstup · Cena videa $0.12 za sekundu videa Zveřejněná referenční cena pro zobrazenou konfiguraci. Konečné poplatky odpovídají skutečně účtované konfiguraci. |
Příklady požadavků
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
Přijímání a ukládání výsledků
Ailoot Ultra · Video
podepsané URL obsahu spravovaného službou
GET /v1/videos/{public_id}GET /v1/videos/{public_id}/content
Ověřit stav úlohy
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
Další načtení obsahu
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
Uchovejte všechny dokončené výsledky
Uložte každé dokončené video či vrácený soubor; stáhněte obsah každé skutečně vrácené URL souboru.
Uchovejte každý skutečný výstup spravovaný službou a jeho vrácená metadata s naměřenými hodnotami.
Pokud je nutné ověřit původní odpověď
503 result_pending_check + původní id + X-Should-Retry:false; původní požadavek nikdy neopakujte
Pole odpovědi
| Pole | Typ | Význam |
|---|---|---|
Poleindex | Typinteger | VýznamPozice tohoto videa v seznamu výstupů, číslovaná od nuly. |
Polecontent_url | Typstring | VýznamPodepsaná HTTPS URL pro stažení tohoto dokončeného videa. |
Polesha256 | Typstring | null | VýznamOtisk SHA-256 původních bajtů videa; null, není-li dostupný. |
Polesize_bytes | Typinteger | null | VýznamVelikost původního videosouboru v bajtech; null, není-li dostupná. |
Poleduration_ms | Typinteger | null | VýznamNaměřená délka videa v milisekundách; null, není-li dostupná. |
Polewidth | Typinteger | null | VýznamŠířka videa v pixelech; null, není-li dostupná. |
Poleheight | Typinteger | null | VýznamVýška videa v pixelech; null, není-li dostupná. |
Polevideo_codec | Typstring | null | VýznamIdentifikátor video kodeku; null, není-li zaznamenán. |
Polehas_audio | Typboolean | null | VýznamZda video obsahuje zvukovou stopu; null, nebylo-li změřeno. |
Poleaudio_codec | Typstring | null | VýznamIdentifikátor zvukového kodeku; null, není-li žádný identifikátor zaznamenán. |
Chyby a další kroky
| Odpověď | Podmínka | Další krok |
|---|---|---|
Odpověď404 · not_found_error | PodmínkaPřístup k videu není dostupný nebo toto ID videa nebylo nalezeno. | Další krokZkontrolujte přístup k videu. U existujícího videa použijte jeho původní veřejné ID a stejný klíč API. |
Odpověď401 · authentication_error | PodmínkaKlíč API neodpovídá ověřenému účtu. | Další krokPřed odesláním zkontrolujte svůj klíč API a přístup k účtu. |
Odpověď400 · invalid_request_error | PodmínkaPožadavek se nepodařilo načíst nebo je index pro stažení neplatný. | Další krokOpravte tělo požadavku. Pro stažení vyberte index výstupu vrácený původní úlohou. |
Odpověď422 · price_unavailable | PodmínkaVybranou konfiguraci videa nelze ocenit. | Další krokPřed odesláním opraveného požadavku zvolte podporovanou konfiguraci videa a vyplňte její povinné volby. |
Odpověď422 · invalid_request_error | PodmínkaVstup videa nebo původní úloha pro pokračování jsou neplatné. | Další krokPoužívejte platné HTTPS vstupy. Pro pokračování použijte původní veřejné ID svého dokončeného videa se stejným klíčem API. |
Odpověď402 · billing_error | PodmínkaDostupný zůstatek nebo limity neumožňují rezervaci. | Další krokPřed odesláním nového požadavku zkontrolujte dostupný zůstatek a limity. |
Odpověď503 · server_error | PodmínkaOvěřování videa, úložiště nebo přístup ke službě jsou dočasně nedostupné. | Další krokPočkejte na dostupnost služby. Pokud už máte ID videa, kontrolujte tuto původní úlohu místo vytváření dalšího generování. |
Odpověď503 · result_pending_check | PodmínkaPůvodní výsledek videa a vyúčtovanou částku je třeba zkontrolovat. | Další krokUchovejte vrácené ID videa a kontrolujte tuto úlohu. Dokud probíhá kontrola, neposílejte náhradní požadavek na generování. |
Odpověď503 · owned_result_unavailable | PodmínkaStávající video je dočasně nedostupné ke stažení. | Další krokPozději zkontrolujte tutéž úlohu videa a stáhněte její existující výstup. Nové generování vytvoří samostatnou operaci. |
Odpověď409 · video_not_ready | PodmínkaObsah videa nebyl zveřejněn. | Další krokZkontrolujte stav původní úlohy. Stáhněte výstup, až nahlásí completed; nahlásí-li failed, řiďte se jejím upozorněním na kontrolu vyúčtování. |
Aliasy
Aliasy modelu
Ailoot Ultra heygen/heygen-video-1
Aliasy cest metod
Použijte cesty metod uvedené výše.
Související ID modelů
FAQ · HeyGen: HeyGen Video
- Jaké vstupy a výsledky jsou dostupné?
POST /v1/videos·heygen/heygen-video-1:text,image,audio,video→video- Jaká pole požadavek používá?
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- Jaké limity platí?
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