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

# HeyGen: HeyGen Video

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

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

HeyGen Video menjana adegan 5–15 saat dengan dialog, suasana dan kesan daripada teks, imej pertama atau rujukan visual serta audio. Model serba guna heygen-video-1 menyokong syot produk dan watak, dengan kawalan rujukan serta output MP4. Tindakan jelas dengan skop terbatas memberikan taklimat produksi yang berguna.

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

Tentang model

Huraian ini merangkumi keupayaan model. Input, output dan pilihan yang tersedia di Ailoot disenaraikan di bawah untuk kaedah yang dipilih.

HeyGen Video ialah model penjanaan adegan serba guna HeyGen, yang dikenal pasti oleh pengeluar sebagai heygen-video-1. Ia mencipta subjek, latar, cahaya dan bunyi bersama-sama daripada taklimat kreatif. Setiap klip sepanjang 5–15 saat dan mengandungi trek audio janaannya, termasuk dialog, suasana dan kesan. Input produksi berguna merangkumi penerangan adegan, foto produk atau bahan yang menetapkan orang, tempat atau pergerakan. Aset terhasil ialah adegan pendek untuk persembahan produk, sisipan pengenalan pengguna, pandangan hartanah atau kerja video suntingan lain.

Tiga mod memberikan input peranan berbeza. Teks-ke-video mencipta adegan daripada prompt. Imej-ke-video bermula tepat pada imej yang dibekalkan, kemudian mengikuti taklimat untuk tindakan. Rujukan-ke-video menggunakan imej, video dan audio pilihan yang dibekalkan untuk membimbing adegan yang baru dikomposisikan; ia memerlukan sekurang-kurangnya satu imej atau video rujukan. Pilih imej bingkai pertama apabila komposisi pembukaan mesti sepadan dengan imej pegun, atau rujukan apabila objek dikenali patut muncul dalam komposisi berbeza. Model adegan ini berbeza daripada enjin render avatar HeyGen dan aliran kerja komposisi Video Agent.

Panduan pembuat mengutamakan arahan syot terperinci dan konkrit: satu subjek, satu lokasi dan satu tindakan terbatas, dengan kamera terkunci atau bergerak lembut. Terangkan kedudukan kamera, tujuan kanta atau kedalaman medan, cahaya, tekstur permukaan dan olahan warna. Jelaskan tempat objek bersentuhan apabila tindakan bergantung pada sentuhan. Untuk contoh produk asal, gunakan foto rujukan termos perjalanan dan minta ia berdiri di atas kaunter kayu sementara penyampai bercakap di sebelahnya, dengan gerak kamera kecil ke arah termos. Periksa bentuk, peletakan dan tanda yang kelihatan pada termos dalam hasil.

Senarai rujukan menyokong sehingga sembilan imej, tiga video dan tiga item audio, dengan maksimum dua belas rujukan keseluruhan. Imej, video dan audio dinomborkan secara berasingan dalam format prompt pengeluar: imej pertama ialah \<Picture 1\>, dan video pertama ialah \<Video 1\>. Berikan setiap rujukan peranan dan kenal pasti peranan itu secara jelas dalam taklimat. Model membaca lima saat pertama setiap video rujukan, jadi sediakan bahagian berkaitan pada permulaan. Rujukan API turut menetapkan nisbah video rujukan antara 1:4 dengan 4:1. Klip panjang yang mengandungi gerakan dikehendaki hanya pada penghujungnya ialah persediaan yang kurang baik untuk tetingkap input lima saat itu.

Antara muka rujukan yang didokumentasikan menerima sumber HTTPS yang boleh dicapai secara terus, pengecam aset yang dimuat naik atau base64 sebaris. Panduan menyenaraikan saiz imej maksimum 16 MB melalui URL dan 5 MB sebaris; video atau audio boleh mencapai 32 MB melalui URL dan 16 MB sebaris. Sediakan bahan sumber yang mudah ditafsirkan dengan subjek penting mudah dibezakan dan tanpa arahan bersaing dalam rujukan berbeza. Kekalkan orientasi yang dimaksudkan dalam imej bingkai pertama. Butiran input ini berkaitan dengan aliran kerja rujukan pembuat dan membantu menyusun bahan kreatif untuk mod terpilih.

Arahkan bunyi dalam taklimat yang sama dengan gambar. Nyatakan dialog, penyampaian vokal, bunyi bilik dan kesan khusus, termasuk sama ada bunyi patut dekat atau jauh. Tetapkan olahan muzik yang dimaksudkan apabila adegan patut mengandungi pertuturan dan suasana sahaja. Panduan mencadangkan kira-kira 2.5 perkataan pertuturan sesaat sebagai anggaran perancangan, jadi tinggalkan ruang untuk jeda dan tindakan yang kelihatan. Pengenalan ringkas boleh dirancang sebagai satu baris diikuti detik yang mendedahkan produk. Dengar perkataan sebenar dan sama ada bunyi janaan sesuai dengan ruang serta tindakan.

Tempoh output dipilih dalam saat bulat daripada lima hingga lima belas, dengan lalai lima saat. Resolusi ialah kelas saiz: 480p, 768p, 1080p atau 2k. Pilihan pembingkaian yang didokumentasikan ialah 21:9, 16:9, 4:3, 1:1, 3:4 dan 9:16. Untuk teks-ke-video dan rujukan-ke-video pada 1080p atau 2k, pilih 16:9 atau 9:16; pembingkaian rujukan adaptif didokumentasikan pada 480p dan 768p. Imej-ke-video mengikuti nisbah imej pertama, jadi pangkas sebelum penjanaan apabila bentuk yang diperlukan berubah. Semak dimensi sebenar hasil lengkap, bukannya menganggap label kelas saiz menunjukkan satu pasangan piksel lazim.

Panduan model menetapkan video MP4 dengan pengekodan gambar H.264 dan audio AAC stereo pada 32 kHz. Penjanaan diproses secara tak segerak, dan tugas lengkap membekalkan lokasi video yang boleh dimainkan, tempoh dan dimensi. Lokasi video bertandatangannya boleh diperbaharui dengan mendapatkan semula tugas. Simpan klip sebenar, bahan rujukan dan taklimat untuk semakan penyuntingan. Rekod menunggu atau sedang diproses menjejak penjanaan; video lengkap ialah artifak produksi untuk dinilai dari segi gambar, pertuturan dan bunyi.

Pengeluar mendokumentasikan pilihan penambahbaikan prompt turbo, quality dan disabled; disabled mengekalkan susunan kata yang disediakan sebagaimana ditulis. Seed tetap berguna apabila membandingkan perubahan pada satu klausa sambil mengekalkan input lain. Rekod seed dan tetapan terpilih bersama taklimat syot. Untuk tulisan di skrin, pastikan frasa yang dimaksudkan pendek dan eja dengan tepat; panduan mengesyorkan perenggan, cetakan kecil dan rajah berlabel dikompositkan kemudian. Periksa setiap aksara yang kelihatan dalam tajuk janaan, bukannya menganggap susunan kata dihasilkan semula dengan betul.

Panduan mengenal pasti teks panjang di skrin, pergerakan organik lembut seperti kelopak, kertas atau rambut, serta manipulasi tangan dekat sebagai bidang kurang boleh diharap. Untuk penerangan prosedur, biarkan baris yang ditulis jelas menyampaikan langkah sementara imej menunjukkan orang atau objek yang stabil; gunakan visual yang disahkan secara berasingan apabila operasi fizikal itu sendiri mesti tepat. Semak seluruh syot untuk kesinambungan objek, sentuhan, butiran wajah dan tangan, dialog serta bunyi. Senarai ringkas perkara yang patut berubah dalam rakaman seterusnya memastikan taklimat produksi terperinci kekal praktikal.

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

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

HeyGen /`heygen/heygen-video-1`

### Pengenalan

HeyGen Video menjana adegan 5–15 saat dengan dialog, suasana dan kesan daripada teks, imej pertama atau rujukan visual serta audio. Model serba guna heygen-video-1 menyokong syot produk dan watak, dengan kawalan rujukan serta output MP4. Tindakan jelas dengan skop terbatas memberikan taklimat produksi yang berguna.

Input yang diterima

Teks · Imej · Audio · Video

Hasil

Video

### Tersedia di Ailoot · input & kaedah

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

Input

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

Output

`video`

Format output

bait MP4 asal; tanpa penormalan atau pengekodan semula

| Medan | Jenis | Keperluan | Nilai & had | Lalai |
| --- | --- | --- | --- | --- |
| Medan`model` | Jenis`string` | KeperluanDiperlukan | Nilai & had heygen/heygen-video-1 | Lalai— |
| Medan`prompt` | Jenis`string` | KeperluanDiperlukan | Nilai & had | Lalai— |
| Medan`duration` | Jenis`integer` | KeperluanDiperlukan | Nilai & had 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 Minimum: 1 Maksimum: 600 | Lalai— |
| Medan`resolution` | Jenis`string` | KeperluanPilihan | Nilai & had 480p, 768p, 2K | Lalai— |
| Medan`aspect_ratio` | Jenis`string` | KeperluanPilihan | Nilai & had 21:9, 16:9, 4:3, 1:1, 3:4, 9:16 | Lalai— |
| Medan`generate_audio` | Jenis`boolean` | KeperluanPilihan | Nilai & had false | Lalai— |
| Medan`frame_images` | Jenis`array` | KeperluanPilihan | Nilai & had Item minimum: 1 Item maksimum: 1 Kandungan input: Tatasusunan objek bingkai. Setiap objek mempunyai type=image\_url, image\_url yang mengandungi url dan frame\_type. Gunakan URL imej HTTPS dan tetapkan frame\_type kepada first\_frame. Setiap peranan bingkai boleh muncul paling banyak sekali. Kunci tepat: type, image\_url, frame\_type Syarat: Kunci ini menerangkan setiap objek bingkai; image\_url hanya mengandungi url. Gugurkan frame\_images untuk permintaan teks sahaja. | Lalai— |
| Medan`input_references` | Jenis`array` | KeperluanPilihan | Nilai & had | Lalai— |
| Medan`seed` | Jenis`integer` | KeperluanPilihan | Nilai & had Minimum: -9,223,372,036,854,775,808 Maksimum: 9,223,372,036,854,775,807 | Lalai— |
| Medan`callback_url` | Jenis`string` | KeperluanPilihan | Nilai & had Corak: ^https:// | Lalai— |
| Medan`session_id` | Jenis`string` | KeperluanPilihan | Nilai & had | Lalai— |
| Medan`trace` | Jenis`object` | KeperluanPilihan | Nilai & had | Lalai— |
| Medan`user` | Jenis`string` | KeperluanPilihan | Nilai & had | Lalai— |

Gabungan bahan input

**Teks kepada video** · Prompt bertulis. · Diperlukan: model, prompt, duration

`Berikan prompt sebagai teks dan tempoh dalam saat bulat. Pilih resolusi yang disokong dan, jika perlu, nisbah bidang.`

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

`prompt`: Jenis: string · Bait UTF-8 maksimum: 10,000 · Aksara selain ruang kosong diperlukan: Ya

**Imej kepada video** · Prompt bertulis dan imej bingkai pertama. · Diperlukan: model, prompt, duration, frame\_images

`frame_images ialah tatasusunan. Setiap objek bingkai mempunyai type, image_url dan frame_type; image_url mengandungi url. Tetapkan type kepada image_url. Gunakan first_frame. Setiap peranan bingkai boleh muncul paling banyak sekali. Berikan URL imej HTTPS awam bagi setiap bingkai. Pilih resolusi yang disokong dan, jika perlu, nisbah bidang.`

Kunci tepat: type, image\_url, frame\_type

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

`prompt`: Jenis: string · Bait UTF-8 maksimum: 10,000 · Aksara selain ruang kosong diperlukan: Ya

**Reference to video** · Prompt bertulis dan rujukan imej, video serta audio yang disokong. · Diperlukan: model, prompt, duration, input\_references

`input_references ialah tatasusunan objek. Tetapkan type kepada image_url, video_url, audio_url dan gunakan medan sepadan yang mengandungi url. Gunakan pautan HTTPS awam. Gugurkan frame_images untuk memilih mod rujukan. Pilih resolusi yang disokong dan, jika perlu, nisbah bidang.`

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

`prompt`: Jenis: string · Bait UTF-8 maksimum: 10,000 · Aksara selain ruang kosong diperlukan: Ya

Parameter kaedah dan kitar hayat

| Parameter | Kontrak |
| --- | --- |
| Parameter`content_type` | Kontrakapplication/json |
| Parameter`required` | Kontrakmodel, prompt, duration |
| Parameter`material_types` | Kontraktext, image, audio, video |
| Parameter`additional_properties` | Kontrakfalse |
| Parameter`optional_controls` | Kontrakresolution, aspect\_ratio, generate\_audio, frame\_images, input\_references, seed, callback\_url, session\_id, trace, user |

Kitar hayat: `submit_once_poll_original`

`GET /v1/videos/{public_id}`

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

### Pelan harga

##### Cara caj akhir dikira

Kadar yang dipaparkan menganggarkan kos sebelum penjanaan. Caj akhir dikira berdasarkan kos yang direkodkan untuk penjanaan asal. Tempoh output yang diukur dan kuantiti ramalan bukan kuantiti akhir yang boleh dibilkan.

Rujukan tarif tidak menambah pilihan permintaan. Parameter yang disokong disenaraikan untuk kaedah yang dipilih.

Mod pantas

Tidak dinyatakan Apabila mod pantas dipilih

Mod flex

Tidak dinyatakan Apabila mod flex dipilih

Usaha penaakulan maksimum

Tidak dinyatakan Apabila usaha penaakulan maksimum menggunakan pelarasan default

#### Anggaran kadar untuk perbandingan

#### Harga mengikut konfigurasi

Padankan setiap caj dengan syarat yang dipaparkan. Gunakan satu kadar bagi setiap set konfigurasi alternatif.

| Konfigurasi | Jadual kadar | Kuantiti ramalan | Unit pengebilan | Syarat pengebilan | Caj |
| --- | --- | --- | --- | --- | --- |
| KonfigurasiKadar asas token | Jadual kadarKadar asas | Kuantiti ramalan— | Unit pengebilan— | Syarat pengebilan— | Caj Input · Token input · Anggaran untuk perbandingan sahaja **—** / 1K token Output · Token output · Anggaran untuk perbandingan sahaja **—** / 1K token Input · Bacaan cache · Anggaran untuk perbandingan sahaja **—** / 1K token Input · Penulisan cache · Anggaran untuk perbandingan sahaja **—** / 1K token Input · Penulisan cache, 1 jam · Anggaran untuk perbandingan sahaja **—** / 1K token |
| KonfigurasiHarga video | Jadual kadar— | Kuantiti ramalan— | Unit pengebilanbagi setiap saat video | Syarat pengebilanresolution: 2k | Caj Output · Harga video · Anggaran untuk perbandingan sahaja **$0.2** bagi setiap saat video |
| KonfigurasiHarga video | Jadual kadar— | Kuantiti ramalan— | Unit pengebilanbagi setiap saat video | Syarat pengebilanresolution: 480p | Caj Output · Harga video · Anggaran untuk perbandingan sahaja **$0.04** bagi setiap saat video |
| KonfigurasiHarga video | Jadual kadar— | Kuantiti ramalan— | Unit pengebilanbagi setiap saat video | Syarat pengebilanresolution: 768p | Caj Output · Harga video · Anggaran untuk perbandingan sahaja **$0.072** bagi setiap saat video |
| KonfigurasiHarga video | Jadual kadar— | Kuantiti ramalan— | Unit pengebilanbagi setiap saat video | Syarat pengebilanmod penjanaan: reference; resolusi: 2k | Caj Output · Harga video · Anggaran untuk perbandingan sahaja **$0.36** bagi setiap saat video |
| KonfigurasiHarga video | Jadual kadar— | Kuantiti ramalan— | Unit pengebilanbagi setiap saat video | Syarat pengebilanmod penjanaan: reference; resolusi: 480p | Caj Output · Harga video · Anggaran untuk perbandingan sahaja **$0.14** bagi setiap saat video |
| KonfigurasiHarga video | Jadual kadar— | Kuantiti ramalan— | Unit pengebilanbagi setiap saat video | Syarat pengebilanmod penjanaan: reference; resolusi: 768p | Caj Output · Harga video · Anggaran untuk perbandingan sahaja **$0.2** bagi setiap saat video |
| Konfigurasiimej input rujukan | Jadual kadar— | Kuantiti ramalan— | Unit pengebilanbagi setiap imej rujukan masukan | Syarat pengebilan— | Caj Input · imej input rujukan · Anggaran untuk perbandingan sahaja **$0.08** bagi setiap imej rujukan masukan |
| KonfigurasiAnggaran kos penjanaan | Jadual kadar— | Kuantiti ramalananggaran untuk satu penjanaan | Unit pengebilan— | Syarat pengebilan— | Caj Output · Anggaran kos penjanaan · Anggaran untuk perbandingan sahaja **$0.2** anggaran sebelum penjanaan Anggaran ini bukan caj tambahan atau kadar tetap bagi penjanaan yang telah selesai. |

Ailoot merizabkan anggaran amaun sebelum permintaan. Selepas hasil diterima, caj akhir diselesaikan berdasarkan penggunaan terukur. Penyelesaian caj penstriman menggunakan rekod penggunaan akhir. [Cara rizab dan penyelesaian caj berfungsi →](https://ailoot.ai/docs/ms/billing/reserve/)

#### Butiran tarif rujukan

Jadual rujukan peringkat model tidak mengubah pemilihan kaedah, sebut harga atau caj. Caj aktif menggunakan kadar kaedah Ailoot yang dipilih.

Rujukan harga konfigurasi video

#### Harga mengikut konfigurasi

Padankan setiap caj dengan syarat yang dipaparkan. Gunakan satu kadar bagi setiap set konfigurasi alternatif.

| Konfigurasi | Syarat pengebilan | Caj |
| --- | --- | --- |
| KonfigurasiHarga video | Syarat pengebilanresolution: 2k | Caj Output · Harga video **$0.18** bagi setiap saat video Rujukan harga yang diterbitkan bagi konfigurasi yang ditunjukkan. Caj akhir mengikut konfigurasi sebenar yang dibilkan. |
| KonfigurasiHarga video | Syarat pengebilanresolution: 480p | Caj Output · Harga video **$0.04** bagi setiap saat video Rujukan harga yang diterbitkan bagi konfigurasi yang ditunjukkan. Caj akhir mengikut konfigurasi sebenar yang dibilkan. |
| KonfigurasiHarga video | Syarat pengebilanresolution: 768p | Caj Output · Harga video **$0.06** bagi setiap saat video Rujukan harga yang diterbitkan bagi konfigurasi yang ditunjukkan. Caj akhir mengikut konfigurasi sebenar yang dibilkan. |
| KonfigurasiHarga video | Syarat pengebilanmod penjanaan: reference; resolusi: 2k | Caj Output · Harga video **$0.36** bagi setiap saat video Rujukan harga yang diterbitkan bagi konfigurasi yang ditunjukkan. Caj akhir mengikut konfigurasi sebenar yang dibilkan. |
| KonfigurasiHarga video | Syarat pengebilanmod penjanaan: reference; resolusi: 480p | Caj Output · Harga video **$0.08** bagi setiap saat video Rujukan harga yang diterbitkan bagi konfigurasi yang ditunjukkan. Caj akhir mengikut konfigurasi sebenar yang dibilkan. |
| KonfigurasiHarga video | Syarat pengebilanmod penjanaan: reference; resolusi: 768p | Caj Output · Harga video **$0.12** bagi setiap saat video Rujukan harga yang diterbitkan bagi konfigurasi yang ditunjukkan. Caj akhir mengikut konfigurasi sebenar yang dibilkan. |

### Contoh permintaan

#### Ailoot Ultra · Video

curl · cipta 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
```

### Terima dan simpan hasil

#### Ailoot Ultra · Video

pautan kandungan bertandatangan milik anda

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

##### Semak status tugas

GET status operasi asal

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

Pembacaan kandungan lain

Simpan setiap output selesai yang menjadi milik anda

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

##### Simpan semua hasil yang selesai

Simpan setiap video yang selesai atau fail yang dikembalikan; dapatkan setiap URL aset yang benar-benar dikembalikan.

Simpan setiap output sebenar milik anda berserta metadata ukuran yang dikembalikan.

##### Jika respons asal perlu disemak

503 result\_pending\_check + id asal + X-Should-Retry:false; jangan sekali-kali ulang operasi asal

Medan respons

| Medan | Jenis | Maksud |
| --- | --- | --- |
| Medan`index` | Jenisinteger | MaksudKedudukan video ini dalam senarai output dengan indeks bermula dari sifar. |
| Medan`content_url` | Jenisstring | MaksudURL muat turun HTTPS bertandatangan untuk video siap ini. |
| Medan`sha256` | Jenisstring \| null | MaksudRingkasan SHA-256 bagi bait video asal; null jika tidak tersedia. |
| Medan`size_bytes` | Jenisinteger \| null | MaksudSaiz fail video asal dalam bait; null jika tidak tersedia. |
| Medan`duration_ms` | Jenisinteger \| null | MaksudTempoh video yang diukur dalam milisaat; null jika tidak tersedia. |
| Medan`width` | Jenisinteger \| null | MaksudLebar video dalam piksel; null jika tidak tersedia. |
| Medan`height` | Jenisinteger \| null | MaksudKetinggian video dalam piksel; null jika tidak tersedia. |
| Medan`video_codec` | Jenisstring \| null | MaksudPengecam codec video; null jika tidak direkodkan. |
| Medan`has_audio` | Jenisboolean \| null | MaksudSama ada video mengandungi trek audio; null jika tidak diukur. |
| Medan`audio_codec` | Jenisstring \| null | MaksudPengecam codec audio; null apabila tiada pengecam direkodkan. |

Ralat dan langkah seterusnya

| Respons | Syarat | Langkah seterusnya |
| --- | --- | --- |
| Respons404 · `not_found_error` | SyaratAkses video tidak tersedia, atau ID video ini tidak ditemui. | Langkah seterusnyaSemak akses video. Untuk video sedia ada, gunakan ID awam asalnya dan kunci API yang sama. |
| Respons401 · `authentication_error` | SyaratKunci API tidak sepadan dengan akaun yang disahkan. | Langkah seterusnyaSemak kunci API dan akses akaun anda sebelum menghantar. |
| Respons400 · `invalid_request_error` | SyaratPermintaan tidak dapat dibaca, atau indeks muat turun tidak sah. | Langkah seterusnyaBetulkan badan permintaan. Untuk muat turun, pilih indeks output yang dikembalikan oleh tugas asal. |
| Respons422 · `price_unavailable` | SyaratHarga konfigurasi video yang dipilih tidak dapat ditentukan. | Langkah seterusnyaPilih konfigurasi video yang disokong dan lengkapkan pilihan wajibnya sebelum menghantar permintaan yang dibetulkan. |
| Respons422 · `invalid_request_error` | SyaratInput video atau tugas sambungan asal tidak sah. | Langkah seterusnyaGunakan input HTTPS yang sah. Untuk sambungan, gunakan ID video awam asal anda yang telah siap dengan kunci API yang sama. |
| Respons402 · `billing_error` | SyaratBaki atau had yang tersedia tidak membenarkan penahanan dana. | Langkah seterusnyaSemak baki dan had yang tersedia sebelum menghantar permintaan baharu. |
| Respons503 · `server_error` | SyaratPengesahan video, storan atau akses perkhidmatan tidak tersedia buat sementara waktu. | Langkah seterusnyaTunggu sehingga perkhidmatan tersedia. Jika anda sudah mempunyai ID video, semak tugas asal tersebut dan jangan cipta penjanaan lain. |
| Respons503 · `result_pending_check` | SyaratHasil video asal dan caj perlu disemak. | Langkah seterusnyaSimpan ID video yang dikembalikan dan semak tugas tersebut. Jangan hantar permintaan penjanaan gantian semasa semakan sedang berjalan. |
| Respons503 · `owned_result_unavailable` | SyaratMuat turun video sedia ada tidak tersedia buat sementara waktu. | Langkah seterusnyaSemak tugas video yang sama kemudian dan muat turun output sedia ada. Penjanaan baharu mencipta operasi berasingan. |
| Respons409 · `video_not_ready` | SyaratKandungan video belum diterbitkan. | Langkah seterusnyaSemak status tugas asal. Muat turun selepas statusnya melaporkan completed; jika statusnya melaporkan failed, ikuti notis semakan cajnya. |

### Alias

#### Alias model

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

#### Alias laluan kaedah

Gunakan laluan kaedah yang dipaparkan di atas.

#### ID pemanggil berkaitan

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

FAQ · HeyGen: HeyGen Video

Apakah input dan hasil yang tersedia?

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

Apakah medan yang digunakan oleh permintaan?

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

Apakah had yang terpakai?

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

Sambungkan Ailoot kepada Claude Code, OpenCode, Hermes atau aplikasi anda.

## Syarikat dan portfolio projeknya

Syarikat dan portfolio projeknya: jutaan pelanggan; jualan bernilai berbilion setiap bulan.

## Beli token dengan diskaun.

Diskaun langganan untuk penggunaan berkala. Kod promosi — sehingga 50% bagi pembelian token.

Langganan

Pilih pelan berdiskaun untuk permintaan berkala anda.

Kod promosi sehingga 50%

Masukkan kod semasa pembelian. Harga dikira semula mengikut promosi semasa.

Perbelanjaan dalam sejarah

Model, token dan jumlah disimpan bagi setiap permintaan.

[Pilih langganan](https://ailoot.ai/docs/ms/billing/subscriptions/) · [Lihat harga model](https://ailoot.ai/models/ms/)

## Sambungkan API kepada produk yang anda jual.

SaaS, aplikasi dan bot — di bawah tawaran rasmi serta perjanjian lesen Ailoot. Untuk jualan semula, mohon lesen penjual semula.

Aplikasi komersial

Tambahkan penjanaan teks, imej, video dan audio pada ciri berbayar perkhidmatan anda.

Lesen penjual semula

Hantar keterangan projek dan susunan akses. Minta terma penggunaan serta jualan semula secara bertulis.

Dokumen pada laman

Tawaran, perjanjian lesen dan dasar pemprosesan data tersedia sebelum sambungan.

[Mohon lesen penjual semula](mailto:support@ailoot.ai) · [Tawaran dan perjanjian lesen](https://ailoot.ai/legal/offer?lang=ms)

## Ailoot · Syarikat dan portfolio projeknya





Ailoot berteraskan pengalaman operasi yang mantap, pangkalan pelanggan yang besar, perkhidmatan yang stabil dan pemantauan KPI berterusan.





Syarikat dan portfolio projeknya: jutaan pelanggan; jualan bernilai berbilion setiap bulan.





Ailoot menggunakan pengalaman operasi ini untuk akses API kepada ciri AI dalam produk pelanggan, ejen, aplikasi dan automasi.