Source: https://ailoot.ai/models/fi/heygen-heygen-video-1/
Canonical: https://ailoot.ai/models/fi/heygen-heygen-video-1/
Language: fi

# HeyGen: HeyGen Video

[Markdown](https://ailoot.ai/models/fi/heygen-heygen-video-1/index.md) · [JSON](https://ailoot.ai/models/fi/heygen-heygen-video-1/facts.json)

## [HeyGen: HeyGen Video](https://ailoot.ai/models/fi/heygen-heygen-video-1/)

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.

- [**Ailoot Ultra · Video** `POST /v1/videos` `heygen/heygen-video-1`](https://ailoot.ai/models/fi/heygen-heygen-video-1/#method-0)

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-1`](https://ailoot.ai/models/fi/#m=heygen%2Fheygen-video-1&route=Ultra&caller=heygen%2Fheygen-video-1&fmt=videos)

HeyGen /`heygen/heygen-video-1`

### Aloitus

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` | Tyyppi`string` | VaatimusPakollinen | Arvot & rajat heygen/heygen-video-1 | Oletus— |
| Kenttä`prompt` | Tyyppi`string` | VaatimusPakollinen | Arvot & rajat | Oletus— |
| Kenttä`duration` | Tyyppi`integer` | 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` | Tyyppi`string` | VaatimusValinnainen | Arvot & rajat 480p, 768p, 2K | Oletus— |
| Kenttä`aspect_ratio` | Tyyppi`string` | VaatimusValinnainen | Arvot & rajat 21:9, 16:9, 4:3, 1:1, 3:4, 9:16 | Oletus— |
| Kenttä`generate_audio` | Tyyppi`boolean` | VaatimusValinnainen | Arvot & rajat false | Oletus— |
| Kenttä`frame_images` | Tyyppi`array` | 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` | Tyyppi`array` | VaatimusValinnainen | Arvot & rajat | Oletus— |
| Kenttä`seed` | Tyyppi`integer` | 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` | Tyyppi`string` | VaatimusValinnainen | Arvot & rajat Merkkijonomalli: ^https:// | Oletus— |
| Kenttä`session_id` | Tyyppi`string` | VaatimusValinnainen | Arvot & rajat | Oletus— |
| Kenttä`trace` | Tyyppi`object` | VaatimusValinnainen | Arvot & rajat | Oletus— |
| Kenttä`user` | Tyyppi`string` | 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 |
| --- | --- |
| Parametri`content_type` | Sopimusapplication/json |
| Parametri`required` | Sopimusmodel, prompt, duration |
| Parametri`material_types` | Sopimustext, image, audio, video |
| Parametri`additional_properties` | Sopimusfalse |
| Parametri`optional_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 →](https://ailoot.ai/docs/fi/billing/reserve/)

#### 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

curl · luo video

```bash
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

GET alkuperäisen toiminnon tila

```bash
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

Tallenna jokainen valmistunut omistamasi tuloste

```bash
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`](https://ailoot.ai/models/fi/#m=heygen%2Fheygen-video-1&route=Ultra&caller=heygen%2Fheygen-video-1&fmt=videos)

#### Menetelmäpolkujen aliakset

Käytä yllä näytettyjä menetelmäpolkuja.

#### Liittyvät kutsujan ID:t

[`heygen/heygen-video-1`](https://ailoot.ai/models/fi/#m=heygen%2Fheygen-video-1&route=Ultra&caller=heygen%2Fheygen-video-1&fmt=videos)

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`

Yhdistä Ailoot Claude Codeen, OpenCodeen, Hermesiin tai omaan sovellukseesi.

## Yritys ja sen projektisalkku

Yritys ja sen projektisalkku: miljoonia asiakkaita; kuukausittainen myynti miljardiluokassa.

## Osta tokenit alennuksella.

Tilausalennus säännölliseen käyttöön. Kampanjakoodit — jopa 50% tokeniostoista.

Tilaus

Valitse alennushintainen paketti säännöllisiä pyyntöjäsi varten.

Kampanjakoodi jopa 50%

Syötä koodi oston yhteydessä. Hinta lasketaan uudelleen voimassa olevan kampanjan mukaan.

Kulut historiassa

Malli, tokenit ja summa tallennetaan jokaiselle pyynnölle.

[Valitse tilaus](https://ailoot.ai/docs/fi/billing/subscriptions/) · [Katso mallihinnat](https://ailoot.ai/models/fi/)

## Yhdistä API tuotteeseen, jonka myyt.

SaaS, sovellukset ja botit Ailootin palveluehtojen ja lisenssisopimuksen mukaisesti. Pyydä edelleenmyyntiin jälleenmyyjälisenssi.

Kaupallinen sovellus

Lisää tekstin, kuvien, videoiden ja äänen luonti palvelusi maksullisiin ominaisuuksiin.

Jälleenmyyjälisenssi

Lähetä projektikuvaus ja pääsyn toteutustapa. Pyydä kirjalliset käyttö- ja jälleenmyyntiehdot.

Asiakirjat verkkosivustolla

Palveluehdot, lisenssisopimus ja tietojenkäsittelykäytäntö ovat saatavilla ennen yhdistämistä.

[Pyydä jälleenmyyjälisenssi](mailto:support@ailoot.ai) · [Palveluehdot ja lisenssisopimus](https://ailoot.ai/legal/offer?lang=fi)

## Ailoot · Yritys ja sen projektisalkku





Ailoot perustuu kertyneeseen toimintakokemukseen, laajaan asiakaskuntaan, vakaaseen palveluun ja jatkuvaan KPI-seurantaan.





Yritys ja sen projektisalkku: miljoonia asiakkaita; kuukausittainen myynti miljardiluokassa.





Ailoot hyödyntää tätä toimintakokemusta tarjotessaan API-yhteyden tekoälytoimintoihin asiakkaiden tuotteissa, agenteissa, sovelluksissa ja automaatioissa.