Zhipu AI: CogVideoX 2

A CogVideoX 2 szöveges leírásból vagy megadott képből generál videót. A gyártó választható képkockaméreteket, 30 vagy 60 fps-t, minőségi vagy sebességi módot és opcionális generált hangeffektusokat dokumentál egy rövid vizuális jelenet kialakításához.

Ailoot Ultra · Videó POST /v1/videos cogvideox-2

A modellről

Ez a leírás a modell képességeit ismerteti. Az Ailootban elérhető bemenetek, kimenetek és lehetőségek alább, a kiválasztott metódusnál láthatók.

A CogVideoX 2 a Zhipu AI videógeneráló modellje írásos jelenetleíráshoz vagy megadott képhez. A szöveg határozza meg a témát, a környezetet és a cselekményt; a kép a generált képsor vizuális alapját adhatja. A felvételhez már rendelkezésre álló anyagot legjobban képviselő bemenetet használd, majd írd le a kész videóban elvárt látható mozgást.

Szövegalapú létrehozáshoz egyetlen összefüggő eseményt határozz meg. Egy műhelyajtót kinyitó ember, egy móló mellett elhaladó kis csónak vagy egyenletes fényben forgó tárgy egyaránt világosan érthető célt ad a felvételnek. Add meg a téma fontos jellemzőit, a nézőpontot és a mozgás irányát. Olyan lezárást válassz, amely használható a tervezett vágásban, ne hagyd meghatározatlanul a jelenet végső kompozícióját.

Képalapú létrehozáshoz készíts elő egy jól látható nézetet a témáról, és írd le, hogyan induljon belőle a jelenet mozgása. A gyártó legfeljebb 5 MB-os PNG-, JPEG- és JPG-referenciákat fogad el kép-URL vagy kódolt képadatok formájában. A fontos kontúrok, arcvonások és tárgyrészletek maradjanak láthatók a referencián, a kompozícióban pedig hagyj helyet a kért cselekménynek.

A gyártó 512 karakterre korlátozza az írásos promptot. Ezt a helyet a döntő részletekre használd: téma, cselekmény, környezet és nézőpont. Egy rövid leírás, amely megmagyarázza, melyik tárgy mozog és mi marad rögzítve, könnyebben értékelhető általános stílusjelzők felsorolásánál. Ha az eredmény elmarad a céltól, a megfigyelt mozgási vagy képkivágási problémához kapcsolódó utasítást módosítsd.

A közzétett kimeneti méretek négyzetes, fekvő és álló formátumokat tartalmaznak, 720×480 és 3840×2160 pixel közötti választási lehetőségekkel. A gyártó másodpercenként 30 vagy 60 képkockát is dokumentál. Generálás előtt a célhoz válassz képarányt és képkockasebességet, majd a tényleges klipen ellenőrizd, hogy a téma és fontos részletei jól kivehetők maradnak-e az adott képkivágásban.

A minőség és a sebesség névvel ellátott kimeneti mód a gyártó munkafolyamatában. Az opcionális, AI által generált hangeffektusok a vizuális leírástól külön vezérelhetők. A kiválasztott módot és a hangeffektusok beállítását tartsd együtt a prompttal és az esetleges referenciaképpel, hogy a különböző jelölt klipek a tényleges generálási beállításaik alapján legyenek összehasonlíthatók.

A generálás aszinkron: a kész videó elérhetősége előtt feladatazonosító érkezik vissza. Az eredmény ellenőrzése során őrizd meg ezt az azonosítót, és tartsd meg a művelethez kapcsolódó összes elkészült videófájlt. Szerkesztéshez magát a klipet mentsd el a forrásképpel együtt, ha használtál ilyet, ne ideiglenes eredményhelyre vagy előnézeti képkockára támaszkodj.

A teljes képsort ellenőrizd folytonosság, időzítés és a kért cselekmény szempontjából. Termékfelvételnél a forma és az anyagrészletek mozgás közben is maradjanak stabilak; karakterfelvételnél következetes megjelenés és gesztusok szükségesek. A végső kompozíciót és az esetleges generált hangot a felvétel céljához mérten ellenőrizd. Konkrét eltérés javításakor tartsd meg a jelenet sikeres elemeit, és az eredeti és módosított videót azonos megtekintési körülmények között hasonlítsd össze.

Ailoot Ultra · Videó POST /v1/videos cogvideox-2

cogvideox-2

Zhipu AI /cogvideox-2

Kezdő lépések

Elfogadott bemenetek: Szöveg
Eredmények: Videó

Elérhető az Ailootban · bemenetek és metódusok

Ailoot Ultra · Videó POST /v1/videos

Bemenet: text
Kimenet: video

Mező	Típus	Követelmény	Értékek és korlátok	Alapértelmezett
Mező`model`	Típus`string`	KövetelményKötelező	Értékek és korlátok cogvideox-2 Feltételek: Használja a pontos Ailoot modellválasztót.	Alapértelmezett—
Mező`prompt`	Típus`string`	KövetelményKötelező	Értékek és korlátok Feltételek: Írja le a jelenetet és a mozgást.	Alapértelmezett—
Mező`quality`	Típus`boolean`	KövetelményOpcionális	Értékek és korlátok Feltételek: Opcionális minőségjelző; ez a kiválasztott séma nem ad meg összeegyeztethető felsorolási értékeket vagy alapértelmezést.	Alapértelmezett—
Mező`with_audio`	Típus`boolean`	KövetelményOpcionális	Értékek és korlátok Feltételek: Bekapcsolva mesterséges intelligenciával generált hangeffektusokat hoz létre.	Alapértelmezettfalse
Mező`size`	Típus`string`	KövetelményOpcionális	Értékek és korlátok Feltételek: Konkrét méretek kiválasztásakor adja meg a dokumentált méret-karakterláncot.	Alapértelmezett—
Mező`fps`	Típus`string`	KövetelményOpcionális	Értékek és korlátok 30, 60 Feltételek: Ennél a kiválasztott natív metódusnál a képkockasebességet karakterlánc jelöli.	Alapértelmezett30
Mező`duration`	Típus`string`	KövetelményOpcionális	Értékek és korlátok 5, 10 Feltételek: Ennél a kiválasztott natív metódusnál a másodpercben megadott időtartamot karakterlánc jelöli.	Alapértelmezett5

Metódus paraméterei és életciklusa

Paraméter	Szerződés
Paraméter`content_type`	Szerződésapplication/json
Paraméter`required`	Szerződésmodel, prompt
Paraméter`optional`	Szerződésquality, with_audio, size, fps, duration
Paraméter`material_types`	Szerződéstext
Paraméter`conditions`	SzerződésHasználja a pontos Ailoot modellválasztót., Írja le a jelenetet és a mozgást., Opcionális minőségjelző; ez a kiválasztott séma nem ad meg összeegyeztethető felsorolási értékeket vagy alapértelmezést., Bekapcsolva mesterséges intelligenciával generált hangeffektusokat hoz létre., Konkrét méretek kiválasztásakor adja meg a dokumentált méret-karakterláncot., Ennél a kiválasztott natív metódusnál a képkockasebességet karakterlánc jelöli., Ennél a kiválasztott natív metódusnál a másodpercben megadott időtartamot karakterlánc jelöli.

Metódus álnevei: /v1/videos/generations

Életciklus: 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}

Díjcsomagok

A végső díj számítása

A megjelenített díjtételek a generálás előtti költségbecsléshez szolgálnak. A végleges díj az eredeti generáláshoz rögzített költségből számítódik. A kimenet mért időtartama és az előre jelzett mennyiségek nem azonosak a véglegesen elszámolandó mennyiséggel.

A díjszabás nem ad új kérési lehetőségeket. A támogatott paraméterek a kiválasztott módszernél szerepelnek.

Gyors mód: Nincs megadva Ha a gyors mód van kiválasztva
Flex mód: Nincs megadva Ha a flex mód van kiválasztva
Maximális gondolkodási ráfordítás: Nincs megadva Ha a maximális gondolkodási ráfordításra a default beállításhoz tartozó korrekció vonatkozik

Becsült díjak összehasonlításhoz

Árak beállításonként

Minden díjat a megjelenített feltételekhez rendeljen. Az alternatív beállítások minden csoportjához egy díjtételt használjon.

Beállítás	Díjtáblázat	Előre jelzett mennyiség	Elszámolási mennyiség	Díj
BeállításTokenek alapdíjai	DíjtáblázatAlapdíj	Előre jelzett mennyiség—	Elszámolási mennyiség—	Díj Bemenet · Bemeneti tokenek · Becslés, csak összehasonlításra — / 1K token Kimenet · Kimeneti tokenek · Becslés, csak összehasonlításra — / 1K token Bemenet · Gyorsítótár olvasása · Becslés, csak összehasonlításra — / 1K token Bemenet · Írás a gyorsítótárba · Becslés, csak összehasonlításra — / 1K token Bemenet · Írás a gyorsítótárba, 1 óra · Becslés, csak összehasonlításra — / 1K token
BeállításKérésenként	Díjtáblázat—	Előre jelzett mennyiség—	Elszámolási mennyiségegy kérés	Díj Bemenet · Becslés, csak összehasonlításra $0.2 kérésenként
BeállításA generálás becsült költsége	Díjtáblázat—	Előre jelzett mennyiségbecslés egy generálásra	Elszámolási mennyiség—	Díj Kimenet · Becsült generálási költség · Becslés, csak összehasonlításra $0.2 becslés a generálás előtt Ez a becslés nem jelent további díjat, és nem rögzített díjszabás az elkészült generálásra.

Az Ailoot a kérés előtt becsült összeget foglal le. Az eredmény után a mért használat alapján elszámolja a végső díjat. Folyamatos átvitel esetén a végső használati rekordot használja. A foglalás és az elszámolás működése →

Példakérések

Ailoot Ultra · Videó

curl · hozd létre egyszer, és őrizd meg a művelet visszaigazolásátOlvasd be az eredeti feladatotMents el minden elkészült, a tulajdonodban lévő digitális elemet

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

Eredmények fogadása és mentése

Ailoot Ultra · Videó

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}

Őrizzen meg minden elkészült eredményt

Mentsen minden elkészült videót és visszaadott fájlt; töltse le az összes ténylegesen visszaadott médiafájl URL-jének tartalmát.

Őrizze meg a teljes választ és fejléceit, az eredeti azonosítókat, az összes tényleges kimenetet és minden felhasználási, illetve elszámolási mezőt. Mentsen el minden egyedi saját médiaállományt, és őrizzen meg minden rá mutató szerepet.

Ha az eredeti választ ellenőrizni kell

Őrizze meg a visszaadott nyilvános feladat- vagy műveletazonosítót és az összes fejlécet. Csak az eredeti feladatot kérdezze le; az unknown vagy result_pending_check nem jogosít fel újabb létrehozásra.

Válaszmezők

Mező	Típus
Mező`id`	Típusstring
Mező`polling_url`	Típusstring
Mező`provider_task_id`	Típusstring
Mező`id`	Típusstring
Mező`task_status`	Típusstring
Mező`video_result[].url`	Típusstring

Álnevek

Modell álnevei

Ailoot Ultra cogvideox-2

Metódusútvonalak álnevei

/v1/videos/generations

Kapcsolódó modellazonosítók

cogvideox-2

FAQ · Zhipu AI: CogVideoX 2

Milyen bemenetek és eredmények érhetők el?: POST /v1/videos · cogvideox-2: text → video
Mely mezőket használja a kérés?: POST /v1/videos · cogvideox-2: model, prompt, quality, with_audio, size, fps, duration

Zhipu AI: CogVideoX 2