PixVerse v4
Teks/gambar-ke-video dengan durasi 5/8 detik, lima rasio aspek, serta pilihan kualitas 360p–1080p.
Tentang model
Deskripsi ini mencakup kemampuan model. Masukan, keluaran, dan opsi yang tersedia di Ailoot tercantum di bawah untuk metode yang dipilih.
pixverse-v4 menerima teks serta gambar referensi opsional untuk generasi video. Pilihan aspect_ratio adalah 16:9, 4:3, 1:1, 3:4 dan 9:16; quality menerima 360p, 540p, 720p atau 1080p. Duration adalah 5 atau 8 detik. Contoh konkret adalah menyiapkan shot produk vertikal dari gambar referensi untuk suntingan sosial singkat.
Metode /v1/videos juga mencantumkan motion_mode normal atau fast, bersama negative_prompt dan end_image opsional. Field lip-sync merupakan kontrol bernama terpisah dan harus mengikuti definisi metodenya, bukan alur unggahan audio umum yang diasumsikan. Pilih kombinasi yang didukung permintaan terpilih. Kumpulkan pekerjaan asli serta setiap output aktual; fast adalah nilai mode gerak, bukan jaminan waktu generasi terukur.
Ailoot Ultra · Video POST /v1/videos pixverse-v4
pixverse-v4Mulai
Teks/gambar-ke-video dengan durasi 5/8 detik, lima rasio aspek, serta pilihan kualitas 360p–1080p.
- Masukan yang diterima
- Teks · Gambar
- Hasil
- Video
Tersedia di Ailoot · masukan & metode
Ailoot Ultra · Video POST /v1/videos
- Masukan
text,image- Keluaran
video
| Kolom | Jenis | Persyaratan | Nilai & batasan | Bawaan |
|---|---|---|---|---|
Kolommodel | Jenisstring | PersyaratanWajib | Nilai & batasan pixverse-v4 Kondisi: Gunakan pemilih perutean Ailoot ini persis seperti yang ditampilkan. | Bawaan— |
Kolomprompt | Jenisstring | PersyaratanWajib | Nilai & batasan Kondisi: Jelaskan adegan dan gerakannya. | Bawaan— |
Kolomaspect_ratio | Jenisstring | PersyaratanOpsional | Nilai & batasan 16:9, 4:3, 1:1, 3:4, 9:16 Kondisi: Gunakan rasio aspek yang tercantum untuk model yang dipilih. | Bawaan— |
Kolomquality | Jenisstring | PersyaratanOpsional | Nilai & batasan 360p, 540p, 720p, 1080p Kondisi: Gunakan nilai kualitas yang tercantum untuk model yang dipilih. | Bawaan— |
Kolommotion_mode | Jenisstring | PersyaratanOpsional | Nilai & batasan normal, fast Kondisi: Gunakan mode gerakan yang tercantum untuk model yang dipilih. | Bawaan— |
Kolomduration | Jenisinteger | PersyaratanOpsional | Nilai & batasan 5, 8 Kondisi: Gunakan durasi yang tercantum; jangan mengasumsikan nilai bawaan yang tidak disebutkan. | Bawaan— |
Kolomend_image | Jenisstring | PersyaratanOpsional | Nilai & batasan Kondisi: Bingkai akhir opsional memilih mode gambar yang didukung. | Bawaan— |
Kolomlip_sync_tts_content | Jenisstring | PersyaratanOpsional | Nilai & batasan Kondisi: Konten ucapan opsional untuk model yang dipilih. | Bawaan— |
Kolomlip_sync_tts_speaker_id | Jenisstring | PersyaratanOpsional | Nilai & batasan Kondisi: Gunakan ID suara yang benar-benar didukung penyedia; jangan mengarang ID suara. | Bawaan— |
Kolomimage | Jenisstring or array<string> | PersyaratanOpsional | Nilai & batasan Kondisi: Gunakan URL gambar Anda yang sebenarnya dan dapat diakses publik, atau gambar base64; model yang dipilih mendukung masukan gambar. | Bawaan— |
Kolomnegative_prompt | Jenisstring | PersyaratanOpsional | Nilai & batasan Kondisi: Jelaskan konten yang harus dihindari. | Bawaan— |
Parameter metode dan siklus hidup
| Parameter | Kontrak |
|---|---|
Parametercontent_type | Kontrakapplication/json |
Parameterrequired | Kontrakmodel, prompt |
Parameteroptional | Kontrakaspect_ratio, quality, motion_mode, duration, end_image, lip_sync_tts_content, lip_sync_tts_speaker_id, image, negative_prompt |
Parametermaterial_types | Kontraktext, image |
Parameterconditions | KontrakGunakan pemilih perutean Ailoot ini persis seperti yang ditampilkan., Jelaskan adegan dan gerakannya., Gunakan rasio aspek yang tercantum untuk model yang dipilih., Gunakan nilai kualitas yang tercantum untuk model yang dipilih., Gunakan mode gerakan yang tercantum untuk model yang dipilih., Gunakan durasi yang tercantum; jangan mengasumsikan nilai bawaan yang tidak disebutkan., Bingkai akhir opsional memilih mode gambar yang didukung., Konten ucapan opsional untuk model yang dipilih., Gunakan ID suara yang benar-benar didukung penyedia; jangan mengarang ID suara., Gunakan URL gambar Anda yang sebenarnya dan dapat diakses publik, atau gambar base64; model yang dipilih mendukung masukan gambar., Jelaskan konten yang harus dihindari. |
Alias metode: /v1/videos/generations
Siklus hidup: submit_once_poll_original
GET /v1/videos/{request_id}
GET /v1/videos/generations/{request_id}
GET /v1/videos/{request_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
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 | Biaya |
|---|---|---|---|
| KonfigurasiTarif dasar token | Jadwal tarifTarif dasar | Jumlah perkiraan— | 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 |
| KonfigurasiPerkiraan biaya pembuatan | Jadwal tarif— | Jumlah perkiraanestimasi satu kali pembuatan | 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 →
Contoh permintaan
Ailoot Ultra · Video
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
cat > request.json <<'JSON'
{
"model": "pixverse-v4",
"prompt": "A cat is walking on grass."
}
JSON
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
# Create once; retain id, polling_url, original task identifiers and every header.
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_STATUS'
import json,os,subprocess
from pathlib import Path
from urllib.parse import urljoin,urlsplit
r=json.loads(Path("result.json").read_text())
u=urljoin("https://api.ailoot.ai",r["polling_url"])
p=urlsplit(u)
if p.scheme!="https" or p.netloc!="api.ailoot.ai" or p.username or p.password:
raise SystemExit("Unexpected returned polling URL; preserve the response")
subprocess.run(["curl","--fail-with-body","--silent","--show-error",u,"-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"],"-D","status-headers.txt","-o","status.json"],check=True)
# Read this same original polling_url again while pending.
# Preserve unknown/result_pending_check; do not repeat creation.
PY_STATUS
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())
roles={}
def visit(v,path=""):
if isinstance(v,dict):
for k,x in v.items(): visit(x,path+"/"+k)
elif isinstance(v,list):
for i,x in enumerate(v): visit(x,path+"/"+str(i))
elif isinstance(v,str):
u=urljoin("https://api.ailoot.ai",v); p=urlsplit(u)
if p.scheme=="https" and p.netloc=="api.ailoot.ai" and not p.username and not p.password and p.path.startswith("/v1/media/assets/") and p.path.endswith("/content"):
roles.setdefault(u,[]).append(path)
visit(r)
if not roles: raise SystemExit("No completed owned assets; retain the original status")
manifest=[]
for i,(u,paths) in enumerate(roles.items()):
target=Path(f"asset-{i}.bin")
subprocess.run(["curl","--fail-with-body","--silent","--show-error",u,"-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"],"-o",str(target)],check=True)
raw=target.read_bytes()
if not raw: raise SystemExit("Empty asset; retain original status and metadata")
ext="glb" if raw[:4]==b"glTF" else "png" if raw[:8]==b"\x89PNG\r\n\x1a\n" else "jpg" if raw[:3]==b"\xff\xd8\xff" else "webp" if raw[:4]==b"RIFF" and raw[8:12]==b"WEBP" else "mp4" if raw[4:8]==b"ftyp" else "bin"
name=f"asset-{i}.{ext}"
if target.name!=name: target.rename(name)
manifest.append({"file":name,"response_paths":paths,"bytes":len(raw)})
Path("asset-manifest.json").write_text(json.dumps(manifest,indent=2))
print("Saved",len(manifest),"unique owned assets; every response role retained")
PY_ASSETS
Terima dan simpan hasil
Ailoot Ultra · Video
GET /v1/videos/{request_id}GET /v1/videos/generations/{request_id}GET /v1/videos/{request_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}
Simpan semua hasil yang selesai
Simpan setiap video yang selesai atau berkas yang dikembalikan; ambil setiap URL aset yang benar-benar dikembalikan.
Simpan respons dan header secara utuh, pengenal asli, setiap keluaran aktual, dan semua bidang penggunaan/akuntansi. Simpan setiap aset unik milik Ailoot dan pertahankan setiap peran yang menunjuk kepadanya.
Jika respons asli perlu diperiksa
Simpan id tugas atau operasi publik yang dikembalikan beserta semua header. Baca hanya tugas awal; unknown atau result_pending_check tidak mengizinkan pembuatan lain.
Kolom respons
| Kolom | Jenis |
|---|---|
Kolomid | Jenisstring |
Kolompolling_url | Jenisstring |
Kolomprovider_task_id | Jenisstring |
Kolomtask_id | Jenisstring |
Kolomstatus | Jenisstring |
Kolomvideo_url | Jenisstring |
Alias
Alias model
Ailoot Ultra pixverse-v4
Alias jalur metode
/v1/videos/generations
ID pemanggil terkait
FAQ · PixVerse v4
- Input dan hasil apa yang tersedia?
POST /v1/videos·pixverse-v4:text,image→video- Kolom apa yang digunakan permintaan?
POST /v1/videos·pixverse-v4:model,prompt,aspect_ratio,quality,motion_mode,duration,end_image,lip_sync_tts_content,lip_sync_tts_speaker_id,image,negative_prompt