Zhipu AI: CogVideoX 3

A CogVideoX 3 szövegből, képből vagy az első és utolsó képkocka párosából készít videót a gyártó dokumentált munkafolyamatában. Öt- vagy tízmásodperces képsorokat, több kimeneti méretet legfeljebb 4K-ig, 30 vagy 60 fps-t és opcionális generált hangeffektusokat támogat.

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

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 3 a Zhipu AI videómodellje, dokumentált szöveg-, kép-, valamint első és utolsó képkocka alapú generálással. A gyártó a képkockák stabilitását, az utasításkövetést és a realisztikus vagy háromdimenziós vizuális stílusokat emeli ki. Szöveget válassz, ha a jelenet írásos leírásból indul; egy képet, ha a vizuális alap már létezik; két végpontképet pedig akkor, ha a képsornak meghatározott nyitó- és zárónézetre van szüksége.

Szöveges leírásban mutasd be a témát és egy világosan követhető cselekményt. Add meg a környezetet, a nézőpontot és a fontos fizikai viszonyokat, hogy a jelenet egyértelmű szándékhoz mérten legyen megítélhető. Egy tárgyat felemelő karakter más képsort igényel, mint a tárgyat felfedő kamera. Mindkettőt csak akkor írd le, ha a kapcsolatuk számít a felvétel szempontjából.

Képalapú képsorhoz úgy készítsd elő a referenciát, hogy a téma megkülönböztető jegyei láthatók legyenek. A gyártó legfeljebb 5 MB-os PNG-, JPEG- és JPG-képeket fogad el URL vagy kódolt képadatok formájában. A tényleges referenciát tartsd a generált eredmény mellett, hogy a megjelenés és a képkivágás a forrással legyen összevethető, ne annak emlékezetből felidézett változatával.

A gyártó végpontképkocka-módja két képet fogad el sorrendben: az első határozza meg a nyitóképkockát, a második a záróképkockát. Egyetlen felvétel két kívánt állapotaként készítsd elő őket. Írd le az őket összekötő átmenetet vagy cselekményt, majd ellenőrizd, hogy a téma következetes marad-e a végpontok között. Két jó állókép önmagában nem mutatja meg, hogy a köztes mozgás illeszkedik-e a kívánt történethez.

A prompt legfeljebb 512 karaktert tartalmazhat. A rendelkezésre álló szöveget a cselekményre, annak irányára és a sikeres eredményt megkülönböztető vizuális részletekre használd. A leírás arra összpontosítson, aminek a képernyőn történnie kell. Ha a bemeneti képek már meghatározzák a téma megjelenését, azt a mozgást és időzítést írd le, amelynek a képek között vagy azokból kiindulva kell kibontakoznia.

A gyártó öt- vagy tízmásodperces kimenetet dokumentál, öt másodperces alapértelmezéssel és másodpercenként 30 vagy 60 képkockával. A támogatott méretek közé tartozik az 1280×720, 720×1280, 1024×1024, 1920×1080, 1080×1920, 2048×1080 és 3840×2160. A méretet és időzítést a célhoz válaszd, majd a kész klipen vizsgáld meg a képkivágást és a tényleges cselekmény tempóját.

A minőségi és sebességi módokat az opcionális AI-hangeffektusok beállításától külön dokumentálják. Ezeket a választásokat tartsd együtt a prompttal, képekkel és eredménnyel. A gyártó vizuális és bemeneti képességei a modellt írják le; egy adott generálási módszer elérhető vezérlőit az adott módszer műszaki specifikációja adja meg. Jelölt felvételek összehasonlításakor őrizd meg a ténylegesen használt beállításokat.

A videó elkészültéig őrizd meg az eredeti feladatazonosítót, és szerkesztéshez mentsd el a visszaadott felvételt. A teljes képsort ellenőrizd, beleértve a téma megjelenését nagy mozgások közben, a jelenet tárgyaival való kölcsönhatásokat és a végső kompozíciót. Végpontképkockás munkánál mindkét végpontot és a köztük lévő átmenetet vizsgáld meg. A konkrét vizuális eltérést javítsd a sikeres referenciák és felvételterv megtartásával, és a kész videókat hasonlítsd össze, ne csak az előnézeti képeiket.

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

cogvideox-3

Zhipu AI /cogvideox-3

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-3 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.3 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.3 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-3",
  "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-3

Metódusútvonalak álnevei

/v1/videos/generations

Kapcsolódó modellazonosítók

cogvideox-3

FAQ · Zhipu AI: CogVideoX 3

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

Zhipu AI: CogVideoX 3