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

# HeyGen: HeyGen Video

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

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

HeyGen Video generuje sceny 5–15 sekund z dialogiem, atmosferą i efektami z tekstu, pierwszego obrazu lub referencji wizualnych i audio. Uniwersalny model heygen-video-1 obsługuje ujęcia produktów i postaci, z parametrami referencji i wyjściem MP4. Jasne, ograniczone działania tworzą użyteczny brief produkcyjny.

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

O modelu

Ten opis przedstawia możliwości modelu. Dane wejściowe, wyniki i opcje dostępne w Ailoot podano poniżej dla wybranej metody.

HeyGen Video to uniwersalny model generowania scen HeyGen, identyfikowany przez producenta jako heygen-video-1. Tworzy wspólnie podmiot, scenerię, światło i dźwięk z briefu twórczego. Każdy klip trwa 5–15 sekund i zawiera wygenerowaną ścieżkę audio, w tym dialog, atmosferę i efekty. Użyteczne wejścia produkcyjne obejmują opis sceny, fotografię produktu lub materiał ustanawiający osobę, miejsce bądź ruch. Powstały materiał jest krótką sceną do prezentacji produktu, wstawki wdrożeniowej, widoku nieruchomości lub innych montowanych filmów.

Trzy tryby nadają wejściom różne role. Text-to-video tworzy scenę z promptu. Image-to-video zaczyna dosłownie od dostarczonego obrazu, a następnie realizuje brief akcji. Reference-to-video używa dostarczonych obrazów, wideo i opcjonalnego audio do prowadzenia nowo skomponowanej sceny; wymaga co najmniej jednego obrazu lub filmu referencyjnego. Wybierz obraz pierwszej klatki, gdy kompozycja otwarcia musi odpowiadać obrazowi, albo referencje, gdy znany obiekt ma pojawić się w innej kompozycji. Ten model scen różni się od silników renderowania awatarów HeyGen i procesu kompozycji Video Agent.

Przewodnik producenta preferuje szczegółowe, konkretne wskazówki ujęć: jeden podmiot, jedno miejsce i jedno ograniczone działanie, z nieruchomą lub delikatnie poruszającą się kamerą. Opisz pozycję kamery, obiektyw lub zamysł głębi ostrości, światło, fakturę powierzchni i opracowanie koloru. Wyjaśnij miejsca kontaktu obiektów, gdy akcja zależy od dotyku. W oryginalnym przykładzie produktu użyj fotografii referencyjnej termosu podróżnego i poproś o jego ustawienie na drewnianym blacie, gdy prezenter mówi obok, z małym ruchem kamery ku termosowi. Sprawdź jego formę, położenie i widoczne oznaczenia w wyniku.

Listy referencji obsługują do dziewięciu obrazów, trzech filmów i trzech materiałów audio, maksymalnie dwanaście referencji łącznie. Obrazy, filmy i audio są numerowane osobno w formacie promptu producenta: pierwszy obraz to \<Picture 1\>, a pierwszy film \<Video 1\>. Nadaj każdej referencji rolę i określ ją jawnie w briefie. Model czyta pierwsze pięć sekund każdego filmu referencyjnego, więc przygotuj właściwy fragment na początku. Dokumentacja API określa też proporcje filmów referencyjnych od 1:4 do 4:1. Długi klip zawierający pożądany ruch dopiero na końcu jest źle przygotowany do tego pięciosekundowego okna wejścia.

Udokumentowany interfejs referencyjny przyjmuje bezpośrednio dostępny zasób HTTPS, identyfikator przesłanego materiału lub base64 w treści. Przewodnik wymienia maksymalny rozmiar obrazów 16 MB przez URL i 5 MB w treści; wideo lub audio może mieć do 32 MB przez URL i 16 MB w treści. Przygotuj czytelny materiał źródłowy z łatwym do rozróżnienia ważnym podmiotem i bez konkurujących instrukcji w różnych referencjach. Zachowaj zamierzoną orientację w obrazie pierwszej klatki. Te szczegóły wejścia dotyczą referencyjnego procesu producenta i pomagają uporządkować materiały twórcze do wybranego trybu.

Reżyseruj dźwięk w tym samym briefie co obraz. Podaj dialog, sposób wypowiedzi, dźwięki pomieszczenia i konkretne efekty, w tym ich bliskość lub oddalenie. Określ zamierzone opracowanie muzyki, gdy scena ma zawierać tylko mowę i atmosferę. Przewodnik sugeruje około 2,5 wypowiadanego słowa na sekundę jako szacunek planistyczny, więc pozostaw czas na pauzy i widoczną akcję. Krótkie wprowadzenie można zaplanować jako jedną kwestię, po której następuje moment ujawniający produkt. Odsłuchaj rzeczywiste słowa i dopasowanie wygenerowanego dźwięku do przestrzeni oraz akcji.

Długość wyjścia wybiera się w pełnych sekundach od pięciu do piętnastu, z pięcioma sekundami jako wartością domyślną. Rozdzielczość jest klasą rozmiaru: 480p, 768p, 1080p lub 2k. Udokumentowane wybory kadrowania to 21:9, 16:9, 4:3, 1:1, 3:4 i 9:16. Dla text-to-video i reference-to-video w 1080p lub 2k wybierz 16:9 lub 9:16; adaptacyjne kadrowanie referencji jest udokumentowane w 480p i 768p. Image-to-video podąża za proporcjami pierwszego obrazu, więc przy zmianie wymaganego kształtu przytnij go przed generacją. Sprawdź rzeczywiste wymiary ukończonego wyniku, zamiast zakładać, że etykieta klasy rozmiaru oznacza jedną standardową parę pikseli.

Przewodnik modelu określa wideo MP4 z kodowaniem obrazu H.264 i audio AAC 32 kHz stereo. Generacja jest przetwarzana asynchronicznie, a ukończone zadanie dostarcza adres odtwarzalnego wideo, długość i wymiary. Podpisany adres wideo można odświeżyć, pobierając zadanie ponownie. Zachowaj rzeczywisty klip, materiały referencyjne i brief do oceny montażowej. Zapis oczekiwania lub przetwarzania śledzi generację; ukończony film jest materiałem produkcyjnym do oceny obrazu, mowy i dźwięku.

Producent dokumentuje wybory ulepszania promptu turbo, quality i disabled; disabled zachowuje przygotowany tekst bez zmian. Stały seed przydaje się do porównywania zmiany jednej klauzuli przy zachowaniu innych wejść. Zapisz wybrany seed i ustawienia wraz z briefem ujęcia. Dla liter na ekranie utrzymuj zamierzoną frazę krótką i zapisz ją dokładnie; przewodnik zaleca późniejszą kompozycję akapitów, drobnego druku i podpisanych diagramów. Sprawdzaj każdy widoczny znak wygenerowanego tytułu, zamiast zakładać poprawne odtworzenie słów.

Przewodnik wskazuje długi tekst ekranowy, miękki organiczny ruch płatków, papieru lub włosów i bliskie manipulacje dłoni jako mniej niezawodne obszary. W objaśnieniu procedury pozwól jasno napisanej kwestii przekazywać kroki, gdy obraz pokazuje stabilną osobę lub przedmiot; gdy sama operacja fizyczna musi być dokładna, używaj osobno zweryfikowanych wizualizacji. Oceń całe ujęcie pod kątem ciągłości obiektów, kontaktu, detali twarzy i dłoni, dialogu oraz dźwięku. Zwięzła lista zmian na następne wykonanie utrzymuje szczegółowy brief produkcyjny w praktycznej formie.

**Ailoot Ultra · Wideo** `POST /v1/videos` `heygen/heygen-video-1`

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

HeyGen /`heygen/heygen-video-1`

### Start

HeyGen Video generuje sceny 5–15 sekund z dialogiem, atmosferą i efektami z tekstu, pierwszego obrazu lub referencji wizualnych i audio. Uniwersalny model heygen-video-1 obsługuje ujęcia produktów i postaci, z parametrami referencji i wyjściem MP4. Jasne, ograniczone działania tworzą użyteczny brief produkcyjny.

Akceptowane dane wejściowe

Tekst · Obrazy · Audio · Wideo

Wyniki

Wideo

### Dostępne w Ailoot · dane wejściowe i metody

**Ailoot Ultra · Wideo** `POST /v1/videos`

Wejście

`text`, `image`, `audio`, `video`

Wyjście

`video`

Format wyjściowy

oryginalne bajty MP4; bez normalizacji i transkodowania

| Pole | Typ | Wymaganie | Wartości i limity | Domyślnie |
| --- | --- | --- | --- | --- |
| Pole`model` | Typ`string` | WymaganieWymagane | Wartości i limity heygen/heygen-video-1 | Domyślnie— |
| Pole`prompt` | Typ`string` | WymaganieWymagane | Wartości i limity | Domyślnie— |
| Pole`duration` | Typ`integer` | WymaganieWymagane | Wartości i limity 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 Minimum: 1 Maksimum: 600 | Domyślnie— |
| Pole`resolution` | Typ`string` | WymaganieOpcjonalne | Wartości i limity 480p, 768p, 2K | Domyślnie— |
| Pole`aspect_ratio` | Typ`string` | WymaganieOpcjonalne | Wartości i limity 21:9, 16:9, 4:3, 1:1, 3:4, 9:16 | Domyślnie— |
| Pole`generate_audio` | Typ`boolean` | WymaganieOpcjonalne | Wartości i limity false | Domyślnie— |
| Pole`frame_images` | Typ`array` | WymaganieOpcjonalne | Wartości i limity Minimalna liczba elementów: 1 Maksymalna liczba elementów: 1 Treść wejściowa: Tablica obiektów klatek. Każdy obiekt zawiera type=image\_url, image\_url z polem url oraz frame\_type. Użyj adresu URL obrazu przez HTTPS i ustaw frame\_type na first\_frame. Każda rola klatki może wystąpić najwyżej raz. Dokładne klucze: type, image\_url, frame\_type Warunki: Te klucze opisują każdy obiekt klatki; image\_url zawiera wyłącznie url. Pomiń frame\_images w żądaniu zawierającym wyłącznie tekst. | Domyślnie— |
| Pole`input_references` | Typ`array` | WymaganieOpcjonalne | Wartości i limity | Domyślnie— |
| Pole`seed` | Typ`integer` | WymaganieOpcjonalne | Wartości i limity Minimum: -9 223 372 036 854 775 808 Maksimum: 9 223 372 036 854 775 807 | Domyślnie— |
| Pole`callback_url` | Typ`string` | WymaganieOpcjonalne | Wartości i limity Wzorzec: ^https:// | Domyślnie— |
| Pole`session_id` | Typ`string` | WymaganieOpcjonalne | Wartości i limity | Domyślnie— |
| Pole`trace` | Typ`object` | WymaganieOpcjonalne | Wartości i limity | Domyślnie— |
| Pole`user` | Typ`string` | WymaganieOpcjonalne | Wartości i limity | Domyślnie— |

Kombinacje materiałów wejściowych

**Tekst na wideo** · Prompt tekstowy. · Wymagane: model, prompt, duration

`Podaj prompt jako tekst, a czas trwania jako pełne sekundy. Wybierz obsługiwaną rozdzielczość i, w razie potrzeby, proporcje obrazu.`

`model`: Typ: string · heygen/heygen-video-1

`prompt`: Typ: string · Maksymalna liczba bajtów UTF-8: 10 000 · Wymagana treść inna niż białe znaki: Tak

**Obraz na wideo** · Prompt tekstowy i obraz pierwszej klatki. · Wymagane: model, prompt, duration, frame\_images

`frame_images to tablica. Każdy obiekt klatki zawiera type, image_url i frame_type; image_url zawiera url. Ustaw type na image_url. Użyj first_frame. Każda rola klatki może wystąpić najwyżej raz. Dla każdej klatki podaj publiczny URL obrazu przez HTTPS. Wybierz obsługiwaną rozdzielczość i, w razie potrzeby, proporcje obrazu.`

Dokładne klucze: type, image\_url, frame\_type

`model`: Typ: string · heygen/heygen-video-1

`prompt`: Typ: string · Maksymalna liczba bajtów UTF-8: 10 000 · Wymagana treść inna niż białe znaki: Tak

**Reference to video** · Prompt tekstowy oraz obsługiwane materiały referencyjne w postaci obrazów, wideo i dźwięku. · Wymagane: model, prompt, duration, input\_references

`input_references to tablica obiektów. Ustaw type na image_url, video_url lub audio_url i użyj odpowiadającego mu pola zawierającego url. Używaj publicznych adresów URL przez HTTPS. Pomiń frame_images, aby wybrać tryb materiałów referencyjnych. Wybierz obsługiwaną rozdzielczość i, w razie potrzeby, proporcje obrazu.`

`model`: Typ: string · heygen/heygen-video-1

`prompt`: Typ: string · Maksymalna liczba bajtów UTF-8: 10 000 · Wymagana treść inna niż białe znaki: Tak

Parametry i cykl życia metody

| Parametr | Kontrakt |
| --- | --- |
| Parametr`content_type` | Kontraktapplication/json |
| Parametr`required` | Kontraktmodel, prompt, duration |
| Parametr`material_types` | Kontrakttext, image, audio, video |
| Parametr`additional_properties` | Kontraktfalse |
| Parametr`optional_controls` | Kontraktresolution, aspect\_ratio, generate\_audio, frame\_images, input\_references, seed, callback\_url, session\_id, trace, user |

Cykl życia: `submit_once_poll_original`

`GET /v1/videos/{public_id}`

`GET /v1/videos/{public_id}/content`

### Cennik

##### Jak obliczana jest ostateczna opłata

Wyświetlane stawki służą do oszacowania kosztu przed generowaniem. Ostateczna opłata jest obliczana na podstawie kosztu zarejestrowanego dla pierwotnego generowania. Zmierzony czas trwania wyniku i prognozowane ilości nie stanowią ostatecznej ilości podlegającej rozliczeniu.

Informacje taryfowe nie dodają opcji żądania. Obsługiwane parametry podano przy wybranej metodzie.

Tryb szybki

Nie określono Gdy wybrany jest tryb szybki

Tryb flex

Nie określono Gdy wybrany jest tryb flex

Maksymalna intensywność rozumowania

Nie określono Gdy dla maksymalnej intensywności rozumowania stosowana jest domyślna korekta (default)

#### Szacunkowe stawki do porównania

#### Ceny według konfiguracji

Dopasuj każdą opłatę do pokazanych warunków. Użyj jednej stawki dla każdego zestawu alternatywnych konfiguracji.

| Konfiguracja | Tabela stawek | Przewidywana ilość | Jednostka rozliczeniowa | Warunki rozliczania | Opłata |
| --- | --- | --- | --- | --- | --- |
| KonfiguracjaBazowe stawki za tokeny | Tabela stawekStawka podstawowa | Przewidywana ilość— | Jednostka rozliczeniowa— | Warunki rozliczania— | Opłata Wejście · Tokeny wejściowe · Szacunek tylko do porównania **—** / 1K tokenów Wyjście · Tokeny wyjściowe · Szacunek tylko do porównania **—** / 1K tokenów Wejście · Odczyt cache · Szacunek tylko do porównania **—** / 1K tokenów Wejście · Zapis do cache · Szacunek tylko do porównania **—** / 1K tokenów Wejście · Zapis do cache, 1 godz. · Szacunek tylko do porównania **—** / 1K tokenów |
| KonfiguracjaCena wideo | Tabela stawek— | Przewidywana ilość— | Jednostka rozliczeniowaza sekundę wideo | Warunki rozliczaniaresolution: 2k | Opłata Wyjście · Cena wideo · Szacunek tylko do porównania **$0.2** za sekundę wideo |
| KonfiguracjaCena wideo | Tabela stawek— | Przewidywana ilość— | Jednostka rozliczeniowaza sekundę wideo | Warunki rozliczaniaresolution: 480p | Opłata Wyjście · Cena wideo · Szacunek tylko do porównania **$0.04** za sekundę wideo |
| KonfiguracjaCena wideo | Tabela stawek— | Przewidywana ilość— | Jednostka rozliczeniowaza sekundę wideo | Warunki rozliczaniaresolution: 768p | Opłata Wyjście · Cena wideo · Szacunek tylko do porównania **$0.072** za sekundę wideo |
| KonfiguracjaCena wideo | Tabela stawek— | Przewidywana ilość— | Jednostka rozliczeniowaza sekundę wideo | Warunki rozliczaniatryb generowania: reference; rozdzielczość: 2k | Opłata Wyjście · Cena wideo · Szacunek tylko do porównania **$0.36** za sekundę wideo |
| KonfiguracjaCena wideo | Tabela stawek— | Przewidywana ilość— | Jednostka rozliczeniowaza sekundę wideo | Warunki rozliczaniatryb generowania: reference; rozdzielczość: 480p | Opłata Wyjście · Cena wideo · Szacunek tylko do porównania **$0.14** za sekundę wideo |
| KonfiguracjaCena wideo | Tabela stawek— | Przewidywana ilość— | Jednostka rozliczeniowaza sekundę wideo | Warunki rozliczaniatryb generowania: reference; rozdzielczość: 768p | Opłata Wyjście · Cena wideo · Szacunek tylko do porównania **$0.2** za sekundę wideo |
| Konfiguracjareferencyjny obraz wejściowy | Tabela stawek— | Przewidywana ilość— | Jednostka rozliczeniowaza wejściowy obraz referencyjny | Warunki rozliczania— | Opłata Wejście · referencyjny obraz wejściowy · Szacunek tylko do porównania **$0.08** za wejściowy obraz referencyjny |
| KonfiguracjaSzacowany koszt generowania | Tabela stawek— | Przewidywana ilośćszacunek dla jednego generowania | Jednostka rozliczeniowa— | Warunki rozliczania— | Opłata Wyjście · Szacowany koszt generowania · Szacunek tylko do porównania **$0.2** szacunek przed generowaniem Ten szacunek nie jest dodatkową opłatą ani stałą stawką za ukończone generowanie. |

Ailoot rezerwuje szacowaną kwotę przed żądaniem. Po otrzymaniu wyniku rozlicza ostateczną opłatę według zmierzonego użycia. Rozliczenie strumieniowania korzysta z końcowego rekordu użycia. [Jak działają rezerwacja i rozliczenie →](https://ailoot.ai/docs/pl/billing/reserve/)

#### Szczegóły taryfy referencyjnej

Referencyjne tabele modelu nie zmieniają wyboru metody, wyceny ani opłat. Naliczane opłaty korzystają ze stawek wybranej metody Ailoot.

Referencje cenowe konfiguracji wideo

#### Ceny według konfiguracji

Dopasuj każdą opłatę do pokazanych warunków. Użyj jednej stawki dla każdego zestawu alternatywnych konfiguracji.

| Konfiguracja | Warunki rozliczania | Opłata |
| --- | --- | --- |
| KonfiguracjaCena wideo | Warunki rozliczaniaresolution: 2k | Opłata Wyjście · Cena wideo **$0.18** za sekundę wideo Opublikowana cena referencyjna dla pokazanej konfiguracji. Ostateczne opłaty wynikają z faktycznie rozliczonej konfiguracji. |
| KonfiguracjaCena wideo | Warunki rozliczaniaresolution: 480p | Opłata Wyjście · Cena wideo **$0.04** za sekundę wideo Opublikowana cena referencyjna dla pokazanej konfiguracji. Ostateczne opłaty wynikają z faktycznie rozliczonej konfiguracji. |
| KonfiguracjaCena wideo | Warunki rozliczaniaresolution: 768p | Opłata Wyjście · Cena wideo **$0.06** za sekundę wideo Opublikowana cena referencyjna dla pokazanej konfiguracji. Ostateczne opłaty wynikają z faktycznie rozliczonej konfiguracji. |
| KonfiguracjaCena wideo | Warunki rozliczaniatryb generowania: reference; rozdzielczość: 2k | Opłata Wyjście · Cena wideo **$0.36** za sekundę wideo Opublikowana cena referencyjna dla pokazanej konfiguracji. Ostateczne opłaty wynikają z faktycznie rozliczonej konfiguracji. |
| KonfiguracjaCena wideo | Warunki rozliczaniatryb generowania: reference; rozdzielczość: 480p | Opłata Wyjście · Cena wideo **$0.08** za sekundę wideo Opublikowana cena referencyjna dla pokazanej konfiguracji. Ostateczne opłaty wynikają z faktycznie rozliczonej konfiguracji. |
| KonfiguracjaCena wideo | Warunki rozliczaniatryb generowania: reference; rozdzielczość: 768p | Opłata Wyjście · Cena wideo **$0.12** za sekundę wideo Opublikowana cena referencyjna dla pokazanej konfiguracji. Ostateczne opłaty wynikają z faktycznie rozliczonej konfiguracji. |

### Przykładowe żądania

#### Ailoot Ultra · Wideo

curl · utwórz film

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

### Odbieranie i zapisywanie wyników

#### Ailoot Ultra · Wideo

podpisane adresy URL treści należących do użytkownika

- `GET /v1/videos/{public_id}`
- `GET /v1/videos/{public_id}/content`

##### Sprawdź status zadania

Pobierz status pierwotnej operacji przez GET

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

Inne odczyty treści

Zapisz każdy ukończony wynik, który należy do Ciebie

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

##### Zachowaj wszystkie ukończone wyniki

Zapisz każde ukończone wideo lub zwrócony plik; pobierz każdy faktycznie zwrócony URL zasobu.

Zachowaj wszystkie faktyczne wyniki należące do użytkownika oraz zwrócone metadane pomiarowe.

##### Jeśli trzeba sprawdzić pierwotną odpowiedź

503 result\_pending\_check + pierwotne id + X-Should-Retry:false; nigdy nie ponawiaj pierwotnego żądania

Pola odpowiedzi

| Pole | Typ | Znaczenie |
| --- | --- | --- |
| Pole`index` | Typinteger | ZnaczeniePozycja tego wideo na liście wyników, liczona od zera. |
| Pole`content_url` | Typstring | ZnaczeniePodpisany URL HTTPS do pobrania tego ukończonego wideo. |
| Pole`sha256` | Typstring \| null | ZnaczenieSkrót SHA-256 oryginalnych bajtów wideo; null, jeśli jest niedostępny. |
| Pole`size_bytes` | Typinteger \| null | ZnaczenieRozmiar oryginalnego pliku wideo w bajtach; null, jeśli jest niedostępny. |
| Pole`duration_ms` | Typinteger \| null | ZnaczenieZmierzony czas trwania wideo w milisekundach; null, jeśli jest niedostępny. |
| Pole`width` | Typinteger \| null | ZnaczenieSzerokość wideo w pikselach; null, jeśli jest niedostępna. |
| Pole`height` | Typinteger \| null | ZnaczenieWysokość wideo w pikselach; null, jeśli jest niedostępna. |
| Pole`video_codec` | Typstring \| null | ZnaczenieIdentyfikator kodeka wideo; null, jeśli go nie zapisano. |
| Pole`has_audio` | Typboolean \| null | ZnaczenieCzy wideo zawiera ścieżkę dźwiękową; null, jeśli tego nie zmierzono. |
| Pole`audio_codec` | Typstring \| null | ZnaczenieIdentyfikator kodeka dźwięku; null, gdy nie zapisano identyfikatora. |

Błędy i dalsze kroki

| Odpowiedź | Warunek | Następny krok |
| --- | --- | --- |
| Odpowiedź404 · `not_found_error` | WarunekNie można uzyskać dostępu do wideo albo nie znaleziono tego identyfikatora wideo. | Następny krokSprawdź dostęp do wideo. W przypadku istniejącego wideo użyj jego pierwotnego publicznego identyfikatora i tego samego klucza API. |
| Odpowiedź401 · `authentication_error` | WarunekKlucz API nie odpowiada uwierzytelnionemu kontu. | Następny krokSprawdź swój klucz API i dostęp do konta przed wysłaniem. |
| Odpowiedź400 · `invalid_request_error` | WarunekNie można odczytać żądania lub indeks pobierania jest nieprawidłowy. | Następny krokPopraw treść żądania. Przy pobieraniu wybierz indeks wyniku zwrócony przez pierwotne zadanie. |
| Odpowiedź422 · `price_unavailable` | WarunekNie można wycenić wybranej konfiguracji wideo. | Następny krokWybierz obsługiwaną konfigurację wideo i uzupełnij jej wymagane opcje przed wysłaniem poprawionego żądania. |
| Odpowiedź422 · `invalid_request_error` | WarunekWejściowe wideo lub pierwotne zadanie kontynuacji są nieprawidłowe. | Następny krokUżywaj prawidłowych danych wejściowych przez HTTPS. Do kontynuacji użyj publicznego identyfikatora ukończonego pierwotnego wideo z tym samym kluczem API. |
| Odpowiedź402 · `billing_error` | WarunekDostępne saldo lub limity nie pozwalają na rezerwację. | Następny krokSprawdź dostępne saldo i limity przed wysłaniem nowego żądania. |
| Odpowiedź503 · `server_error` | WarunekWeryfikacja wideo, magazyn lub dostęp do usługi są chwilowo niedostępne. | Następny krokPoczekaj na dostępność usługi. Jeśli masz już identyfikator wideo, sprawdź to pierwotne zadanie zamiast tworzyć kolejne generowanie. |
| Odpowiedź503 · `result_pending_check` | WarunekWynik pierwotnego wideo i opłata wymagają sprawdzenia. | Następny krokZachowaj zwrócony identyfikator wideo i sprawdzaj to zadanie. Nie wysyłaj zastępczego żądania generowania podczas jego sprawdzania. |
| Odpowiedź503 · `owned_result_unavailable` | WarunekPobieranie istniejącego wideo jest chwilowo niedostępne. | Następny krokSprawdź później to samo zadanie wideo i pobierz jego istniejący wynik. Nowe generowanie tworzy osobną operację. |
| Odpowiedź409 · `video_not_ready` | WarunekTreść wideo nie została opublikowana. | Następny krokSprawdź status pierwotnego zadania. Pobierz wynik po zgłoszeniu completed; jeśli zgłosi failed, postępuj zgodnie z komunikatem dotyczącym sprawdzenia opłaty. |

### Aliasy

#### Aliasy modelu

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

#### Aliasy ścieżek metod

Użyj ścieżek metod podanych powyżej.

#### Powiązane ID modeli

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

FAQ · HeyGen: HeyGen Video

Jakie dane wejściowe i wyniki są dostępne?

`POST /v1/videos` · `heygen/heygen-video-1`: `text`, `image`, `audio`, `video` → `video`

Jakich pól używa żądanie?

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

Jakie limity obowiązują?

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

Połącz Ailoot z Claude Code, OpenCode, Hermes albo własną aplikacją.

## Firma i jej portfel projektów

Firma i jej portfel projektów: miliony klientów; miesięczna sprzedaż liczona w miliardach.

## Kupuj tokeny z rabatem.

Rabat subskrypcji do regularnej pracy. Kody promocyjne — do 50% na tokeny.

Subskrypcja

Wybierz plan z rabatem do regularnych żądań.

Kod promocyjny do 50%

Wpisz kod przy zakupie. Cena zostanie przeliczona według aktualnej promocji.

Koszty w historii

Model, tokeny i kwota są zapisywane dla każdego żądania.

[Wybierz subskrypcję](https://ailoot.ai/docs/pl/billing/subscriptions/) · [Sprawdź ceny modeli](https://ailoot.ai/models/pl/)

## Połącz API z produktem, który sprzedajesz.

SaaS, aplikacje i boty na warunkach oferty i umowy licencyjnej Ailoot. Do odsprzedaży poproś o licencję resellerską.

Aplikacja komercyjna

Wbuduj generowanie tekstu, obrazów, wideo i dźwięku w płatne funkcje usługi.

Licencja resellerska

Prześlij opis projektu i schemat dostępu. Poproś o pisemne warunki używania i odsprzedaży.

Dokumenty na stronie

Oferta, umowa licencyjna i polityka przetwarzania danych są dostępne przed połączeniem.

[Poproś o licencję resellerską](mailto:support@ailoot.ai) · [Oferta i umowa licencyjna](https://ailoot.ai/legal/offer?lang=pl)

## Ailoot · Firma i jej portfel projektów





Ailoot opiera się na zgromadzonym doświadczeniu operacyjnym, szerokiej bazie klientów, stabilnej usłudze i stałej kontroli KPI.





Firma i jej portfel projektów: miliony klientów; miesięczna sprzedaż liczona w miliardach.





Ailoot wykorzystuje to doświadczenie operacyjne, zapewniając dostęp przez API do funkcji AI w produktach klientów, agentach, aplikacjach i automatyzacjach.