PixVerse v4
Teks/imej kepada video dengan tempoh 5/8 saat, lima nisbah aspek dan pilihan kualiti 360p–1080p.
Tentang model
Huraian ini merangkumi keupayaan model. Input, output dan pilihan yang tersedia di Ailoot disenaraikan di bawah untuk kaedah yang dipilih.
pixverse-v4 menerima teks dan imej rujukan pilihan untuk penjanaan video. Pilihan aspect_ratio ialah 16:9, 4:3, 1:1, 3:4 dan 9:16; quality menerima 360p, 540p, 720p atau 1080p. Duration ialah 5 atau 8 saat. Kegunaan konkrit ialah menyediakan syot produk menegak daripada imej rujukan untuk suntingan sosial pendek.
Kaedah /v1/videos turut menyenaraikan motion_mode normal atau fast, bersama negative_prompt dan end_image pilihan. Medan lip-sync ialah kawalan bernama berasingan dan patut mengikuti definisi kaedah, bukan aliran muat naik audio umum diandaikan. Pilih gabungan disokong permintaan dipilih. Kumpulkan tugas asal serta setiap output sebenar; fast ialah nilai mod gerakan, bukan jaminan masa penjanaan diukur.
Ailoot Ultra · Video POST /v1/videos pixverse-v4
pixverse-v4Pengenalan
Teks/imej kepada video dengan tempoh 5/8 saat, lima nisbah aspek dan pilihan kualiti 360p–1080p.
- Input yang diterima
- Teks · Imej
- Hasil
- Video
Tersedia di Ailoot · input & kaedah
Ailoot Ultra · Video POST /v1/videos
- Input
text,image- Output
video
| Medan | Jenis | Keperluan | Nilai & had | Lalai |
|---|---|---|---|---|
Medanmodel | Jenisstring | KeperluanDiperlukan | Nilai & had pixverse-v4 Syarat: Gunakan pemilih penghalaan Ailoot ini tepat seperti yang dinyatakan. | Lalai— |
Medanprompt | Jenisstring | KeperluanDiperlukan | Nilai & had Syarat: Huraikan adegan dan gerakannya. | Lalai— |
Medanaspect_ratio | Jenisstring | KeperluanPilihan | Nilai & had 16:9, 4:3, 1:1, 3:4, 9:16 Syarat: Gunakan nisbah bidang yang disenaraikan untuk model yang dipilih. | Lalai— |
Medanquality | Jenisstring | KeperluanPilihan | Nilai & had 360p, 540p, 720p, 1080p Syarat: Gunakan nilai kualiti yang disenaraikan untuk model yang dipilih. | Lalai— |
Medanmotion_mode | Jenisstring | KeperluanPilihan | Nilai & had normal, fast Syarat: Gunakan mod gerakan yang disenaraikan untuk model yang dipilih. | Lalai— |
Medanduration | Jenisinteger | KeperluanPilihan | Nilai & had 5, 8 Syarat: Gunakan tempoh yang disenaraikan; jangan andaikan nilai lalai yang tidak dinyatakan. | Lalai— |
Medanend_image | Jenisstring | KeperluanPilihan | Nilai & had Syarat: Bingkai akhir pilihan menentukan mod imej yang disokong. | Lalai— |
Medanlip_sync_tts_content | Jenisstring | KeperluanPilihan | Nilai & had Syarat: Kandungan pertuturan pilihan untuk model yang dipilih. | Lalai— |
Medanlip_sync_tts_speaker_id | Jenisstring | KeperluanPilihan | Nilai & had Syarat: Gunakan ID suara sebenar yang disokong penyedia; jangan reka ID suara. | Lalai— |
Medanimage | Jenisstring or array<string> | KeperluanPilihan | Nilai & had Syarat: Gunakan URL imej anda yang sebenar dan boleh dicapai secara awam, atau imej base64; model yang dipilih menyokong input imej. | Lalai— |
Medannegative_prompt | Jenisstring | KeperluanPilihan | Nilai & had Syarat: Huraikan kandungan yang perlu dielakkan. | Lalai— |
Parameter kaedah dan kitar hayat
| 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 penghalaan Ailoot ini tepat seperti yang dinyatakan., Huraikan adegan dan gerakannya., Gunakan nisbah bidang yang disenaraikan untuk model yang dipilih., Gunakan nilai kualiti yang disenaraikan untuk model yang dipilih., Gunakan mod gerakan yang disenaraikan untuk model yang dipilih., Gunakan tempoh yang disenaraikan; jangan andaikan nilai lalai yang tidak dinyatakan., Bingkai akhir pilihan menentukan mod imej yang disokong., Kandungan pertuturan pilihan untuk model yang dipilih., Gunakan ID suara sebenar yang disokong penyedia; jangan reka ID suara., Gunakan URL imej anda yang sebenar dan boleh dicapai secara awam, atau imej base64; model yang dipilih menyokong input imej., Huraikan kandungan yang perlu dielakkan. |
Alias kaedah: /v1/videos/generations
Kitar hayat: 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}
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 | Caj |
|---|---|---|---|
| KonfigurasiKadar asas token | Jadual kadarKadar asas | Kuantiti ramalan— | 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 |
| KonfigurasiAnggaran kos penjanaan | Jadual kadar— | Kuantiti ramalananggaran untuk satu penjanaan | 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 →
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 fail yang dikembalikan; dapatkan setiap URL aset yang benar-benar dikembalikan.
Simpan respons dan pengepala lengkap, pengecam asal, setiap output sebenar dan semua medan penggunaan/perakaunan. Simpan setiap aset unik milik anda dan kekalkan setiap peranan yang merujuk kepadanya.
Jika respons asal perlu disemak
Simpan id tugas atau operasi awam yang dikembalikan dan semua pengepala. Baca tugas asal sahaja; unknown atau result_pending_check tidak memberikan kebenaran untuk penciptaan lain.
Medan respons
| Medan | Jenis |
|---|---|
Medanid | Jenisstring |
Medanpolling_url | Jenisstring |
Medanprovider_task_id | Jenisstring |
Medantask_id | Jenisstring |
Medanstatus | Jenisstring |
Medanvideo_url | Jenisstring |
Alias
Alias model
Ailoot Ultra pixverse-v4
Alias laluan kaedah
/v1/videos/generations
ID pemanggil berkaitan
FAQ · PixVerse v4
- Apakah input dan hasil yang tersedia?
POST /v1/videos·pixverse-v4:text,image→video- Apakah medan yang digunakan oleh 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