Zhipu AI: CogVideoX 3

CogVideoX 3 v proizvajalčevem dokumentiranem postopku ustvarja video iz besedila, slike ali para prve in zadnje sličice. Podpira pet- ali desetsekundna zaporedja, več izhodnih velikosti do 4K, 30 ali 60 fps in izbirne ustvarjene zvočne učinke.

Ailoot Ultra · Videoposnetki POST /v1/videos cogvideox-3

O modelu

Ta opis zajema zmožnosti modela. Vhodi, izhodi in možnosti, ki so na voljo v Ailoot, so spodaj navedeni za izbrano metodo.

CogVideoX 3 je videomodel Zhipu AI z dokumentiranim ustvarjanjem iz besedila, slike ter prve in zadnje sličice. Proizvajalec poudarja stabilnost sličic, upoštevanje navodil ter realistične ali tridimenzionalne vizualne sloge. Izberite besedilo, kadar se prizor začne s pisnim opisom; eno sliko, kadar vizualna osnova že obstaja; ali dve sliki skrajnih sličic, kadar zaporedje potrebuje določen začetni in končni pogled.

V besedilnem opisu navedite subjekt in eno jasno dejanje. Opišite okolje, zorni kot in pomembna fizična razmerja, da lahko prizor ocenite glede na jasen namen. Lik, ki pobira predmet, potrebuje drugačno zaporedje kot kamera, ki ta predmet razkriva. Oboje opišite le, kadar je njuno razmerje pomembno za posnetek.

Pri zaporedju na podlagi slike pripravite referenco tako, da so vidne prepoznavne značilnosti subjekta. Proizvajalec sprejema slike PNG, JPEG in JPG, velike največ 5 MB, posredovane prek URL-ja ali kodiranih slikovnih podatkov. Dejansko referenco shranite z ustvarjenim rezultatom, da videz in kadriranje primerjate z virom, ne z njegovo podobo po spominu.

Proizvajalčev način skrajnih sličic sprejema dve sliki po vrsti: prva določi začetno sličico, druga pa končno. Pripravite ju kot dve predvideni stanji enega posnetka. Opišite prehod ali dejanje, ki ju povezuje, nato preverite, ali subjekt ostane skladen med skrajnima sličicama. Par dobrih statičnih slik sam po sebi ne pokaže, da gibanje med njima ustreza želeni zgodbi.

Poziv lahko vsebuje največ 512 znakov. Razpoložljivo besedilo namenite dejanju, njegovi smeri in vizualnim podrobnostim, ki opredeljujejo uspešen rezultat. Opis osredotočite na dogajanje na zaslonu. Kadar vhodni sliki že določata videz subjekta, opišite gibanje in časovni potek, ki naj se razvijeta med slikama ali iz njiju.

Proizvajalec dokumentira pet- ali desetsekundni izhod, pri čemer je privzeto trajanje pet sekund, ter 30 ali 60 sličic na sekundo. Podprte velikosti vključujejo 1280×720, 720×1280, 1024×1024, 1920×1080, 1080×1920, 2048×1080 in 3840×2160. Velikost in časovni potek izberite za predvideno uporabo, nato v dokončanem posnetku preverite kadriranje in tempo dejanskega dogajanja.

Načina kakovosti in hitrosti sta dokumentirana ločeno od izbirne nastavitve zvočnih učinkov UI. Te izbire shranite s pozivom, slikama in rezultatom. Proizvajalčeve vizualne in vhodne zmogljivosti opisujejo model; razpoložljive nastavitve posamezne metode ustvarjanja določa specifikacija te metode. Pri primerjanju različic posnetkov ohranite dejansko uporabljene nastavitve.

Izvorni identifikator opravila ohranite do dokončanja videa in vrnjeno gradivo shranite za montažo. Preglejte celotno zaporedje, vključno z videzom subjekta pri velikem gibanju, interakcijami s predmeti v prizoru in končno kompozicijo. Pri delu s skrajnima sličicama preglejte obe skrajni sličici in prehod med njima. Popravite konkretno vizualno neskladje, pri tem ohranite uspešne reference in načrt posnetka ter primerjajte dokončane videe, ne le njihovih predogledov.

Ailoot Ultra · Videoposnetki POST /v1/videos cogvideox-3

cogvideox-3

Zhipu AI /cogvideox-3

Začetek

Dovoljeni vhodi: Besedilo
Rezultati: Video

Na voljo v Ailoot · vhodi in metode

Ailoot Ultra · Videoposnetki POST /v1/videos

Vhod: text
Izhod: video

Polje	Vrsta	Zahteva	Vrednosti in omejitve	Privzeto
Polje`model`	Vrsta`string`	ZahtevaObvezno	Vrednosti in omejitve cogvideox-3 Pogoji: Uporabite natančen izbirnik modela Ailoot.	Privzeto—
Polje`prompt`	Vrsta`string`	ZahtevaObvezno	Vrednosti in omejitve Pogoji: Opišite prizor in gibanje.	Privzeto—
Polje`quality`	Vrsta`boolean`	ZahtevaIzbirno	Vrednosti in omejitve Pogoji: Neobvezna oznaka kakovosti; ta izbrana shema ne določa združljivega enum ali privzete vrednosti.	Privzeto—
Polje`with_audio`	Vrsta`boolean`	ZahtevaIzbirno	Vrednosti in omejitve Pogoji: Ko je omogočeno, ustvarite zvočne učinke AI.	Privzetofalse
Polje`size`	Vrsta`string`	ZahtevaIzbirno	Vrednosti in omejitve Pogoji: Pri izbiri izrecnih mer podajte dokumentirani niz size.	Privzeto—
Polje`fps`	Vrsta`string`	ZahtevaIzbirno	Vrednosti in omejitve 30, 60 Pogoji: Hitrost sličic je pri tej izbrani izvorni metodi predstavljena kot niz.	Privzeto30
Polje`duration`	Vrsta`string`	ZahtevaIzbirno	Vrednosti in omejitve 5, 10 Pogoji: Trajanje v sekundah je pri tej izbrani izvorni metodi predstavljeno kot niz.	Privzeto5

Parametri in življenjski cikel metode

Parameter	Specifikacija
Parameter`content_type`	Specifikacijaapplication/json
Parameter`required`	Specifikacijamodel, prompt
Parameter`optional`	Specifikacijaquality, with_audio, size, fps, duration
Parameter`material_types`	Specifikacijatext
Parameter`conditions`	SpecifikacijaUporabite natančen izbirnik modela Ailoot., Opišite prizor in gibanje., Neobvezna oznaka kakovosti; ta izbrana shema ne določa združljivega enum ali privzete vrednosti., Ko je omogočeno, ustvarite zvočne učinke AI., Pri izbiri izrecnih mer podajte dokumentirani niz size., Hitrost sličic je pri tej izbrani izvorni metodi predstavljena kot niz., Trajanje v sekundah je pri tej izbrani izvorni metodi predstavljeno kot niz.

Druga imena metode: /v1/videos/generations

Življenjski cikel: 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}

Cenik

Kako se izračuna končni strošek

Prikazane cene so namenjene oceni stroškov pred generiranjem. Končni znesek se izračuna na podlagi stroška, zabeleženega za izvirno generiranje. Izmerjeno trajanje izhoda in napovedane količine niso končna obračunska količina.

Tarifni podatki ne dodajajo možnosti zahteve. Podprti parametri so navedeni pri izbrani metodi.

Hitri način: Ni navedeno Ko je izbran hitri način
Način flex: Ni navedeno Ko je izbran način flex
Najvišja raven razmišljanja: Ni navedeno Ko najvišja raven razmišljanja uporablja privzeto prilagoditev (default)

Ocenjene cene za primerjavo

Cene po nastavitvah

Vsak strošek povežite s prikazanimi pogoji. Za vsak nabor alternativnih nastavitev uporabite eno ceno.

Nastavitev	Cenovna lestvica	Predvidena količina	Obračunska količina	Strošek
NastavitevOsnovne cene žetonov	Cenovna lestvicaOsnovna cena	Predvidena količina—	Obračunska količina—	Strošek Vhod · Vhodni žetoni · Ocena samo za primerjavo — / 1K žetonov Izhod · Izhodni žetoni · Ocena samo za primerjavo — / 1K žetonov Vhod · Branje predpomnilnika · Ocena samo za primerjavo — / 1K žetonov Vhod · Zapis v predpomnilnik · Ocena samo za primerjavo — / 1K žetonov Vhod · Zapis v predpomnilnik, 1 ura · Ocena samo za primerjavo — / 1K žetonov
NastavitevNa zahtevo	Cenovna lestvica—	Predvidena količina—	Obračunska količinaena zahteva	Strošek Vhod · Ocena samo za primerjavo $0.3 na zahtevo
NastavitevOcenjeni strošek ustvarjanja	Cenovna lestvica—	Predvidena količinaocena za eno generiranje	Obračunska količina—	Strošek Izhod · Ocenjeni stroški ustvarjanja · Ocena samo za primerjavo $0.3 ocena pred ustvarjanjem Ta ocena ni dodatno plačilo ali fiksna cena za dokončano generiranje.

Ailoot pred zahtevo rezervira ocenjeni znesek. Po rezultatu obračuna končni strošek na podlagi izmerjene porabe. Obračun pretakanja uporablja končni zapis porabe. Kako delujeta rezervacija in obračun →

Primeri zahtev

Ailoot Ultra · Videoposnetki

curl · ustvarite enkrat in ohranite potrdiloPreberite izvirno opraviloShranite vsako dokončano datoteko v svoji lasti

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

Prejmi in shrani rezultate

Ailoot Ultra · Videoposnetki

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}

Ohrani vse dokončane rezultate

Shranite vsak dokončan video ali vrnjeno datoteko; pridobite vsebino z vsake dejansko vrnjene URL gradiva.

Ohranite celoten odgovor in glave, prvotne identifikatorje, vsak dejanski izhod in vsa polja porabe/obračuna. Shranite vsako enolično sredstvo v vaši lasti in ohranite vsako vlogo, ki kaže nanj.

Če je treba preveriti izvirni odgovor

Ohranite vrnjeni javni id opravila ali operacije in vse glave. Berite samo prvotno opravilo; unknown ali result_pending_check ne dovoljujeta novega ustvarjanja.

Polja odgovora

Polje	Vrsta
Polje`id`	Vrstastring
Polje`polling_url`	Vrstastring
Polje`provider_task_id`	Vrstastring
Polje`id`	Vrstastring
Polje`task_status`	Vrstastring
Polje`video_result[].url`	Vrstastring

Druga imena

Druga imena modelov

Ailoot Ultra cogvideox-3

Druga imena poti metod

/v1/videos/generations

Povezani ID-ji za klic

cogvideox-3

FAQ · Zhipu AI: CogVideoX 3

Kateri vhodi in rezultati so na voljo?: POST /v1/videos · cogvideox-3: text → video
Katera polja uporablja zahteva?: POST /v1/videos · cogvideox-3: model, prompt, quality, with_audio, size, fps, duration

Zhipu AI: CogVideoX 3