Zhipu AI: CogVideoX 3

CogVideoX 3 gamintojo dokumentuotoje darbo eigoje kuria vaizdo įrašą pagal tekstą, paveikslėlį arba pirmo ir paskutinio kadrų porą. Jis palaiko penkių arba dešimties sekundžių sekas, kelis išvesties dydžius iki 4K, 30 arba 60 kadrų per sekundę ir pasirenkamus generuojamus garso efektus.

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

Apie modelį

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

CogVideoX 3 yra Zhipu AI vaizdo įrašų modelis su dokumentuotais kūrimo pagal tekstą, pagal paveikslėlį ir pagal pirmą bei paskutinį kadrus būdais. Gamintojas išskiria kadrų stabilumą, instrukcijų laikymąsi ir tikroviškus arba trimačius vaizdinius stilius. Tekstą rinkitės, kai scena prasideda nuo rašytinio aprašo, vieną paveikslėlį — kai vaizdinis pagrindas jau paruoštas, o du galinius vaizdus — kai sekai reikia apibrėžto pradžios ir pabaigos vaizdo.

Tekstinėje užduotyje aprašykite pagrindinį objektą ir vieną aiškų veiksmą. Nurodykite aplinką, žiūros tašką ir svarbius fizinius ryšius, kad sceną būtų galima įvertinti pagal aiškų sumanymą. Veikėjas, pakeliantis daiktą, reikalauja kitokios sekos nei kamera, atskleidžianti tą daiktą. Abu aprašykite tik tada, kai jų ryšys svarbus kadrui.

Paveikslėliu grindžiamai sekai paruoškite nuorodą, kurioje matomos išskirtinės objekto savybės. Gamintojas priima ne didesnius kaip 5 MB PNG, JPEG ir JPG paveikslėlius, pateikiamus URL arba užkoduotais jų duomenimis. Tikrą pradinį vaizdą išsaugokite kartu su sugeneruotu rezultatu, kad išvaizdą ir kadravimą būtų galima palyginti su šaltiniu, o ne su prisiminimu apie jį.

Gamintojo pradžios ir pabaigos kadrų režimas priima du paveikslėlius iš eilės: pirmas nustato pradinį kadrą, antras — paskutinį. Paruoškite juos kaip dvi numatytas vieno kadro sekos būsenas. Aprašykite jas jungiantį perėjimą ar veiksmą, tada patikrinkite, ar objektas tarp galinių būsenų išlieka nuoseklus. Vien du geri nejudantys vaizdai nepatvirtina, kad tarpinis judėjimas tinka norimai istorijai.

Prompte gali būti iki 512 simbolių. Turimą tekstą skirkite veiksmui, jo krypčiai ir vaizdinėms detalėms, kurios skiria pavykusį rezultatą. Aprašyme susitelkite į tai, kas turi vykti ekrane. Jei įvesties paveikslėliai jau apibrėžia objekto išvaizdą, aprašykite judėjimą ir laiką, kurie turi vystytis tarp jų arba iš jų.

Gamintojas dokumentuoja penkių arba dešimties sekundžių išvestį, numatytą penkių sekundžių trukmę ir 30 arba 60 kadrų per sekundę dažnį. Palaikomi dydžiai: 1280×720, 720×1280, 1024×1024, 1920×1080, 1080×1920, 2048×1080 ir 3840×2160. Paskirties vietai parinkite dydį ir laiką, tada patikrinkite užbaigto įrašo kadravimą bei tikro veiksmo tempą.

Kokybės ir spartos režimai dokumentuojami atskirai nuo pasirenkamo DI garso efektų parametro. Šiuos pasirinkimus išsaugokite kartu su promptu, paveikslėliais ir rezultatu. Gamintojo vaizdinės ir įvesties galimybės aprašo modelį, o konkretaus generavimo metodo prieinamus valdiklius pateikia to metodo sutartis. Lygindami kadrų variantus išsaugokite iš tikrųjų naudotus parametrus.

Išsaugokite pradinį užduoties identifikatorių, kol vaizdo įrašas bus užbaigtas, ir grąžintą medžiagą išsaugokite montažui. Patikrinkite visą seką, įskaitant objekto išvaizdą plačių judesių metu, sąveiką su scenos daiktais ir galutinę kompoziciją. Dirbdami su pradžios bei pabaigos kadrais patikrinkite abu galinius vaizdus ir perėjimą tarp jų. Taisykite konkretų vaizdinį neatitikimą, išsaugodami pavykusias nuorodas ir kadro planą, o lygindami vertinkite užbaigtus vaizdo įrašus, ne vien jų peržiūros paveikslėlius.

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

cogvideox-3

Zhipu AI /cogvideox-3

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-3 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.3 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.3 į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-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

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-3

Metodų kelių pseudonimai

/v1/videos/generations

Susiję ID iškvietimui

cogvideox-3

FAQ · Zhipu AI: CogVideoX 3

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

Zhipu AI: CogVideoX 3