Zhipu AI: CogVideoX 3

CogVideoX 3 vytvára video z textu, obrázka alebo dvojice prvej a poslednej snímky v postupe dokumentovanom výrobcom. Podporuje päť- alebo desaťsekundové sekvencie, viacero výstupných rozmerov až do 4K, 30 alebo 60 fps a voliteľné generované zvukové efekty.

Ailoot Ultra · Generovanie videa POST /v1/videos cogvideox-3

O modeli

Tento opis pokrýva možnosti modelu. Dostupné vstupy, výstupy a voľby v Ailoot sú uvedené nižšie pre vybranú metódu.

CogVideoX 3 je videomodel Zhipu AI s dokumentovaným generovaním z textu, obrázka a prvej a poslednej snímky. Výrobca zdôrazňuje stabilitu snímok, dodržiavanie pokynov a realistické alebo trojrozmerné vizuálne štýly. Vyberte text, keď scéna začína písomným zadaním; jeden obrázok, keď už existuje jej vizuálny základ; alebo dva obrázky krajných snímok, keď sekvencia potrebuje určený úvodný a záverečný pohľad.

V textovom zadaní opíšte subjekt a jeden zrozumiteľný dej. Uveďte prostredie, uhol pohľadu a dôležité fyzické vzťahy, aby sa scéna dala posúdiť voči jasnému zámeru. Postava zdvíhajúca predmet potrebuje inú sekvenciu než kamera, ktorá tento predmet odhaľuje. Oboje opisujte iba vtedy, keď je ich vzťah pre záber dôležitý.

Pri sekvencii založenej na obrázku pripravte referenciu tak, aby boli viditeľné rozlišujúce črty subjektu. Výrobca prijíma obrázky PNG, JPEG a JPG s veľkosťou najviac 5 MB, dodané cez URL alebo zakódované obrazové dáta. Skutočnú referenciu uchovajte spolu s generovaným výsledkom, aby sa vzhľad a kompozícia záberu porovnávali so zdrojom, nie s jeho zapamätanou podobou.

Režim krajných snímok výrobcu prijíma dva obrázky v danom poradí: prvý určuje úvodnú snímku a druhý záverečnú. Pripravte ich ako dva zamýšľané stavy jedného záberu. Opíšte prechod alebo dej, ktorý ich spája, a potom skontrolujte, či subjekt zostáva medzi krajnými snímkami konzistentný. Dvojica dobrých statických obrázkov sama osebe nedokazuje, že pohyb medzi nimi zodpovedá požadovanému príbehu.

Prompt môže obsahovať najviac 512 znakov. Dostupný text využite na dej, jeho smer a vizuálne detaily, ktoré odlišujú úspešný výsledok. Zadanie sústreďte na to, čo sa má diať na obrazovke. Keď vstupné obrázky už určujú vzhľad subjektu, opíšte pohyb a načasovanie, ktoré sa majú rozvinúť medzi nimi alebo z nich.

Výrobca dokumentuje päť- alebo desaťsekundový výstup, pričom predvolené trvanie je päť sekúnd, a 30 alebo 60 snímok za sekundu. Podporované rozmery zahŕňajú 1280×720, 720×1280, 1024×1024, 1920×1080, 1080×1920, 2048×1080 a 3840×2160. Veľkosť a načasovanie vyberte podľa miesta použitia a potom v hotovom klipe skontrolujte kompozíciu záberu a tempo skutočného deja.

Režimy kvality a rýchlosti sú dokumentované oddelene od voliteľného nastavenia zvukových efektov AI. Tieto voľby uchovajte spolu s promptom, obrázkami a výsledkom. Vizuálne a vstupné schopnosti uvádzané výrobcom opisujú model; dostupné ovládacie prvky konkrétnej metódy generovania určuje špecifikácia tejto metódy. Pri porovnávaní kandidátnych záberov zachovajte skutočne použité nastavenia.

Pôvodný identifikátor úlohy uchovajte až do dokončenia videa a vrátený záznam uložte na strih. Skontrolujte celú sekvenciu vrátane vzhľadu subjektu pri veľkom pohybe, interakcií s predmetmi scény a konečnej kompozície. Pri práci s krajnými snímkami skontrolujte obe krajné snímky aj prechod medzi nimi. Upravte konkrétny vizuálny nesúlad, pričom zachovajte vydarené referencie a plán záberu, a porovnávajte hotové videá, nie iba ich náhľady.

Ailoot Ultra · Generovanie videa POST /v1/videos cogvideox-3

cogvideox-3

Zhipu AI /cogvideox-3

Úvod

Povolené vstupy: Text
Výsledky: Video

Dostupné v Ailoot · vstupy a metódy

Ailoot Ultra · Generovanie videa POST /v1/videos

Vstup: text
Výstup: video

Pole	Typ	Požiadavka	Hodnoty a limity	Predvolené
Pole`model`	Typ`string`	PožiadavkaPovinné	Hodnoty a limity cogvideox-3 Podmienky: Použite presný volič modelu Ailoot.	Predvolené—
Pole`prompt`	Typ`string`	PožiadavkaPovinné	Hodnoty a limity Podmienky: Opíšte scénu a pohyb.	Predvolené—
Pole`quality`	Typ`boolean`	PožiadavkaVoliteľné	Hodnoty a limity Podmienky: Voliteľný príznak kvality; táto vybraná schéma neposkytuje kompatibilný enum ani predvolenú hodnotu.	Predvolené—
Pole`with_audio`	Typ`boolean`	PožiadavkaVoliteľné	Hodnoty a limity Podmienky: Keď je zapnuté, generuje zvukové efekty pomocou AI.	Predvolenéfalse
Pole`size`	Typ`string`	PožiadavkaVoliteľné	Hodnoty a limity Podmienky: Pri výbere explicitných rozmerov zadajte zdokumentovaný reťazec size.	Predvolené—
Pole`fps`	Typ`string`	PožiadavkaVoliteľné	Hodnoty a limity 30, 60 Podmienky: Snímková frekvencia je pri tejto vybranej natívnej metóde vyjadrená reťazcom.	Predvolené30
Pole`duration`	Typ`string`	PožiadavkaVoliteľné	Hodnoty a limity 5, 10 Podmienky: Dĺžka v sekundách je pri tejto vybranej natívnej metóde vyjadrená reťazcom.	Predvolené5

Parametre a životný cyklus metódy

Parameter	Špecifikácia
Parameter`content_type`	Špecifikáciaapplication/json
Parameter`required`	Špecifikáciamodel, prompt
Parameter`optional`	Špecifikáciaquality, with_audio, size, fps, duration
Parameter`material_types`	Špecifikáciatext
Parameter`conditions`	ŠpecifikáciaPoužite presný volič modelu Ailoot., Opíšte scénu a pohyb., Voliteľný príznak kvality; táto vybraná schéma neposkytuje kompatibilný enum ani predvolenú hodnotu., Keď je zapnuté, generuje zvukové efekty pomocou AI., Pri výbere explicitných rozmerov zadajte zdokumentovaný reťazec size., Snímková frekvencia je pri tejto vybranej natívnej metóde vyjadrená reťazcom., Dĺžka v sekundách je pri tejto vybranej natívnej metóde vyjadrená reťazcom.

Aliasy metódy: /v1/videos/generations

Životný cyklus: 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}

Cenník

Ako sa vypočíta konečný poplatok

Zobrazené sadzby slúžia na odhad nákladov pred generovaním. Konečný poplatok sa vypočíta z nákladov zaznamenaných pri pôvodnom generovaní. Namerané trvanie výstupu a predpokladané množstvá nepredstavujú konečné účtované množstvo.

Tarifné údaje nepridávajú možnosti požiadavky. Podporované parametre sú uvedené pri vybranej metóde.

Rýchly režim: Neuvedené Keď je zvolený rýchly režim
Režim Flex: Neuvedené Keď je zvolený režim flex
Maximálna úroveň uvažovania: Neuvedené Keď sa pri maximálnej úrovni uvažovania používa predvolená úprava (default)

Odhadované sadzby na porovnanie

Ceny podľa konfigurácie

Každý poplatok priraďte k zobrazeným podmienkam. Pre každú skupinu alternatívnych konfigurácií použite jednu sadzbu.

Konfigurácia	Sadzobník	Odhadované množstvo	Účtovacie množstvo	Poplatok
KonfiguráciaZákladné sadzby za tokeny	SadzobníkZákladná sadzba	Odhadované množstvo—	Účtovacie množstvo—	Poplatok Vstup · Vstupné tokeny · Odhad iba na porovnanie — / 1K tokenov Výstup · Výstupné tokeny · Odhad iba na porovnanie — / 1K tokenov Vstup · Čítanie cache · Odhad iba na porovnanie — / 1K tokenov Vstup · Zápis do cache · Odhad iba na porovnanie — / 1K tokenov Vstup · Zápis do cache, 1 hod · Odhad iba na porovnanie — / 1K tokenov
KonfiguráciaZa požiadavku	Sadzobník—	Odhadované množstvo—	Účtovacie množstvojedna požiadavka	Poplatok Vstup · Odhad iba na porovnanie $0.3 za požiadavku
KonfiguráciaOdhadované náklady na generovanie	Sadzobník—	Odhadované množstvoodhad pre jedno generovanie	Účtovacie množstvo—	Poplatok Výstup · Odhadované náklady na generovanie · Odhad iba na porovnanie $0.3 odhad pred generovaním Tento odhad nepredstavuje dodatočný poplatok ani pevnú sadzbu za dokončené generovanie.

Ailoot pred požiadavkou rezervuje odhadovanú sumu. Po získaní výsledku vyúčtuje konečný poplatok podľa nameraného využitia. Pri streamovaní sa vyúčtovanie riadi konečným záznamom využitia. Ako funguje rezervácia a vyúčtovanie →

Príklady požiadaviek

Ailoot Ultra · Generovanie videa

curl · vytvoriť iba raz a uchovať potvrdeniePrečítať pôvodnú úlohuUložiť každý hotový výstup, ktorý vám patrí

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

Prijať a uložiť výsledky

Ailoot Ultra · Generovanie videa

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}

Uchovať všetky dokončené výsledky

Uložte každé dokončené video alebo vrátený súbor; načítajte obsah každej skutočne vrátenej URL podkladu.

Zachovajte celú odpoveď a hlavičky, pôvodné identifikátory, každý skutočný výstup a všetky polia spotreby a účtovania. Uložte každý jedinečný súbor vo vašom vlastníctve a zachovajte každú rolu, ktorá naň odkazuje.

Ak treba overiť pôvodnú odpoveď

Zachovajte vrátené verejné id úlohy alebo operácie a všetky hlavičky. Načítavajte iba pôvodnú úlohu; unknown ani result_pending_check neoprávňujú na ďalšie vytvorenie.

Polia odpovede

Pole	Typ
Pole`id`	Typstring
Pole`polling_url`	Typstring
Pole`provider_task_id`	Typstring
Pole`id`	Typstring
Pole`task_status`	Typstring
Pole`video_result[].url`	Typstring

Aliasy

Aliasy modelov

Ailoot Ultra cogvideox-3

Aliasy ciest metód

/v1/videos/generations

Súvisiace ID na volanie

cogvideox-3

FAQ · Zhipu AI: CogVideoX 3

Aké vstupy a výsledky sú dostupné?: POST /v1/videos · cogvideox-3: text → video
Aké polia používa požiadavka?: POST /v1/videos · cogvideox-3: model, prompt, quality, with_audio, size, fps, duration

Zhipu AI: CogVideoX 3