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-1Mulai
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
| Kolom | Jenis | Persyaratan | Nilai & batasan | Bawaan |
|---|---|---|---|---|
Kolommodel | Jenisstring | PersyaratanWajib | Nilai & batasan heygen/heygen-video-1 | Bawaan— |
Kolomprompt | Jenisstring | PersyaratanWajib | Nilai & batasan | Bawaan— |
Kolomduration | Jenisinteger | PersyaratanWajib | Nilai & batasan 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 Minimum: 1 Maksimum: 600 | Bawaan— |
Kolomresolution | Jenisstring | PersyaratanOpsional | Nilai & batasan 480p, 768p, 2K | Bawaan— |
Kolomaspect_ratio | Jenisstring | PersyaratanOpsional | Nilai & batasan 21:9, 16:9, 4:3, 1:1, 3:4, 9:16 | Bawaan— |
Kolomgenerate_audio | Jenisboolean | PersyaratanOpsional | Nilai & batasan false | Bawaan— |
Kolomframe_images | Jenisarray | PersyaratanOpsional | Nilai & 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_references | Jenisarray | PersyaratanOpsional | Nilai & batasan | Bawaan— |
Kolomseed | Jenisinteger | PersyaratanOpsional | Nilai & batasan Minimum: -9.223.372.036.854.775.808 Maksimum: 9.223.372.036.854.775.807 | Bawaan— |
Kolomcallback_url | Jenisstring | PersyaratanOpsional | Nilai & batasan Pola: ^https:// | Bawaan— |
Kolomsession_id | Jenisstring | PersyaratanOpsional | Nilai & batasan | Bawaan— |
Kolomtrace | Jenisobject | PersyaratanOpsional | Nilai & batasan | Bawaan— |
Kolomuser | Jenisstring | PersyaratanOpsional | Nilai & batasan | Bawaan— |
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
| Parameter | Kontrak |
|---|---|
Parametercontent_type | Kontrakapplication/json |
Parameterrequired | Kontrakmodel, prompt, duration |
Parametermaterial_types | Kontraktext, image, audio, video |
Parameteradditional_properties | Kontrakfalse |
Parameteroptional_controls | Kontrakresolution, 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.
| Konfigurasi | Jadwal tarif | Jumlah perkiraan | Satuan penagihan | Kondisi penagihan | Biaya |
|---|---|---|---|---|---|
| KonfigurasiTarif dasar token | Jadwal tarifTarif dasar | Jumlah 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 video | Jadwal tarif— | Jumlah perkiraan— | Satuan penagihanper detik video | Kondisi penagihanresolution: 2k | Biaya Keluaran · Harga video · Perkiraan hanya untuk perbandingan $0.2 per detik video |
| KonfigurasiHarga video | Jadwal tarif— | Jumlah perkiraan— | Satuan penagihanper detik video | Kondisi penagihanresolution: 480p | Biaya Keluaran · Harga video · Perkiraan hanya untuk perbandingan $0.04 per detik video |
| KonfigurasiHarga video | Jadwal tarif— | Jumlah perkiraan— | Satuan penagihanper detik video | Kondisi penagihanresolution: 768p | Biaya Keluaran · Harga video · Perkiraan hanya untuk perbandingan $0.072 per detik video |
| KonfigurasiHarga video | Jadwal tarif— | Jumlah perkiraan— | Satuan penagihanper detik video | Kondisi penagihanmode pembuatan: reference; resolusi: 2k | Biaya Keluaran · Harga video · Perkiraan hanya untuk perbandingan $0.36 per detik video |
| KonfigurasiHarga video | Jadwal tarif— | Jumlah perkiraan— | Satuan penagihanper detik video | Kondisi penagihanmode pembuatan: reference; resolusi: 480p | Biaya Keluaran · Harga video · Perkiraan hanya untuk perbandingan $0.14 per detik video |
| KonfigurasiHarga video | Jadwal tarif— | Jumlah perkiraan— | Satuan penagihanper detik video | Kondisi penagihanmode pembuatan: reference; resolusi: 768p | Biaya Keluaran · Harga video · Perkiraan hanya untuk perbandingan $0.2 per detik video |
| Konfigurasigambar masukan referensi | Jadwal tarif— | Jumlah perkiraan— | Satuan penagihanper gambar referensi masukan | Kondisi penagihan— | Biaya Masukan · gambar masukan referensi · Perkiraan hanya untuk perbandingan $0.08 per gambar referensi masukan |
| KonfigurasiPerkiraan biaya pembuatan | Jadwal tarif— | Jumlah perkiraanestimasi satu kali pembuatan | Satuan 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.
| Konfigurasi | Kondisi penagihan | Biaya |
|---|---|---|
| KonfigurasiHarga video | Kondisi penagihanresolution: 2k | Biaya Keluaran · Harga video $0.18 per detik video Acuan harga yang dipublikasikan untuk konfigurasi yang ditampilkan. Biaya akhir mengikuti konfigurasi aktual yang ditagihkan. |
| KonfigurasiHarga video | Kondisi penagihanresolution: 480p | Biaya Keluaran · Harga video $0.04 per detik video Acuan harga yang dipublikasikan untuk konfigurasi yang ditampilkan. Biaya akhir mengikuti konfigurasi aktual yang ditagihkan. |
| KonfigurasiHarga video | Kondisi penagihanresolution: 768p | Biaya Keluaran · Harga video $0.06 per detik video Acuan harga yang dipublikasikan untuk konfigurasi yang ditampilkan. Biaya akhir mengikuti konfigurasi aktual yang ditagihkan. |
| KonfigurasiHarga video | Kondisi penagihanmode pembuatan: reference; resolusi: 2k | Biaya Keluaran · Harga video $0.36 per detik video Acuan harga yang dipublikasikan untuk konfigurasi yang ditampilkan. Biaya akhir mengikuti konfigurasi aktual yang ditagihkan. |
| KonfigurasiHarga video | Kondisi penagihanmode pembuatan: reference; resolusi: 480p | Biaya Keluaran · Harga video $0.08 per detik video Acuan harga yang dipublikasikan untuk konfigurasi yang ditampilkan. Biaya akhir mengikuti konfigurasi aktual yang ditagihkan. |
| KonfigurasiHarga video | Kondisi penagihanmode pembuatan: reference; resolusi: 768p | Biaya 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
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
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
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
| Kolom | Jenis | Arti |
|---|---|---|
Kolomindex | Jenisinteger | ArtiPosisi video ini dalam daftar keluaran, dihitung dari nol. |
Kolomcontent_url | Jenisstring | ArtiURL unduhan HTTPS bertanda tangan untuk video yang telah selesai ini. |
Kolomsha256 | Jenisstring | null | ArtiDigest SHA-256 dari byte video asli; null jika tidak tersedia. |
Kolomsize_bytes | Jenisinteger | null | ArtiUkuran berkas video asli dalam byte; null jika tidak tersedia. |
Kolomduration_ms | Jenisinteger | null | ArtiDurasi video terukur dalam milidetik; null jika tidak tersedia. |
Kolomwidth | Jenisinteger | null | ArtiLebar video dalam piksel; null jika tidak tersedia. |
Kolomheight | Jenisinteger | null | ArtiTinggi video dalam piksel; null jika tidak tersedia. |
Kolomvideo_codec | Jenisstring | null | ArtiPengenal codec video; null jika tidak dicatat. |
Kolomhas_audio | Jenisboolean | null | ArtiApakah video memuat trek audio; null jika tidak diukur. |
Kolomaudio_codec | Jenisstring | null | ArtiPengenal codec audio; null jika tidak ada pengenal yang dicatat. |
Kesalahan dan langkah berikutnya
| Respons | Kondisi | Langkah berikutnya |
|---|---|---|
Respons404 · not_found_error | KondisiAkses 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_error | KondisiKunci API tidak cocok dengan akun yang diautentikasi. | Langkah berikutnyaPeriksa kunci API dan akses akun Anda sebelum mengirim. |
Respons400 · invalid_request_error | KondisiPermintaan tidak dapat dibaca, atau indeks unduhan tidak valid. | Langkah berikutnyaPerbaiki isi permintaan. Untuk unduhan, pilih indeks keluaran yang dikembalikan oleh tugas awal. |
Respons422 · price_unavailable | KondisiHarga 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_error | KondisiMasukan 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_error | KondisiSaldo atau batas yang tersedia tidak memungkinkan pencadangan dana. | Langkah berikutnyaPeriksa saldo dan batas yang tersedia sebelum mengirim permintaan baru. |
Respons503 · server_error | KondisiVerifikasi 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_check | KondisiHasil 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_unavailable | KondisiUnduhan 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_ready | KondisiKonten 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
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