Zhipu AI: CogVideoX 2

CogVideoX 2 menjana video daripada penerangan teks atau imej yang diberikan. Pembuatnya mendokumentasikan saiz bingkai yang boleh dipilih, 30 atau 60 fps, mod kualiti atau kelajuan dan kesan bunyi terjana pilihan untuk membentuk adegan visual pendek.

Ailoot Ultra · Penjanaan video POST /v1/videos cogvideox-2

Tentang model

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

CogVideoX 2 ialah model penjanaan video Zhipu AI untuk penerangan adegan bertulis atau imej yang diberikan. Teks menetapkan subjek, latar dan aksi; imej boleh menyediakan asas visual bagi jujukan yang dijana. Gunakan input yang paling mewakili bahan yang sudah tersedia untuk syot, kemudian terangkan gerakan yang patut kelihatan dalam video yang siap.

Untuk penciptaan berpandukan teks, tentukan satu peristiwa yang utuh. Seseorang membuka pintu bengkel, bot kecil melalui jeti atau objek berpusing di bawah cahaya tetap masing-masing memberikan syot tujuan yang mudah difahami. Nyatakan ciri penting subjek, sudut pandangan dan arah gerakan. Pilih pengakhiran yang boleh digunakan dalam penyuntingan yang dimaksudkan dan jangan biarkan komposisi akhir adegan tidak ditentukan.

Untuk penciptaan berasaskan imej, sediakan pandangan subjek yang jelas dan terangkan bagaimana adegan patut bergerak daripadanya. Pembuatnya menerima rujukan PNG, JPEG dan JPG sehingga 5 MB, yang diberikan melalui URL imej atau data imej yang dikodkan. Pastikan tepi penting, ciri wajah dan butiran objek kelihatan dalam rujukan, dan tinggalkan ruang dalam komposisi untuk aksi yang diminta.

Pembuatnya mengehadkan prompt bertulis kepada 512 aksara. Gunakan ruang ini untuk butiran penentu: subjek, aksi, latar dan sudut pandangan. Penerangan pendek yang menjelaskan objek yang bergerak dan perkara yang kekal pegun lebih mudah dinilai daripada senarai kata sifat gaya yang umum. Jika hasil tidak mencapai matlamat, semak arahan yang berkaitan dengan masalah gerakan atau pembingkaian yang diperhatikan.

Saiz output yang diterbitkan merangkumi format segi empat sama, landskap dan potret, dengan pilihan daripada 720×480 hingga 3840×2160 piksel. Pembuatnya turut mendokumentasikan 30 atau 60 bingkai sesaat. Pilih bentuk dan kadar bingkai mengikut tujuan penggunaan sebelum penjanaan, kemudian periksa klip sebenar untuk melihat sama ada subjek serta butiran pentingnya masih jelas dalam pembingkaian itu.

Kualiti dan kelajuan ialah mod output bernama dalam aliran kerja pembuatnya. Kesan bunyi janaan AI yang bersifat pilihan dikawal secara berasingan daripada penerangan visual. Simpan mod dan tetapan kesan bunyi yang dipilih bersama prompt serta imej rujukan jika digunakan, supaya klip calon yang berbeza dapat dibandingkan menggunakan tetapan penjanaan sebenarnya.

Penjanaan berlaku secara tak segerak: identiti tugas dikembalikan sebelum video yang siap tersedia. Kekalkan identiti itu sepanjang semakan hasil dan simpan semua fail video yang siap berkaitan dengan operasi tersebut. Simpan klip itu sendiri untuk penyuntingan, bersama imej sumber apabila digunakan, dan jangan bergantung pada lokasi hasil sementara atau bingkai pratonton.

Semak seluruh jujukan dari segi kesinambungan, pemasaan dan aksi yang diminta. Syot produk memerlukan bentuk serta butiran bahan yang stabil sepanjang gerakan; syot watak memerlukan rupa dan gerak isyarat yang konsisten. Periksa komposisi akhir dan bunyi terjana jika ada berdasarkan tujuan syot. Kekalkan unsur adegan yang berjaya semasa menyemak ketidakpadanan yang konkrit, dan gunakan keadaan tontonan yang sama untuk membandingkan video asal dengan video yang disemak.

Ailoot Ultra · Penjanaan video POST /v1/videos cogvideox-2

cogvideox-2

Zhipu AI /cogvideox-2

Pengenalan

Input yang diterima: Teks
Hasil: Video

Tersedia di Ailoot · input & kaedah

Ailoot Ultra · Penjanaan video POST /v1/videos

Input: text
Output: video

Medan	Jenis	Keperluan	Nilai & had	Lalai
Medan`model`	Jenis`string`	KeperluanDiperlukan	Nilai & had cogvideox-2 Syarat: Gunakan pemilih model Ailoot yang tepat.	Lalai—
Medan`prompt`	Jenis`string`	KeperluanDiperlukan	Nilai & had Syarat: Huraikan adegan dan pergerakan.	Lalai—
Medan`quality`	Jenis`boolean`	KeperluanPilihan	Nilai & had Syarat: Bendera kualiti pilihan; skema yang dipilih ini tidak memberikan enum yang serasi atau nilai lalai.	Lalai—
Medan`with_audio`	Jenis`boolean`	KeperluanPilihan	Nilai & had Syarat: Jana kesan bunyi AI apabila diaktifkan.	Lalaifalse
Medan`size`	Jenis`string`	KeperluanPilihan	Nilai & had Syarat: Berikan rentetan saiz yang didokumenkan apabila memilih dimensi secara jelas.	Lalai—
Medan`fps`	Jenis`string`	KeperluanPilihan	Nilai & had 30, 60 Syarat: Kadar bingkai diwakili sebagai rentetan dalam kaedah natif yang dipilih ini.	Lalai30
Medan`duration`	Jenis`string`	KeperluanPilihan	Nilai & had 5, 10 Syarat: Tempoh dalam saat diwakili sebagai rentetan dalam kaedah natif yang dipilih ini.	Lalai5

Parameter kaedah dan kitar hayat

Parameter	Kontrak
Parameter`content_type`	Kontrakapplication/json
Parameter`required`	Kontrakmodel, prompt
Parameter`optional`	Kontrakquality, with_audio, size, fps, duration
Parameter`material_types`	Kontraktext
Parameter`conditions`	KontrakGunakan pemilih model Ailoot yang tepat., Huraikan adegan dan pergerakan., Bendera kualiti pilihan; skema yang dipilih ini tidak memberikan enum yang serasi atau nilai lalai., Jana kesan bunyi AI apabila diaktifkan., Berikan rentetan saiz yang didokumenkan apabila memilih dimensi secara jelas., Kadar bingkai diwakili sebagai rentetan dalam kaedah natif yang dipilih ini., Tempoh dalam saat diwakili sebagai rentetan dalam kaedah natif yang dipilih ini.

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	Kuantiti pengebilan	Caj
KonfigurasiKadar asas token	Jadual kadarKadar asas	Kuantiti ramalan—	Kuantiti 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
KonfigurasiBagi setiap permintaan	Jadual kadar—	Kuantiti ramalan—	Kuantiti pengebilansatu permintaan	Caj Input · Anggaran untuk perbandingan sahaja $0.2 bagi setiap permintaan
KonfigurasiAnggaran kos penjanaan	Jadual kadar—	Kuantiti ramalananggaran untuk satu penjanaan	Kuantiti 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 →

Contoh permintaan

Ailoot Ultra · Penjanaan video

curl · cipta sekali sahaja dan simpan rekod penerimaanBaca tugas asalSimpan setiap aset milik anda yang telah siap

set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
cat > request.json <<'JSON'
{
  "model": "cogvideox-2",
  "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 · Penjanaan video

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}

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
Medan`id`	Jenisstring
Medan`polling_url`	Jenisstring
Medan`provider_task_id`	Jenisstring
Medan`id`	Jenisstring
Medan`task_status`	Jenisstring
Medan`video_result[].url`	Jenisstring

Alias

Alias model

Ailoot Ultra cogvideox-2

Alias laluan kaedah

/v1/videos/generations

ID pemanggil berkaitan

cogvideox-2

FAQ · Zhipu AI: CogVideoX 2

Apakah input dan hasil yang tersedia?: POST /v1/videos · cogvideox-2: text → video
Apakah medan yang digunakan oleh permintaan?: POST /v1/videos · cogvideox-2: model, prompt, quality, with_audio, size, fps, duration

Zhipu AI: CogVideoX 2