model

HeyGen: HeyGen Video

Markdown · JSON

HeyGen: HeyGen Video

HeyGen Video menghasilkan adegan 5–15 detik dengan dialog, suasana, dan efek dari teks, gambar pertama, atau referensi visual serta audio. Model serbaguna heygen-video-1 mendukung shot produk dan karakter, dengan kendali referensi serta keluaran MP4. Tindakan yang jelas dan terbatas memberikan arahan produksi yang berguna.

Tentang model

Deskripsi ini mencakup kemampuan model. Masukan, keluaran, dan opsi yang tersedia di Ailoot tercantum di bawah untuk metode yang dipilih.

HeyGen Video adalah model generasi adegan serbaguna HeyGen, yang diidentifikasi produsen sebagai heygen-video-1. Model ini menciptakan subjek, latar, cahaya, dan bunyi bersama dari arahan kreatif. Setiap klip berdurasi 5–15 detik dan berisi trek audio hasil generasinya, termasuk dialog, suasana, serta efek. Masukan produksi yang berguna mencakup deskripsi adegan, foto produk, atau materi yang menentukan orang, tempat, maupun gerakan. Aset hasilnya berupa adegan singkat untuk presentasi produk, sisipan pengenalan, tampilan properti, atau pekerjaan video suntingan lainnya.

Tiga mode memberikan peran berbeda pada masukan. Teks ke video menciptakan adegan dari prompt. Gambar ke video secara harfiah dimulai pada gambar yang diberikan, lalu mengikuti arahan tindakan. Referensi ke video menggunakan gambar, video, dan audio opsional yang diberikan untuk memandu adegan dengan komposisi baru; mode ini memerlukan paling sedikit satu gambar atau video referensi. Pilih gambar bingkai pertama ketika komposisi pembuka harus cocok dengan gambar diam, atau referensi ketika objek yang dikenal perlu muncul dalam komposisi berbeda. Model adegan ini berbeda dari mesin render avatar HeyGen dan alur kerja komposisi Video Agent.

Panduan pembuatnya mengutamakan arahan shot yang terperinci dan konkret: satu subjek, satu lokasi, dan satu tindakan terbatas, dengan kamera terkunci atau bergerak lembut. Jelaskan posisi kamera, lensa atau maksud kedalaman bidang, cahaya, tekstur permukaan, dan perlakuan warna. Jelaskan tempat objek bersentuhan ketika tindakan bergantung pada kontak. Untuk contoh produk orisinal, gunakan foto referensi termos perjalanan dan minta agar termos berdiri di konter kayu sementara presenter berbicara di sampingnya, dengan gerak kamera kecil menuju termos. Periksa bentuk, penempatan, dan penandaan termos yang terlihat pada hasil.

Daftar referensi mendukung hingga sembilan gambar, tiga video, dan tiga item audio, dengan maksimum dua belas referensi secara keseluruhan. Gambar, video, dan audio diberi nomor terpisah dalam format prompt produsen: gambar pertama adalah <Picture 1>, dan video pertama <Video 1>. Berikan peran pada setiap referensi dan identifikasi peran itu secara eksplisit dalam arahan. Model membaca lima detik pertama setiap video referensi, jadi siapkan bagian relevan di awal. Referensi API juga menetapkan proporsi video referensi antara 1:4 dan 4:1. Klip panjang yang gerakan tujuannya hanya berada di akhir merupakan persiapan yang kurang sesuai untuk jendela masukan lima detik tersebut.

Antarmuka referensi yang didokumentasikan menerima sumber HTTPS yang dapat diakses langsung, pengenal aset yang diunggah, atau base64 sebaris. Panduan mencantumkan ukuran gambar maksimum 16 MB melalui URL dan 5 MB sebaris; video atau audio boleh hingga 32 MB melalui URL dan 16 MB sebaris. Siapkan materi sumber yang jelas, dengan subjek penting mudah dibedakan dan tanpa instruksi yang bersaing dalam referensi berbeda. Pertahankan orientasi yang dimaksud pada gambar bingkai pertama. Detail masukan ini berkaitan dengan alur kerja referensi pembuatnya dan membantu menyusun materi kreatif sesuai mode pilihan.

Arahkan bunyi dalam arahan yang sama dengan gambar. Nyatakan dialog, penyampaian vokal, bunyi ruangan, dan efek khusus, termasuk apakah bunyi harus dekat atau jauh. Tentukan perlakuan musik yang dimaksud ketika adegan hanya perlu berisi ucapan serta suasana. Panduan menyarankan sekitar 2,5 kata lisan per detik sebagai perkiraan perencanaan, jadi sisakan ruang untuk jeda dan tindakan visual. Pengantar singkat dapat direncanakan sebagai satu kalimat disusul momen yang mengungkap produk. Dengarkan kata-kata sebenarnya dan apakah bunyi yang dihasilkan sesuai ruang serta tindakan.

Durasi keluaran dipilih dalam detik bulat dari lima hingga lima belas, dengan bawaan lima detik. Resolusi adalah kelas ukuran: 480p, 768p, 1080p, atau 2k. Pilihan pembingkaian yang didokumentasikan adalah 21:9, 16:9, 4:3, 1:1, 3:4, dan 9:16. Untuk teks ke video dan referensi ke video pada 1080p atau 2k, pilih 16:9 atau 9:16; pembingkaian referensi adaptif didokumentasikan pada 480p serta 768p. Gambar ke video mengikuti proporsi gambar pertama, jadi pangkas sebelum generasi ketika bentuk yang dibutuhkan berubah. Tinjau dimensi sebenarnya dari hasil lengkap, alih-alih berasumsi label kelas ukuran berarti satu pasangan piksel konvensional.

Panduan model menetapkan video MP4 dengan pengodean gambar H.264 dan audio AAC pada 32 kHz stereo. Generasi diproses secara asinkron, dan tugas lengkap menyediakan lokasi video yang dapat diputar, durasi, serta dimensi. Lokasi video bertanda tangannya dapat diperbarui dengan mengambil tugas lagi. Simpan klip sebenarnya, materi referensi, dan arahan untuk peninjauan penyuntingan. Catatan menunggu atau pemrosesan melacak generasi; video lengkap merupakan artefak produksi yang dinilai untuk gambar, ucapan, dan bunyi.

Produsen mendokumentasikan pilihan peningkatan prompt turbo, quality, dan disabled; disabled mempertahankan susunan kata yang disiapkan sebagaimana ditulis. Seed tetap berguna ketika membandingkan perubahan satu klausa sambil mempertahankan masukan lainnya. Catat seed serta pengaturan pilihan bersama arahan shot. Untuk tulisan di layar, jaga frasa yang dimaksud tetap singkat dan eja secara tepat; panduan menyarankan compositing paragraf, tulisan kecil, serta diagram berlabel setelahnya. Periksa setiap karakter yang terlihat dalam judul hasil generasi, alih-alih berasumsi susunan katanya direproduksi benar.

Panduan mengidentifikasi teks panjang di layar, gerakan organik lembut seperti kelopak, kertas, atau rambut, dan manipulasi tangan jarak dekat sebagai area yang kurang andal. Untuk penjelasan prosedural, biarkan kalimat yang ditulis jelas menyampaikan langkah-langkah sementara gambar menampilkan orang atau objek yang stabil; gunakan visual yang diverifikasi secara terpisah ketika operasi fisik itu sendiri harus tepat. Tinjau seluruh shot untuk kesinambungan objek, kontak, detail wajah dan tangan, dialog, serta bunyi. Daftar ringkas mengenai hal yang perlu berubah pada rekaman berikutnya menjaga arahan produksi terperinci tetap praktis.

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

heygen/heygen-video-1

HeyGen /heygen/heygen-video-1

Mulai

HeyGen Video menghasilkan adegan 5–15 detik dengan dialog, suasana, dan efek dari teks, gambar pertama, atau referensi visual serta audio. Model serbaguna heygen-video-1 mendukung shot produk dan karakter, dengan kendali referensi serta keluaran MP4. Tindakan yang jelas dan terbatas memberikan arahan produksi yang berguna.

Masukan yang diterima
Teks · Gambar · Audio · Video
Hasil
Video

Tersedia di Ailoot · masukan & metode

Ailoot Ultra · Video POST /v1/videos
Masukan
text, image, audio, video
Keluaran
video
Format keluaran
byte MP4 asli; tanpa normalisasi atau pengodean ulang
KolomJenisPersyaratanNilai & batasanBawaan
KolommodelJenisstringPersyaratanWajibNilai & batasan
heygen/heygen-video-1
Bawaan—
KolompromptJenisstringPersyaratanWajibNilai & batasanBawaan—
KolomdurationJenisintegerPersyaratanWajibNilai & batasan
5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15
Minimum: 1
Maksimum: 600
Bawaan—
KolomresolutionJenisstringPersyaratanOpsionalNilai & batasan
480p, 768p, 2K
Bawaan—
Kolomaspect_ratioJenisstringPersyaratanOpsionalNilai & batasan
21:9, 16:9, 4:3, 1:1, 3:4, 9:16
Bawaan—
Kolomgenerate_audioJenisbooleanPersyaratanOpsionalNilai & batasan
false
Bawaan—
Kolomframe_imagesJenisarrayPersyaratanOpsionalNilai & batasan
Item minimum: 1
Item maksimum: 1
Konten masukan: Array objek bingkai. Setiap objek memiliki type=image_url, image_url yang memuat url, dan frame_type. Gunakan URL gambar HTTPS dan tetapkan frame_type ke first_frame. Setiap peran bingkai muncul paling banyak sekali.
Kunci persis: type, image_url, frame_type
Kondisi: Kunci-kunci ini menjelaskan setiap objek bingkai; image_url hanya memuat url. Hilangkan frame_images untuk permintaan yang hanya berisi teks.
Bawaan—
Kolominput_referencesJenisarrayPersyaratanOpsionalNilai & batasanBawaan—
KolomseedJenisintegerPersyaratanOpsionalNilai & batasan
Minimum: -9.223.372.036.854.775.808
Maksimum: 9.223.372.036.854.775.807
Bawaan—
Kolomcallback_urlJenisstringPersyaratanOpsionalNilai & batasan
Pola: ^https://
Bawaan—
Kolomsession_idJenisstringPersyaratanOpsionalNilai & batasanBawaan—
KolomtraceJenisobjectPersyaratanOpsionalNilai & batasanBawaan—
KolomuserJenisstringPersyaratanOpsionalNilai & batasanBawaan—
Kombinasi bahan masukan

Teks ke video · Prompt tertulis. · Wajib: model, prompt, duration

Berikan prompt sebagai teks dan durasi dalam detik bulat. Pilih resolusi yang didukung dan, jika perlu, rasio aspek.

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

prompt: Jenis: string · Byte UTF-8 maksimum: 10.000 · Wajib berisi karakter selain spasi: Ya

Gambar ke video · Prompt tertulis dan satu gambar bingkai pertama. · Wajib: model, prompt, duration, frame_images

frame_images berupa array. Setiap objek bingkai memiliki type, image_url, dan frame_type; image_url memuat url. Tetapkan type ke image_url. Gunakan first_frame. Setiap peran bingkai muncul paling banyak sekali. Berikan URL gambar HTTPS publik untuk setiap bingkai. Pilih resolusi yang didukung dan, jika perlu, rasio aspek.

Kunci persis: type, image_url, frame_type

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

prompt: Jenis: string · Byte UTF-8 maksimum: 10.000 · Wajib berisi karakter selain spasi: Ya

Reference to video · Prompt tertulis dan referensi gambar, video, audio yang didukung. · Wajib: model, prompt, duration, input_references

input_references adalah array objek. Tetapkan type ke image_url, video_url, audio_url, dan gunakan bidang yang sesuai yang memuat url. Gunakan URL HTTPS publik. Hilangkan frame_images untuk memilih mode referensi. Pilih resolusi yang didukung dan, jika perlu, rasio aspek.

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

prompt: Jenis: string · Byte UTF-8 maksimum: 10.000 · Wajib berisi karakter selain spasi: Ya

Parameter metode dan siklus hidup
ParameterKontrak
Parametercontent_typeKontrakapplication/json
ParameterrequiredKontrakmodel, prompt, duration
Parametermaterial_typesKontraktext, image, audio, video
Parameteradditional_propertiesKontrakfalse
Parameteroptional_controlsKontrakresolution, aspect_ratio, generate_audio, frame_images, input_references, seed, callback_url, session_id, trace, user

Siklus hidup: submit_once_poll_original

GET /v1/videos/{public_id}

GET /v1/videos/{public_id}/content

Paket

Cara menghitung biaya akhir

Tarif yang ditampilkan memperkirakan biaya sebelum pembuatan. Biaya akhir dihitung dari biaya yang tercatat untuk proses pembuatan awal. Durasi keluaran yang terukur dan kuantitas perkiraan bukanlah kuantitas akhir yang ditagihkan.

Referensi tarif tidak menambah opsi permintaan. Parameter yang didukung tercantum pada metode yang dipilih.

Mode Fast
Tidak ditentukan Saat mode fast dipilih
Mode Flex
Tidak ditentukan Saat mode flex dipilih
Upaya penalaran maksimum
Tidak ditentukan Saat upaya penalaran maksimum menggunakan penyesuaian default

Perkiraan tarif untuk perbandingan

Harga menurut konfigurasi

Cocokkan setiap biaya dengan kondisi yang ditampilkan. Gunakan satu tarif untuk setiap kelompok konfigurasi alternatif.

KonfigurasiJadwal tarifJumlah perkiraanSatuan penagihanKondisi penagihanBiaya
KonfigurasiTarif dasar tokenJadwal tarifTarif dasarJumlah perkiraan—Satuan penagihan—Kondisi penagihan—Biaya
Masukan · Token masukan · Perkiraan hanya untuk perbandingan — / 1K token
Keluaran · Token keluaran · Perkiraan hanya untuk perbandingan — / 1K token
Masukan · Pembacaan cache · Perkiraan hanya untuk perbandingan — / 1K token
Masukan · Penulisan cache · Perkiraan hanya untuk perbandingan — / 1K token
Masukan · Penulisan cache, 1 jam · Perkiraan hanya untuk perbandingan — / 1K token
KonfigurasiHarga videoJadwal tarif—Jumlah perkiraan—Satuan penagihanper detik videoKondisi penagihanresolution: 2kBiaya
Keluaran · Harga video · Perkiraan hanya untuk perbandingan $0.2 per detik video
KonfigurasiHarga videoJadwal tarif—Jumlah perkiraan—Satuan penagihanper detik videoKondisi penagihanresolution: 480pBiaya
Keluaran · Harga video · Perkiraan hanya untuk perbandingan $0.04 per detik video
KonfigurasiHarga videoJadwal tarif—Jumlah perkiraan—Satuan penagihanper detik videoKondisi penagihanresolution: 768pBiaya
Keluaran · Harga video · Perkiraan hanya untuk perbandingan $0.072 per detik video
KonfigurasiHarga videoJadwal tarif—Jumlah perkiraan—Satuan penagihanper detik videoKondisi penagihanmode pembuatan: reference; resolusi: 2kBiaya
Keluaran · Harga video · Perkiraan hanya untuk perbandingan $0.36 per detik video
KonfigurasiHarga videoJadwal tarif—Jumlah perkiraan—Satuan penagihanper detik videoKondisi penagihanmode pembuatan: reference; resolusi: 480pBiaya
Keluaran · Harga video · Perkiraan hanya untuk perbandingan $0.14 per detik video
KonfigurasiHarga videoJadwal tarif—Jumlah perkiraan—Satuan penagihanper detik videoKondisi penagihanmode pembuatan: reference; resolusi: 768pBiaya
Keluaran · Harga video · Perkiraan hanya untuk perbandingan $0.2 per detik video
Konfigurasigambar masukan referensiJadwal tarif—Jumlah perkiraan—Satuan penagihanper gambar referensi masukanKondisi penagihan—Biaya
Masukan · gambar masukan referensi · Perkiraan hanya untuk perbandingan $0.08 per gambar referensi masukan
KonfigurasiPerkiraan biaya pembuatanJadwal tarif—Jumlah perkiraanestimasi satu kali pembuatanSatuan penagihan—Kondisi penagihan—Biaya
Keluaran · Perkiraan biaya pembuatan · Perkiraan hanya untuk perbandingan $0.2 estimasi sebelum pembuatan

Perkiraan ini bukan biaya tambahan maupun tarif tetap untuk proses pembuatan yang telah selesai.

Ailoot mencadangkan perkiraan dana sebelum permintaan. Setelah hasil diterima, tagihan akhir diselesaikan berdasarkan penggunaan yang terukur. Penyelesaian tagihan streaming menggunakan catatan penggunaan akhir. Cara kerja cadangan dan penyelesaian tagihan →

Detail tarif referensi

Jadwal referensi tingkat model tidak mengubah pemilihan metode, estimasi harga, atau biaya. Biaya aktif menggunakan tarif metode Ailoot yang dipilih.

Referensi harga konfigurasi video

Harga menurut konfigurasi

Cocokkan setiap biaya dengan kondisi yang ditampilkan. Gunakan satu tarif untuk setiap kelompok konfigurasi alternatif.

KonfigurasiKondisi penagihanBiaya
KonfigurasiHarga videoKondisi penagihanresolution: 2kBiaya
Keluaran · Harga video $0.18 per detik video

Acuan harga yang dipublikasikan untuk konfigurasi yang ditampilkan. Biaya akhir mengikuti konfigurasi aktual yang ditagihkan.

KonfigurasiHarga videoKondisi penagihanresolution: 480pBiaya
Keluaran · Harga video $0.04 per detik video

Acuan harga yang dipublikasikan untuk konfigurasi yang ditampilkan. Biaya akhir mengikuti konfigurasi aktual yang ditagihkan.

KonfigurasiHarga videoKondisi penagihanresolution: 768pBiaya
Keluaran · Harga video $0.06 per detik video

Acuan harga yang dipublikasikan untuk konfigurasi yang ditampilkan. Biaya akhir mengikuti konfigurasi aktual yang ditagihkan.

KonfigurasiHarga videoKondisi penagihanmode pembuatan: reference; resolusi: 2kBiaya
Keluaran · Harga video $0.36 per detik video

Acuan harga yang dipublikasikan untuk konfigurasi yang ditampilkan. Biaya akhir mengikuti konfigurasi aktual yang ditagihkan.

KonfigurasiHarga videoKondisi penagihanmode pembuatan: reference; resolusi: 480pBiaya
Keluaran · Harga video $0.08 per detik video

Acuan harga yang dipublikasikan untuk konfigurasi yang ditampilkan. Biaya akhir mengikuti konfigurasi aktual yang ditagihkan.

KonfigurasiHarga videoKondisi penagihanmode pembuatan: reference; resolusi: 768pBiaya
Keluaran · Harga video $0.12 per detik video

Acuan harga yang dipublikasikan untuk konfigurasi yang ditampilkan. Biaya akhir mengikuti konfigurasi aktual yang ditagihkan.

Contoh permintaan

Ailoot Ultra · Video

curl · buat 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

Terima dan simpan hasil

Ailoot Ultra · Video

URL konten bertanda tangan milik Ailoot

  • GET /v1/videos/{public_id}
  • GET /v1/videos/{public_id}/content
Periksa status tugas
GET status operasi asli
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 konten lain
Simpan setiap keluaran selesai yang menjadi milik Anda
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 berkas yang dikembalikan; ambil setiap URL aset yang benar-benar dikembalikan.

Simpan setiap keluaran aktual milik Ailoot beserta metadata hasil pengukuran yang dikembalikan.

Jika respons asli perlu diperiksa

503 result_pending_check + id asli + X-Should-Retry:false; jangan pernah ulangi pengiriman awal

Kolom respons
KolomJenisArti
KolomindexJenisintegerArtiPosisi video ini dalam daftar keluaran, dihitung dari nol.
Kolomcontent_urlJenisstringArtiURL unduhan HTTPS bertanda tangan untuk video yang telah selesai ini.
Kolomsha256Jenisstring | nullArtiDigest SHA-256 dari byte video asli; null jika tidak tersedia.
Kolomsize_bytesJenisinteger | nullArtiUkuran berkas video asli dalam byte; null jika tidak tersedia.
Kolomduration_msJenisinteger | nullArtiDurasi video terukur dalam milidetik; null jika tidak tersedia.
KolomwidthJenisinteger | nullArtiLebar video dalam piksel; null jika tidak tersedia.
KolomheightJenisinteger | nullArtiTinggi video dalam piksel; null jika tidak tersedia.
Kolomvideo_codecJenisstring | nullArtiPengenal codec video; null jika tidak dicatat.
Kolomhas_audioJenisboolean | nullArtiApakah video memuat trek audio; null jika tidak diukur.
Kolomaudio_codecJenisstring | nullArtiPengenal codec audio; null jika tidak ada pengenal yang dicatat.
Kesalahan dan langkah berikutnya
ResponsKondisiLangkah berikutnya
Respons404 · not_found_errorKondisiAkses video tidak tersedia, atau ID video ini tidak ditemukan.Langkah berikutnyaPeriksa akses video. Untuk video yang sudah ada, gunakan ID publik aslinya dan kunci API yang sama.
Respons401 · authentication_errorKondisiKunci API tidak cocok dengan akun yang diautentikasi.Langkah berikutnyaPeriksa kunci API dan akses akun Anda sebelum mengirim.
Respons400 · invalid_request_errorKondisiPermintaan tidak dapat dibaca, atau indeks unduhan tidak valid.Langkah berikutnyaPerbaiki isi permintaan. Untuk unduhan, pilih indeks keluaran yang dikembalikan oleh tugas awal.
Respons422 · price_unavailableKondisiHarga konfigurasi video yang dipilih tidak dapat dihitung.Langkah berikutnyaPilih konfigurasi video yang didukung dan lengkapi opsi wajibnya sebelum mengirim permintaan yang telah diperbaiki.
Respons422 · invalid_request_errorKondisiMasukan video atau tugas kelanjutan awal tidak valid.Langkah berikutnyaGunakan masukan HTTPS yang valid. Untuk kelanjutan, gunakan ID video publik awal Anda yang telah selesai dengan kunci API yang sama.
Respons402 · billing_errorKondisiSaldo atau batas yang tersedia tidak memungkinkan pencadangan dana.Langkah berikutnyaPeriksa saldo dan batas yang tersedia sebelum mengirim permintaan baru.
Respons503 · server_errorKondisiVerifikasi video, penyimpanan, atau akses layanan sementara tidak tersedia.Langkah berikutnyaTunggu hingga layanan tersedia. Jika Anda sudah memiliki ID video, periksa tugas awal tersebut alih-alih memulai pembuatan baru.
Respons503 · result_pending_checkKondisiHasil video awal dan tagihannya perlu diperiksa.Langkah berikutnyaSimpan ID video yang dikembalikan dan periksa tugas tersebut. Jangan kirim permintaan pembuatan pengganti selama tugas itu sedang diperiksa.
Respons503 · owned_result_unavailableKondisiUnduhan video yang sudah ada sementara tidak tersedia.Langkah berikutnyaPeriksa tugas video yang sama nanti dan unduh keluaran yang sudah ada. Pembuatan baru menghasilkan operasi terpisah.
Respons409 · video_not_readyKondisiKonten video belum dipublikasikan.Langkah berikutnyaPeriksa status tugas awal. Unduh setelah statusnya completed; jika statusnya failed, ikuti pemberitahuan pemeriksaan tagihannya.

Alias

Alias model

Ailoot Ultra heygen/heygen-video-1

Alias jalur metode

Gunakan jalur metode yang ditampilkan di atas.

ID pemanggil terkait

heygen/heygen-video-1

FAQ · HeyGen: HeyGen Video
Input dan hasil apa yang tersedia?

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

Kolom apa yang digunakan 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

Batasan apa yang berlaku?

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

Rincian selengkapnya

Hubungkan Ailoot ke Claude Code, OpenCode, Hermes, atau aplikasi Anda.

Perusahaan dan portofolio proyeknya

Perusahaan dan portofolio proyeknya: jutaan pelanggan; penjualan miliaran setiap bulan.

Beli token dengan diskon.

Diskon langganan untuk pekerjaan rutin. Kode promo — hingga 50% untuk pembelian token.

Langganan
Pilih paket dengan diskon untuk permintaan rutin Anda.
Kode promo hingga 50%
Masukkan kode saat membeli. Harga dihitung ulang sesuai promosi aktif.
Biaya dalam riwayat
Model, token, dan jumlah tagihan disimpan untuk setiap permintaan.

Pilih langganan · Lihat harga model

Hubungkan API ke produk yang Anda jual.

SaaS, aplikasi, dan bot — sesuai penawaran dan perjanjian lisensi Ailoot. Untuk penjualan kembali, mintalah lisensi reseller.

Aplikasi komersial
Integrasikan pembuatan teks, gambar, video, dan suara dalam fitur berbayar layanan Anda.
Lisensi reseller
Kirim deskripsi proyek dan skema akses. Mintalah ketentuan penggunaan dan penjualan kembali secara tertulis.
Dokumen di situs
Penawaran, perjanjian lisensi, dan kebijakan pemrosesan data tersedia sebelum koneksi.

Minta lisensi reseller · Penawaran dan perjanjian lisensi