HeyGen: HeyGen Video
HeyGen Video generoi 5–15 sekunnin kohtauksia vuoropuhelulla, ambienssilla ja tehosteilla tekstistä, ensimmäisestä kuvasta tai visuaalisista ja äänellisistä viitteistä. Yleiskäyttöinen heygen-video-1-malli tukee tuote- ja hahmo-otoksia viitesäätimillä ja MP4-tulosteella. Selkeät rajatut toiminnot antavat sille hyödyllisen tuotantotehtävänannon.
Tietoa mallista
Tämä kuvaus kattaa mallin ominaisuudet. Ailootissa saatavilla olevat syötteet, tulosteet ja asetukset luetellaan alla valitulle menetelmälle.
HeyGen Video on HeyGenin yleiskäyttöinen kohtausgenerointimalli, jonka valmistaja tunnistaa nimellä heygen-video-1. Se luo kohteen, ympäristön, valon ja äänen yhdessä luovasta tehtävänannosta. Jokainen leike on 5–15 sekuntia pitkä ja sisältää generoidun ääniraitansa, mukaan lukien vuoropuhelun, ambienssin ja tehosteet. Hyödyllisiä tuotantosyötteitä ovat kohtauskuvaus, tuotekuva tai henkilön, paikan tai liikkeen määrittävä aineisto. Syntyvä tuotos on lyhyt kohtaus tuote-esittelyyn, perehdytyksen välikuvaksi, kiinteistönäkymäksi tai muuhun editoituun videotyöhön.
Kolme tilaa antaa syötteille erilaiset roolit. Tekstistä videoksi luo kohtauksen kehotteesta. Kuvasta videoksi alkaa kirjaimellisesti annetusta kuvasta ja seuraa sitten toiminnan tehtävänantoa. Viitteestä videoksi käyttää annettuja kuvia, videota ja valinnaista ääntä uuden sommitellun kohtauksen ohjaamiseen; se vaatii vähintään yhden viitekuvan tai -videon. Valitse ensimmäisen ruudun kuva, kun avaussommittelun tulee vastata stillkuvaa, tai viitteet, kun tunnetun esineen tulee näkyä eri sommittelussa. Tämä kohtausmalli on erillinen HeyGenin avatarrenderöintimoottoreista ja Video Agent -koostamistyönkulusta.
Valmistajan opas suosii yksityiskohtaisia konkreettisia otosohjeita: yksi kohde, yksi paikka ja yksi rajattu toiminta lukitulla tai lempeästi liikkuvalla kameralla. Kuvaa kameran sijainti, objektiivi- tai syväterävyystavoite, valo, pintatekstuuri ja värikäsittely. Selitä esineiden kosketuskohdat toiminnan riippuessa kosketuksesta. Käytä alkuperäisessä tuote-esimerkissä matkapullon viitekuvaa ja pyydä sitä seisomaan puutasolla esittelijän puhuessa sen vieressä sekä pientä kameraliikettä kohti pulloa. Tarkista tuloksen pullon muoto, sijoittelu ja näkyvät merkinnät.
Viiteluettelot tukevat enintään yhdeksää kuvaa, kolmea videota ja kolmea ääniaineistoa, yhteensä enintään kahtatoista viitettä. Kuvat, videot ja ääni numeroidaan erikseen valmistajan kehoteformaatissa: ensimmäinen kuva on <Picture 1> ja ensimmäinen video <Video 1>. Anna jokaiselle viitteelle rooli ja nimeä se tehtävänannossa nimenomaisesti. Malli lukee jokaisen viitevideon ensimmäiset viisi sekuntia, joten valmistele olennainen osuus alkuun. API-viite määrittää myös viitevideon suhteeksi 1:4–4:1. Pitkä leike, jonka haluttu liike on vasta lopussa, on heikko valmistelu viiden sekunnin syöteikkunaan.
Dokumentoitu viiterajapinta hyväksyy suoraan saatavilla olevan HTTPS-resurssin, ladatun aineiston tunnisteen tai inline-base64:n. Opas luettelee kuvien enimmäiskooksi 16 MB URL:lla ja 5 MB inline-muodossa; video tai ääni voi olla enintään 32 MB URL:lla ja 16 MB inline-muodossa. Valmistele selkeä lähdeaineisto, jonka tärkeä kohde on helppo erottaa ja jonka eri viitteissä ei ole kilpailevia ohjeita. Pidä tarkoitettu suunta ensimmäisen ruudun kuvassa. Syöteyksityiskohdat koskevat valmistajan viitetyönkulkua ja auttavat järjestämään luovan aineiston valittuun tilaan.
Ohjaa ääni samassa tehtävänannossa kuin kuva. Määritä vuoropuhelu, äänen esitystapa, huoneääni ja täsmälliset tehosteet sekä äänen läheisyys tai kaukaisuus. Määritä tarkoitettu musiikkikäsittely, kun kohtauksen tulee sisältää vain puhetta ja ambienssia. Opas ehdottaa suunnitteluarvioksi noin 2.5 puhuttua sanaa sekunnissa, joten jätä tilaa tauoille ja näkyvälle toiminnalle. Lyhyt esittely voidaan suunnitella yhtenä repliikkinä, jota seuraa tuotteen paljastava hetki. Kuuntele varsinaiset sanat ja generoidun äänen sopivuus tilaan sekä toimintaan.
Tulostekesto valitaan kokonaisina sekunteina viidestä viiteentoista, oletuksena viisi sekuntia. Tarkkuus on kokoluokka: 480p, 768p, 1080p tai 2k. Dokumentoidut rajausvalinnat ovat 21:9, 16:9, 4:3, 1:1, 3:4 ja 9:16. Valitse tekstistä ja viitteestä videoksi -tiloissa 1080p:llä tai 2k:lla 16:9 tai 9:16; mukautuva viiterajaus on dokumentoitu 480p:llä ja 768p:llä. Kuvasta videoksi seuraa ensimmäisen kuvan suhteita, joten rajaa ennen generointia tarvittavan muodon muuttuessa. Tarkista valmiin tuloksen todelliset mitat sen sijaan, että olettaisit kokoluokkatunnisteen tarkoittavan yhtä tavanomaista pikseliparia.
Malliopas määrittää MP4-videon H.264-kuvakoodauksella ja AAC-äänellä 32 kHz:n stereona. Generointi käsitellään asynkronisesti, ja valmis tehtävä antaa toistettavan videon sijainnin, keston ja mitat. Allekirjoitetun videosijainnin voi päivittää hakemalla tehtävän uudelleen. Säilytä varsinainen leike, viiteaineistot ja tehtävänanto editointitarkistusta varten. Odottava tai käsittelyssä oleva tietue seuraa generointia; valmis video on tuotantotuotos, josta arvioidaan kuva, puhe ja ääni.
Valmistaja dokumentoi kehotteen parannusvalinnat turbo, quality ja disabled; disabled säilyttää valmistellun sanamuodon sellaisenaan. Kiinteä seed auttaa yhden lausekkeen muutoksen vertailussa muiden syötteiden säilyessä. Tallenna valittu seed ja asetukset otostehtävänannon kanssa. Pidä ruudulla näkyvä tarkoitettu ilmaus lyhyenä ja kirjoita se täsmällisesti; opas suosittelee kappaleiden, pienen tekstin ja nimettyjen kaavioiden kompositointia jälkeenpäin. Tarkista jokainen generoidun otsikon näkyvä merkki sen sijaan, että olettaisit sanamuodon toistuneen oikein.
Opas nimeää epäluotettavammiksi alueiksi pitkän ruututekstin, pehmeän orgaanisen liikkeen, kuten terälehdet, paperin tai hiukset, sekä käsien lähikäsittelyn. Anna menettelyn selityksessä selkeästi kirjoitetun repliikin välittää vaiheet kuvan näyttäessä vakaata henkilöä tai esinettä; käytä erikseen varmennettuja visuaaleja, kun itse fyysisen toiminnon täytyy olla täsmällinen. Tarkista koko otoksesta esinejatkuvuus, kosketus, kasvojen ja käsien yksityiskohdat, vuoropuhelu ja ääni. Tiivis seuraavan oton muutosten luettelo pitää yksityiskohtaisen tuotantotehtävänannon käytännöllisenä.
Ailoot Ultra · Video POST /v1/videos heygen/heygen-video-1
heygen/heygen-video-1Aloitus
HeyGen Video generoi 5–15 sekunnin kohtauksia vuoropuhelulla, ambienssilla ja tehosteilla tekstistä, ensimmäisestä kuvasta tai visuaalisista ja äänellisistä viitteistä. Yleiskäyttöinen heygen-video-1-malli tukee tuote- ja hahmo-otoksia viitesäätimillä ja MP4-tulosteella. Selkeät rajatut toiminnot antavat sille hyödyllisen tuotantotehtävänannon.
- Hyväksytyt syötteet
- Teksti · Kuvat · Ääni · Video
- Tulokset
- Video
Saatavilla Ailootissa · syötteet & menetelmät
Ailoot Ultra · Video POST /v1/videos
- Syötetyypit
text,image,audio,video- Tulostyypit
video- Tulosteen muoto
- alkuperäiset MP4-tavut; ei normalisointia eikä uudelleenkoodausta
| Kenttä | Tyyppi | Vaatimus | Arvot & rajat | Oletus |
|---|---|---|---|---|
Kenttämodel | Tyyppistring | VaatimusPakollinen | Arvot & rajat heygen/heygen-video-1 | Oletus— |
Kenttäprompt | Tyyppistring | VaatimusPakollinen | Arvot & rajat | Oletus— |
Kenttäduration | Tyyppiinteger | VaatimusPakollinen | Arvot & rajat 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 Vähimmäismäärä: 1 Enimmäismäärä: 600 | Oletus— |
Kenttäresolution | Tyyppistring | VaatimusValinnainen | Arvot & rajat 480p, 768p, 2K | Oletus— |
Kenttäaspect_ratio | Tyyppistring | VaatimusValinnainen | Arvot & rajat 21:9, 16:9, 4:3, 1:1, 3:4, 9:16 | Oletus— |
Kenttägenerate_audio | Tyyppiboolean | VaatimusValinnainen | Arvot & rajat false | Oletus— |
Kenttäframe_images | Tyyppiarray | VaatimusValinnainen | Arvot & rajat Kohteiden vähimmäismäärä: 1 Kohteiden enimmäismäärä: 1 Syötteen sisältö: Kuvaolioiden taulukko. Jokaisessa oliossa on type=image_url, url-kentän sisältävä image_url ja frame_type. Käytä HTTPS-kuvan URL-osoitetta ja aseta frame_type-kentän arvoksi first_frame. Kukin kuvan rooli esiintyy enintään kerran. Tarkat avaimet: type, image_url, frame_type Ehdot: Nämä avaimet kuvaavat jokaista kuvaoliota; image_url sisältää vain url-kentän. Jätä frame_images pois pelkkää tekstiä sisältävästä pyynnöstä. | Oletus— |
Kenttäinput_references | Tyyppiarray | VaatimusValinnainen | Arvot & rajat | Oletus— |
Kenttäseed | Tyyppiinteger | VaatimusValinnainen | Arvot & rajat Vähimmäismäärä: −9 223 372 036 854 775 808 Enimmäismäärä: 9 223 372 036 854 775 807 | Oletus— |
Kenttäcallback_url | Tyyppistring | VaatimusValinnainen | Arvot & rajat Merkkijonomalli: ^https:// | Oletus— |
Kenttäsession_id | Tyyppistring | VaatimusValinnainen | Arvot & rajat | Oletus— |
Kenttätrace | Tyyppiobject | VaatimusValinnainen | Arvot & rajat | Oletus— |
Kenttäuser | Tyyppistring | VaatimusValinnainen | Arvot & rajat | Oletus— |
Syöteaineistojen yhdistelmät
Tekstistä videoksi · Kirjoitettu kehote. · Pakollinen: model, prompt, duration
Anna kehote tekstinä ja kesto kokonaisina sekunteina. Valitse tuettu resoluutio ja tarvittaessa kuvasuhde.
model: Tyyppi: string · heygen/heygen-video-1
prompt: Tyyppi: string · UTF-8-tavujen enimmäismäärä: 10 000 · Vaaditaan muu merkki kuin tyhjämerkki: Kyllä
Kuvasta videoksi · Kirjoitettu kehote ja ensimmäisen ruudun kuva. · Pakollinen: model, prompt, duration, frame_images
frame_images on taulukko. Jokaisessa kuvaoliossa on type, image_url ja frame_type; image_url sisältää url-kentän. Aseta type-kentän arvoksi image_url. Käytä first_frame-arvoa. Kukin kuvan rooli esiintyy enintään kerran. Anna jokaiselle kuvalle julkinen HTTPS-kuvan URL-osoite. Valitse tuettu resoluutio ja tarvittaessa kuvasuhde.
Tarkat avaimet: type, image_url, frame_type
model: Tyyppi: string · heygen/heygen-video-1
prompt: Tyyppi: string · UTF-8-tavujen enimmäismäärä: 10 000 · Vaaditaan muu merkki kuin tyhjämerkki: Kyllä
Reference to video · Kirjoitettu kehote ja tuetut kuva-, video- ja ääniviitteet. · Pakollinen: model, prompt, duration, input_references
input_references on oliotaulukko. Aseta type-kentän arvoksi image_url, video_url tai audio_url ja käytä vastaavaa url-kentän sisältävää kenttää. Käytä julkisia HTTPS-osoitteita. Jätä frame_images pois valitaksesi viitetilan. Valitse tuettu resoluutio ja tarvittaessa kuvasuhde.
model: Tyyppi: string · heygen/heygen-video-1
prompt: Tyyppi: string · UTF-8-tavujen enimmäismäärä: 10 000 · Vaaditaan muu merkki kuin tyhjämerkki: Kyllä
Menetelmän parametrit ja elinkaari
| Parametri | Sopimus |
|---|---|
Parametricontent_type | Sopimusapplication/json |
Parametrirequired | Sopimusmodel, prompt, duration |
Parametrimaterial_types | Sopimustext, image, audio, video |
Parametriadditional_properties | Sopimusfalse |
Parametrioptional_controls | Sopimusresolution, aspect_ratio, generate_audio, frame_images, input_references, seed, callback_url, session_id, trace, user |
Elinkaari: submit_once_poll_original
GET /v1/videos/{public_id}
GET /v1/videos/{public_id}/content
Hinnoittelu
Lopullisen veloituksen laskenta
Näytettyjen hintojen avulla arvioidaan kustannukset ennen generointia. Lopullinen veloitus lasketaan alkuperäiselle generoinnille kirjatun kustannuksen perusteella. Lopullisena laskutettavana määränä ei käytetä tulosteen mitattua kestoa eikä ennustettuja määriä.
Hintatiedot eivät lisää pyyntövalintoja. Tuetut parametrit on lueteltu valitulle menetelmälle.
- Nopea tila
- Ei määritetty Kun nopea tila on valittu
- Flex-tila
- Ei määritetty Kun flex-tila on valittu
- Päättelyn enimmäisteho
- Ei määritetty Kun päättelyn enimmäistehoon sovelletaan default-oletussäätöä
Arvioidut vertailuhinnat
Hinnat asetusten mukaan
Kohdista kukin veloitus näytettyihin ehtoihin. Käytä yhtä hintaa kutakin vaihtoehtoisten asetusten ryhmää kohden.
| Asetukset | Hinnasto | Ennustettu määrä | Laskutusyksikkö | Laskutusehdot | Veloitus |
|---|---|---|---|---|---|
| AsetuksetTokenien perushinnat | HinnastoPerushinta | Ennustettu määrä— | Laskutusyksikkö— | Laskutusehdot— | Veloitus Syöte · Syötetokenit · Arvio vain vertailua varten — / 1K tokenia Tuloste · Tulostokenit · Arvio vain vertailua varten — / 1K tokenia Syöte · Välimuistin luku · Arvio vain vertailua varten — / 1K tokenia Syöte · Välimuistiin kirjoitus · Arvio vain vertailua varten — / 1K tokenia Syöte · Välimuistiin kirjoitus, 1 tunti · Arvio vain vertailua varten — / 1K tokenia |
| AsetuksetVideon hinta | Hinnasto— | Ennustettu määrä— | Laskutusyksikkövideosekuntia kohden | Laskutusehdotresolution: 2k | Veloitus Tuloste · Videon hinta · Arvio vain vertailua varten $0.2 videosekuntia kohden |
| AsetuksetVideon hinta | Hinnasto— | Ennustettu määrä— | Laskutusyksikkövideosekuntia kohden | Laskutusehdotresolution: 480p | Veloitus Tuloste · Videon hinta · Arvio vain vertailua varten $0.04 videosekuntia kohden |
| AsetuksetVideon hinta | Hinnasto— | Ennustettu määrä— | Laskutusyksikkövideosekuntia kohden | Laskutusehdotresolution: 768p | Veloitus Tuloste · Videon hinta · Arvio vain vertailua varten $0.072 videosekuntia kohden |
| AsetuksetVideon hinta | Hinnasto— | Ennustettu määrä— | Laskutusyksikkövideosekuntia kohden | Laskutusehdotluontitila: reference; resoluutio: 2k | Veloitus Tuloste · Videon hinta · Arvio vain vertailua varten $0.36 videosekuntia kohden |
| AsetuksetVideon hinta | Hinnasto— | Ennustettu määrä— | Laskutusyksikkövideosekuntia kohden | Laskutusehdotluontitila: reference; resoluutio: 480p | Veloitus Tuloste · Videon hinta · Arvio vain vertailua varten $0.14 videosekuntia kohden |
| AsetuksetVideon hinta | Hinnasto— | Ennustettu määrä— | Laskutusyksikkövideosekuntia kohden | Laskutusehdotluontitila: reference; resoluutio: 768p | Veloitus Tuloste · Videon hinta · Arvio vain vertailua varten $0.2 videosekuntia kohden |
| Asetuksetviitekuva syötteenä | Hinnasto— | Ennustettu määrä— | Laskutusyksikköviitesyötekuvaa kohden | Laskutusehdot— | Veloitus Syöte · viitekuva syötteenä · Arvio vain vertailua varten $0.08 viitesyötekuvaa kohden |
| AsetuksetArvioitu luontikustannus | Hinnasto— | Ennustettu määräyhden generoinnin arvio | Laskutusyksikkö— | Laskutusehdot— | Veloitus Tuloste · Arvioidut generointikustannukset · Arvio vain vertailua varten $0.2 arvio ennen generointia Tämä arvio ei ole lisämaksu eikä valmistuneen generoinnin kiinteä hinta. |
Ailoot varaa arvioidun summan ennen pyyntöä. Tuloksen jälkeen lopullinen veloitus toteutetaan mitatun käytön perusteella. Suoratoiston veloituksessa käytetään lopullista käyttötietuetta. Varauksen ja lopullisen veloituksen toiminta →
Viitehinnaston tiedot
Mallitason viitehinnastot eivät muuta menetelmän valintaa, hinta-arvioita tai veloituksia. Käytössä olevat veloitukset käyttävät valitun Ailoot-menetelmän hintoja.
Videokokoonpanojen hintaviitteet
Hinnat asetusten mukaan
Kohdista kukin veloitus näytettyihin ehtoihin. Käytä yhtä hintaa kutakin vaihtoehtoisten asetusten ryhmää kohden.
| Asetukset | Laskutusehdot | Veloitus |
|---|---|---|
| AsetuksetVideon hinta | Laskutusehdotresolution: 2k | Veloitus Tuloste · Videon hinta $0.18 videosekuntia kohden Julkaistu hintaviite näytetylle kokoonpanolle. Lopulliset veloitukset määräytyvät todellisen laskutetun kokoonpanon mukaan. |
| AsetuksetVideon hinta | Laskutusehdotresolution: 480p | Veloitus Tuloste · Videon hinta $0.04 videosekuntia kohden Julkaistu hintaviite näytetylle kokoonpanolle. Lopulliset veloitukset määräytyvät todellisen laskutetun kokoonpanon mukaan. |
| AsetuksetVideon hinta | Laskutusehdotresolution: 768p | Veloitus Tuloste · Videon hinta $0.06 videosekuntia kohden Julkaistu hintaviite näytetylle kokoonpanolle. Lopulliset veloitukset määräytyvät todellisen laskutetun kokoonpanon mukaan. |
| AsetuksetVideon hinta | Laskutusehdotluontitila: reference; resoluutio: 2k | Veloitus Tuloste · Videon hinta $0.36 videosekuntia kohden Julkaistu hintaviite näytetylle kokoonpanolle. Lopulliset veloitukset määräytyvät todellisen laskutetun kokoonpanon mukaan. |
| AsetuksetVideon hinta | Laskutusehdotluontitila: reference; resoluutio: 480p | Veloitus Tuloste · Videon hinta $0.08 videosekuntia kohden Julkaistu hintaviite näytetylle kokoonpanolle. Lopulliset veloitukset määräytyvät todellisen laskutetun kokoonpanon mukaan. |
| AsetuksetVideon hinta | Laskutusehdotluontitila: reference; resoluutio: 768p | Veloitus Tuloste · Videon hinta $0.12 videosekuntia kohden Julkaistu hintaviite näytetylle kokoonpanolle. Lopulliset veloitukset määräytyvät todellisen laskutetun kokoonpanon mukaan. |
Esimerkkipyynnöt
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
Vastaanota ja tallenna tulokset
Ailoot Ultra · Video
allekirjoitetut käyttäjälle kuuluvan sisällön osoitteet
GET /v1/videos/{public_id}GET /v1/videos/{public_id}/content
Tarkista työn tila
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
Muut sisällön lukukerrat
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
Säilytä kaikki valmistuneet tulokset
Tallenna jokainen valmistunut video tai palautettu tiedosto; nouda jokainen todellinen palautettu aineiston URL.
Säilytä jokainen todellinen käyttäjälle kuuluva tulos ja sen mukana palautetut mitatut metatiedot.
Jos alkuperäinen vastaus on tarkistettava
503 result_pending_check + alkuperäinen id + X-Should-Retry:false; älä koskaan toista alkuperäistä pyyntöä
Vastauksen kentät
| Kenttä | Tyyppi | Merkitys |
|---|---|---|
Kenttäindex | Tyyppiinteger | MerkitysTämän videon nollasta alkava sijainti tulosluettelossa. |
Kenttäcontent_url | Tyyppistring | MerkitysAllekirjoitettu HTTPS-latauksen URL-osoite tälle valmistuneelle videolle. |
Kenttäsha256 | Tyyppistring | null | MerkitysAlkuperäisten videotavujen SHA-256-tiiviste; null, jos tietoa ei ole saatavilla. |
Kenttäsize_bytes | Tyyppiinteger | null | MerkitysAlkuperäisen videotiedoston koko tavuina; null, jos tietoa ei ole saatavilla. |
Kenttäduration_ms | Tyyppiinteger | null | MerkitysVideon mitattu kesto millisekunteina; null, jos tietoa ei ole saatavilla. |
Kenttäwidth | Tyyppiinteger | null | MerkitysVideon leveys pikseleinä; null, jos tietoa ei ole saatavilla. |
Kenttäheight | Tyyppiinteger | null | MerkitysVideon korkeus pikseleinä; null, jos tietoa ei ole saatavilla. |
Kenttävideo_codec | Tyyppistring | null | MerkitysVideokoodekin tunniste; null, jos sitä ei ole kirjattu. |
Kenttähas_audio | Tyyppiboolean | null | MerkitysSisältääkö video ääniraidan; null, jos asiaa ei ole mitattu. |
Kenttäaudio_codec | Tyyppistring | null | MerkitysÄänikoodekin tunniste; null, jos tunnistetta ei ole kirjattu. |
Virheet ja seuraavat vaiheet
| Vastaus | Ehto | Seuraava vaihe |
|---|---|---|
Vastaus404 · not_found_error | EhtoVideoon ei päästä käsiksi tai tätä videon tunnistetta ei löytynyt. | Seuraava vaiheTarkista videon käyttöoikeus. Käytä olemassa olevan videon alkuperäistä julkista tunnistetta ja samaa API-avainta. |
Vastaus401 · authentication_error | EhtoAPI-avain ei vastaa todennettua tiliä. | Seuraava vaiheTarkista API-avaimesi ja tilisi käyttöoikeus ennen lähettämistä. |
Vastaus400 · invalid_request_error | EhtoPyyntöä ei voitu lukea tai latausindeksi on virheellinen. | Seuraava vaiheKorjaa pyyntösisältö. Valitse latausta varten alkuperäisen tehtävän palauttama tulosindeksi. |
Vastaus422 · price_unavailable | EhtoValittua videokokoonpanoa ei voida hinnoitella. | Seuraava vaiheValitse tuettu videokokoonpano ja täytä sen pakolliset asetukset ennen korjatun pyynnön lähettämistä. |
Vastaus422 · invalid_request_error | EhtoVideosyöte tai alkuperäinen jatkotehtävä on virheellinen. | Seuraava vaiheKäytä kelvollisia HTTPS-syötteitä. Käytä jatkamiseen valmistuneen alkuperäisen videosi julkista tunnistetta samalla API-avaimella. |
Vastaus402 · billing_error | EhtoKäytettävissä oleva saldo tai rajoitukset eivät salli katevarausta. | Seuraava vaiheTarkista käytettävissä oleva saldosi ja rajoitukset ennen uuden pyynnön lähettämistä. |
Vastaus503 · server_error | EhtoVideon tarkistus, tallennus tai palvelun käyttö ei ole tilapäisesti saatavilla. | Seuraava vaiheOdota palvelun saatavuutta. Jos sinulla on jo videon tunniste, tarkista alkuperäinen tehtävä uuden luontipyynnön lähettämisen sijaan. |
Vastaus503 · result_pending_check | EhtoAlkuperäinen videotulos ja veloitus on tarkistettava. | Seuraava vaiheSäilytä palautettu videon tunniste ja tarkista kyseinen tehtävä. Älä lähetä korvaavaa videon luontipyyntöä tarkistuksen aikana. |
Vastaus503 · owned_result_unavailable | EhtoOlemassa olevan videon lataus ei ole tilapäisesti saatavilla. | Seuraava vaiheTarkista sama videotehtävä myöhemmin ja lataa sen olemassa oleva tulos. Uusi luontipyyntö luo erillisen operaation. |
Vastaus409 · video_not_ready | EhtoVideosisältöä ei ole julkaistu. | Seuraava vaiheTarkista alkuperäisen tehtävän tila. Lataa, kun tila on completed; jos tila on failed, noudata sen veloituksen tarkistusilmoitusta. |
Aliakset
Mallin aliakset
Ailoot Ultra heygen/heygen-video-1
Menetelmäpolkujen aliakset
Käytä yllä näytettyjä menetelmäpolkuja.
Liittyvät kutsujan ID:t
FAQ · HeyGen: HeyGen Video
- Mitä syötteitä ja tuloksia on saatavilla?
POST /v1/videos·heygen/heygen-video-1:text,image,audio,video→video- Mitä kenttiä pyyntö käyttää?
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- Mitä rajoja sovelletaan?
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