Zhipu AI: CogVideoX 2

CogVideoX 2 generuoja vaizdo įrašą pagal tekstinį aprašymą arba pateiktą paveikslėlį. Gamintojas dokumentuoja pasirenkamus kadrų dydžius, 30 arba 60 kadrų per sekundę dažnį, kokybės arba spartos režimus ir pasirenkamus generuojamus garso efektus trumpai vaizdinei scenai sukurti.

Ailoot Ultra · Vaizdo įrašai POST /v1/videos cogvideox-2

Apie modelį

Šis aprašas apima modelio galimybes. Pasirinktam metodui Ailoot prieinamos įvestys, išvestys ir parinktys nurodytos toliau.

CogVideoX 2 yra Zhipu AI vaizdo įrašų generavimo modelis, naudojantis rašytinį scenos aprašymą arba pateiktą paveikslėlį. Tekstas apibrėžia pagrindinį objektą, aplinką ir veiksmą, o paveikslėlis gali suteikti vaizdinį generuojamos sekos pagrindą. Pasirinkite įvestį, geriausiai atitinkančią jau turimą kadro medžiagą, tada aprašykite užbaigtame vaizdo įraše matomą judėjimą.

Kurdami pagal tekstą apibrėžkite vieną nuoseklų įvykį. Žmogus, atidarantis dirbtuvių duris, pro prieplauką plaukianti nedidelė valtis ar tolygiai apšviestas besisukantis daiktas suteikia kadrui aiškią paskirtį. Nurodykite svarbias objekto savybes, žiūros tašką ir judėjimo kryptį. Pasirinkite numatytam montažui tinkamą pabaigą, užuot palikę galutinę scenos kompoziciją neapibrėžtą.

Kurdami pagal paveikslėlį paruoškite aiškų objekto vaizdą ir aprašykite, kaip iš jo turėtų vystytis scenos judėjimas. Gamintojas priima iki 5 MB dydžio PNG, JPEG ir JPG pavyzdinius vaizdus, pateikiamus paveikslėlio URL arba užkoduotais jo duomenimis. Išsaugokite matomus svarbius kontūrus, veido bruožus ir objekto detales, o kompozicijoje palikite vietos prašomam veiksmui.

Gamintojas apriboja rašytinį promptą iki 512 simbolių. Šią vietą skirkite lemiamoms detalėms: objektui, veiksmui, aplinkai ir žiūros taškui. Trumpą aprašymą, paaiškinantį, kuris objektas juda ir kas lieka vietoje, lengviau įvertinti nei plačių stiliaus būdvardžių sąrašą. Jei rezultatas neatitinka tikslo, pataisykite instrukciją, susijusią su pastebėta judėjimo ar kadravimo problema.

Paskelbti išvesties dydžiai apima kvadratinius, horizontalius ir vertikalius formatus, su pasirinkimais nuo 720×480 iki 3840×2160 pikselių. Gamintojas taip pat dokumentuoja 30 arba 60 kadrų per sekundę. Prieš generavimą parinkite paskirties vietai tinkamą formą ir kadrų dažnį, tada patikrinkite tikrą įrašą: ar tokiame kadre objektas ir svarbios jo detalės išlieka aiškiai matomi.

Kokybė ir sparta yra įvardyti išvesties režimai gamintojo darbo eigoje. Pasirenkami DI generuojami garso efektai valdomi atskirai nuo vaizdinės užduoties aprašymo. Pasirinktą režimą ir garso efektų parametrą išsaugokite kartu su promptu bei bet kuriuo naudojamu paveikslėliu, kad skirtingus vaizdo įrašų variantus būtų galima palyginti pagal tikrus generavimo parametrus.

Generavimas yra asinchroninis: užduoties identifikatorius grąžinamas dar prieš gaunant užbaigtą vaizdo įrašą. Išsaugokite jį tikrindami rezultatą ir visus su operacija susijusius užbaigtus vaizdo failus. Montažui išsaugokite patį įrašą ir, jei naudotas, pradinį paveikslėlį, užuot pasikliovę laikina rezultato vieta ar peržiūros kadru.

Peržiūrėkite visos sekos nuoseklumą, laiką ir prašytą veiksmą. Produkto kadre judant turi išlikti pastovi forma ir medžiagos detalės, o veikėjo kadre — nuosekli išvaizda bei gestai. Galutinę kompoziciją ir sugeneruotą garsą palyginkite su kadro paskirtimi. Taisydami konkretų neatitikimą išsaugokite pavykusius scenos elementus ir originalų bei pataisytą vaizdo įrašus lyginkite tokiomis pačiomis peržiūros sąlygomis.

Ailoot Ultra · Vaizdo įrašai POST /v1/videos cogvideox-2

cogvideox-2

Zhipu AI /cogvideox-2

Pradžia

Leidžiamos įvestys: Tekstas
Rezultatai: Vaizdo įrašai

Prieinama Ailoot · įvestys ir metodai

Ailoot Ultra · Vaizdo įrašai POST /v1/videos

Įvestis: text
Išvestis: video

Laukas	Tipas	Reikalavimas	Reikšmės ir ribos	Numatyta
Laukas`model`	Tipas`string`	ReikalavimasPrivaloma	Reikšmės ir ribos cogvideox-2 Sąlygos: Naudokite tikslų Ailoot modelio parinkiklį.	Numatyta—
Laukas`prompt`	Tipas`string`	ReikalavimasPrivaloma	Reikšmės ir ribos Sąlygos: Aprašykite sceną ir judesį.	Numatyta—
Laukas`quality`	Tipas`boolean`	ReikalavimasNeprivaloma	Reikšmės ir ribos Sąlygos: Neprivaloma kokybės vėliavėlė; pasirinktoje schemoje nepateikta suderinamo išvardijimo tipo ar numatytosios reikšmės.	Numatyta—
Laukas`with_audio`	Tipas`boolean`	ReikalavimasNeprivaloma	Reikšmės ir ribos Sąlygos: Kai įjungta, generuojami DI garso efektai.	Numatytafalse
Laukas`size`	Tipas`string`	ReikalavimasNeprivaloma	Reikšmės ir ribos Sąlygos: Rinkdamiesi tikslius matmenis pateikite dokumentacijoje nurodytą size eilutę.	Numatyta—
Laukas`fps`	Tipas`string`	ReikalavimasNeprivaloma	Reikšmės ir ribos 30, 60 Sąlygos: Šiame pasirinktame pirminiame metode kadrų dažnis pateikiamas kaip eilutė.	Numatyta30
Laukas`duration`	Tipas`string`	ReikalavimasNeprivaloma	Reikšmės ir ribos 5, 10 Sąlygos: Šiame pasirinktame pirminiame metode trukmė sekundėmis pateikiama kaip eilutė.	Numatyta5

Metodo parametrai ir gyvavimo ciklas

Parametras	Specifikacija
Parametras`content_type`	Specifikacijaapplication/json
Parametras`required`	Specifikacijamodel, prompt
Parametras`optional`	Specifikacijaquality, with_audio, size, fps, duration
Parametras`material_types`	Specifikacijatext
Parametras`conditions`	SpecifikacijaNaudokite tikslų Ailoot modelio parinkiklį., Aprašykite sceną ir judesį., Neprivaloma kokybės vėliavėlė; pasirinktoje schemoje nepateikta suderinamo išvardijimo tipo ar numatytosios reikšmės., Kai įjungta, generuojami DI garso efektai., Rinkdamiesi tikslius matmenis pateikite dokumentacijoje nurodytą size eilutę., Šiame pasirinktame pirminiame metode kadrų dažnis pateikiamas kaip eilutė., Šiame pasirinktame pirminiame metode trukmė sekundėmis pateikiama kaip eilutė.

Metodo pseudonimai: /v1/videos/generations

Gyvavimo ciklas: 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}

Planai

Kaip apskaičiuojamas galutinis mokestis

Rodomi įkainiai leidžia įvertinti kainą prieš generavimą. Galutinė suma apskaičiuojama pagal užfiksuotą pradinio generavimo kainą. Išmatuota rezultato trukmė ir prognozuoti kiekiai nėra galutinis apmokestinamas kiekis.

Tarifų informacija neprideda užklausos parinkčių. Palaikomi parametrai nurodyti prie pasirinkto metodo.

Spartusis režimas: Nenurodyta Pasirinkus spartųjį režimą
Flex režimas: Nenurodyta Pasirinkus flex režimą
Didžiausios samprotavimo pastangos: Nenurodyta Kai didžiausioms samprotavimo pastangoms taikomas numatytasis koregavimas (default)

Numatomi įkainiai palyginimui

Kainos pagal konfigūraciją

Kiekvieną mokestį susiekite su nurodytomis sąlygomis. Kiekvienam alternatyvių konfigūracijų rinkiniui taikykite vieną įkainį.

Konfigūracija	Įkainių lentelė	Numatomas kiekis	Apskaitos kiekis	Mokestis
KonfigūracijaBaziniai žetonų įkainiai	Įkainių lentelėBazinis įkainis	Numatomas kiekis—	Apskaitos kiekis—	Mokestis Įvestis · Įvesties tokenai · Įvertis tik palyginimui — / 1K tokenų Išvestis · Išvesties tokenai · Įvertis tik palyginimui — / 1K tokenų Įvestis · Talpyklos skaitymas · Įvertis tik palyginimui — / 1K tokenų Įvestis · Rašymas į talpyklą · Įvertis tik palyginimui — / 1K tokenų Įvestis · Rašymas į talpyklą, 1 val · Įvertis tik palyginimui — / 1K tokenų
KonfigūracijaUž užklausą	Įkainių lentelė—	Numatomas kiekis—	Apskaitos kiekisviena užklausa	Mokestis Įvestis · Įvertis tik palyginimui $0.2 už užklausą
KonfigūracijaNumatoma generavimo kaina	Įkainių lentelė—	Numatomas kiekisvieno generavimo įvertis	Apskaitos kiekis—	Mokestis Išvestis · Numatoma generavimo kaina · Įvertis tik palyginimui $0.2 įvertis prieš generavimą Šis įvertis nėra papildomas mokestis ar fiksuotas užbaigto generavimo įkainis.

Ailoot prieš užklausą rezervuoja numatomą sumą. Gavus rezultatą, galutinis mokestis nuskaitomas pagal išmatuotą naudojimą. Srautinio atsakymo atsiskaitymui naudojamas galutinis naudojimo įrašas. Kaip veikia rezervavimas ir atsiskaitymas →

Užklausų pavyzdžiai

Ailoot Ultra · Vaizdo įrašai

curl · sukurkite vieną kartą ir išsaugokite gavimo patvirtinimąPeržiūrėkite pirminę užduotįIšsaugokite kiekvieną užbaigtą jums priklausantį išteklių

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

Gauti ir išsaugoti rezultatus

Ailoot Ultra · Vaizdo įrašai

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}

Išsaugoti visus baigtus rezultatus

Išsaugokite kiekvieną baigtą vaizdo įrašą arba grąžintą failą; gaukite turinį iš kiekvieno faktiškai grąžinto medžiagos URL.

Išsaugokite visą atsakymą ir antraštes, pradinius identifikatorius, kiekvieną tikrą rezultatą ir visus naudojimo bei apskaitos laukus. Išsaugokite kiekvieną unikalų jums priklausantį išteklių ir visas į jį nukreiptas paskirtis.

Jei reikia patikrinti pradinį atsakymą

Išsaugokite grąžintą viešą užduoties ar operacijos id ir visas antraštes. Skaitykite tik pradinės užduoties duomenis; unknown arba result_pending_check nesuteikia leidimo kurti dar kartą.

Atsakymo laukai

Laukas	Tipas
Laukas`id`	Tipasstring
Laukas`polling_url`	Tipasstring
Laukas`provider_task_id`	Tipasstring
Laukas`id`	Tipasstring
Laukas`task_status`	Tipasstring
Laukas`video_result[].url`	Tipasstring

Pseudonimai

Modelių pseudonimai

Ailoot Ultra cogvideox-2

Metodų kelių pseudonimai

/v1/videos/generations

Susiję ID iškvietimui

cogvideox-2

FAQ · Zhipu AI: CogVideoX 2

Kokios įvestys ir rezultatai prieinami?: POST /v1/videos · cogvideox-2: text → video
Kokius laukus naudoja užklausa?: POST /v1/videos · cogvideox-2: model, prompt, quality, with_audio, size, fps, duration

Zhipu AI: CogVideoX 2