Zhipu AI: CogVideoX 2

CogVideoX 2 tuottaa videon tekstikuvauksesta tai annetusta kuvasta. Valmistaja dokumentoi valittavat kuvakoot, 30 tai 60 fps:n kuvataajuuden, laatu- tai nopeustilan ja valinnaiset generoidut äänitehosteet lyhyen visuaalisen kohtauksen muokkaamiseen.

Ailoot Ultra · Videot POST /v1/videos cogvideox-2

Tietoa mallista

Tämä kuvaus kattaa mallin ominaisuudet. Ailootissa saatavilla olevat syötteet, tulosteet ja asetukset luetellaan alla valitulle menetelmälle.

CogVideoX 2 on Zhipu AI:n videogenerointimalli kirjallista kohtauskuvausta tai annettua kuvaa varten. Teksti määrittää kohteen, ympäristön ja toiminnan; kuva voi tarjota visuaalisen perustan tuotettavalle jaksolle. Käytä syötettä, joka parhaiten edustaa otosta varten jo saatavilla olevaa aineistoa, ja kuvaa sitten näkyvä liike, jonka valmiin videon tulee sisältää.

Määritä tekstiohjatulle luomiselle yksi yhtenäinen tapahtuma. Työpajan oven avaava henkilö, laiturin ohi liikkuva pieni vene tai tasaisessa valossa kääntyvä esine antaa kukin otokselle ymmärrettävän tarkoituksen. Määritä kohteen tärkeät piirteet, näkökulma ja liikkeen suunta. Valitse aiottuun editointiin sopiva lopetus sen sijaan, että jättäisit kohtauksen lopullisen sommittelun määrittämättä.

Valmistele kuvapohjaista luomista varten selkeä näkymä kohteesta ja kuvaa, miten kohtauksen tulee liikkua siitä lähtien. Valmistaja hyväksyy enintään 5 MB:n PNG-, JPEG- ja JPG-referenssejä kuvan URL-osoitteena tai koodattuna kuvadatana. Pidä tärkeät reunat, kasvonpiirteet ja esineiden yksityiskohdat näkyvissä referenssissä ja jätä sommitteluun tilaa pyydetylle toiminnalle.

Valmistaja rajoittaa kirjallisen kehotteen 512 merkkiin. Käytä tila ratkaiseviin yksityiskohtiin: kohteeseen, toimintaan, ympäristöön ja näkökulmaan. Lyhyt kuvaus, joka selittää, mikä esine liikkuu ja mikä pysyy paikallaan, on helpompi arvioida kuin luettelo yleisistä tyyliadjektiiveista. Jos tulos ei vastaa tavoitetta, muokkaa ohjetta, joka liittyy havaittuun liike- tai rajausongelmaan.

Julkaistut tuloskoot sisältävät neliö-, vaaka- ja pystymuotoja, ja vaihtoehdot ulottuvat 720×480 pikselistä 3840×2160 pikseliin. Valmistaja dokumentoi myös 30 tai 60 kuvaa sekunnissa. Valitse muoto ja kuvataajuus käyttökohteen mukaan ennen generointia ja tarkista sitten varsinaisesta videoleikkeestä, pysyvätkö kohde ja sen tärkeät yksityiskohdat luettavina tässä rajauksessa.

Laatu ja nopeus ovat valmistajan työnkulun nimettyjä tulostiloja. Valinnaisia tekoälyn tuottamia äänitehosteita ohjataan erillään visuaalisesta kuvauksesta. Säilytä valittu tila ja äänitehosteasetus yhdessä kehotteen ja mahdollisen referenssikuvan kanssa, jotta eri leike-ehdokkaita voidaan vertailla niiden todellisten generointiasetusten perusteella.

Generointi on asynkronista: tehtävän tunniste palautetaan ennen valmiin videon saatavuutta. Säilytä tunniste tuloksen tarkistamisen ajan ja kaikki toimintoon liittyvät valmistuneet videotiedostot. Tallenna itse leike editointia varten sekä lähdekuva, kun sitä käytetään, sen sijaan että riippuisit väliaikaisesta tulossijainnista tai esikatselukuvasta.

Tarkista koko jakson jatkuvuus, ajoitus ja pyydetty toiminta. Tuoteotos tarvitsee vakaan muodon ja materiaalin yksityiskohdat liikkeen aikana; hahmo-otos tarvitsee yhtenäisen ulkoasun ja eleet. Tarkista lopullinen sommittelu ja mahdollinen generoitu ääni otoksen tarkoitusta vasten. Säilytä onnistuneet kohtauselementit, kun korjaat konkreettista poikkeamaa, ja vertaa alkuperäistä ja korjattua videota samoissa katseluolosuhteissa.

Ailoot Ultra · Videot POST /v1/videos cogvideox-2

cogvideox-2

Zhipu AI /cogvideox-2

Aloitus

Hyväksytyt syötteet: Teksti
Tulokset: Video

Saatavilla Ailootissa · syötteet & menetelmät

Ailoot Ultra · Videot POST /v1/videos

Syötetyypit: text
Tulostyypit: video

Kenttä	Tyyppi	Vaatimus	Arvot & rajat	Oletus
Kenttä`model`	Tyyppi`string`	VaatimusPakollinen	Arvot & rajat cogvideox-2 Ehdot: Käytä täsmällistä Ailoot-mallin valitsinta.	Oletus—
Kenttä`prompt`	Tyyppi`string`	VaatimusPakollinen	Arvot & rajat Ehdot: Kuvaile kohtaus ja liike.	Oletus—
Kenttä`quality`	Tyyppi`boolean`	VaatimusValinnainen	Arvot & rajat Ehdot: Valinnainen laatulippu; tämä valittu skeema ei määritä yhteensopivaa enum-arvojoukkoa tai oletusarvoa.	Oletus—
Kenttä`with_audio`	Tyyppi`boolean`	VaatimusValinnainen	Arvot & rajat Ehdot: Luo tekoälyllä äänitehosteita, kun asetus on käytössä.	Oletusfalse
Kenttä`size`	Tyyppi`string`	VaatimusValinnainen	Arvot & rajat Ehdot: Anna dokumentoitu kokomerkkijono valitessasi täsmälliset mitat.	Oletus—
Kenttä`fps`	Tyyppi`string`	VaatimusValinnainen	Arvot & rajat 30, 60 Ehdot: Kuvataajuus esitetään merkkijonona tässä valitussa natiivimenetelmässä.	Oletus30
Kenttä`duration`	Tyyppi`string`	VaatimusValinnainen	Arvot & rajat 5, 10 Ehdot: Kesto sekunteina esitetään merkkijonona tässä valitussa natiivimenetelmässä.	Oletus5

Menetelmän parametrit ja elinkaari

Parametri	Sopimus
Parametri`content_type`	Sopimusapplication/json
Parametri`required`	Sopimusmodel, prompt
Parametri`optional`	Sopimusquality, with_audio, size, fps, duration
Parametri`material_types`	Sopimustext
Parametri`conditions`	SopimusKäytä täsmällistä Ailoot-mallin valitsinta., Kuvaile kohtaus ja liike., Valinnainen laatulippu; tämä valittu skeema ei määritä yhteensopivaa enum-arvojoukkoa tai oletusarvoa., Luo tekoälyllä äänitehosteita, kun asetus on käytössä., Anna dokumentoitu kokomerkkijono valitessasi täsmälliset mitat., Kuvataajuus esitetään merkkijonona tässä valitussa natiivimenetelmässä., Kesto sekunteina esitetään merkkijonona tässä valitussa natiivimenetelmässä.

Menetelmien aliakset: /v1/videos/generations

Elinkaari: 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}

Hinnoittelu

Lopullisen veloituksen laskenta

Näytettyjen hintojen avulla arvioidaan kustannukset ennen generointia. Lopullinen veloitus lasketaan alkuperäiselle generoinnille kirjatun kustannuksen perusteella. Lopullisena laskutettavana määränä ei käytetä tulosteen mitattua kestoa eikä ennustettuja määriä.

Hintatiedot eivät lisää pyyntövalintoja. Tuetut parametrit on lueteltu valitulle menetelmälle.

Nopea tila: Ei määritetty Kun nopea tila on valittu
Flex-tila: Ei määritetty Kun flex-tila on valittu
Päättelyn enimmäisteho: Ei määritetty Kun päättelyn enimmäistehoon sovelletaan default-oletussäätöä

Arvioidut vertailuhinnat

Hinnat asetusten mukaan

Kohdista kukin veloitus näytettyihin ehtoihin. Käytä yhtä hintaa kutakin vaihtoehtoisten asetusten ryhmää kohden.

Asetukset	Hinnasto	Ennustettu määrä	Laskutusmäärä	Veloitus
AsetuksetTokenien perushinnat	HinnastoPerushinta	Ennustettu määrä—	Laskutusmäärä—	Veloitus Syöte · Syötetokenit · Arvio vain vertailua varten — / 1K tokenia Tuloste · Tulostokenit · Arvio vain vertailua varten — / 1K tokenia Syöte · Välimuistin luku · Arvio vain vertailua varten — / 1K tokenia Syöte · Välimuistiin kirjoitus · Arvio vain vertailua varten — / 1K tokenia Syöte · Välimuistiin kirjoitus, 1 tunti · Arvio vain vertailua varten — / 1K tokenia
AsetuksetPyyntöä kohden	Hinnasto—	Ennustettu määrä—	Laskutusmääräyksi pyyntö	Veloitus Syöte · Arvio vain vertailua varten $0.2 pyyntöä kohden
AsetuksetArvioitu luontikustannus	Hinnasto—	Ennustettu määräyhden generoinnin arvio	Laskutusmäärä—	Veloitus Tuloste · Arvioidut generointikustannukset · Arvio vain vertailua varten $0.2 arvio ennen generointia Tämä arvio ei ole lisämaksu eikä valmistuneen generoinnin kiinteä hinta.

Ailoot varaa arvioidun summan ennen pyyntöä. Tuloksen jälkeen lopullinen veloitus toteutetaan mitatun käytön perusteella. Suoratoiston veloituksessa käytetään lopullista käyttötietuetta. Varauksen ja lopullisen veloituksen toiminta →

Esimerkkipyynnöt

Ailoot Ultra · Videot

curl · luo vain kerran ja säilytä kuittiLue alkuperäinen tehtäväTallenna kaikki valmistuneet omat tuotokset

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

Vastaanota ja tallenna tulokset

Ailoot Ultra · Videot

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}

Säilytä kaikki valmistuneet tulokset

Tallenna jokainen valmistunut video tai palautettu tiedosto; nouda jokainen todellinen palautettu aineiston URL.

Säilytä koko vastaus ja otsakkeet, alkuperäiset tunnisteet, jokainen todellinen tulos sekä kaikki käyttö- ja veloitustietokentät. Tallenna jokainen yksilöllinen käyttäjälle kuuluva aineisto ja säilytä kaikki siihen viittaavat roolit.

Jos alkuperäinen vastaus on tarkistettava

Säilytä palautettu julkinen tehtävän tai operaation id ja kaikki otsakkeet. Lue vain alkuperäisen tehtävän tietoja; unknown tai result_pending_check ei oikeuta uuteen luontipyyntöön.

Vastauksen kentät

Kenttä	Tyyppi
Kenttä`id`	Tyyppistring
Kenttä`polling_url`	Tyyppistring
Kenttä`provider_task_id`	Tyyppistring
Kenttä`id`	Tyyppistring
Kenttä`task_status`	Tyyppistring
Kenttä`video_result[].url`	Tyyppistring

Aliakset

Mallin aliakset

Ailoot Ultra cogvideox-2

Menetelmäpolkujen aliakset

/v1/videos/generations

Liittyvät kutsujan ID:t

cogvideox-2

FAQ · Zhipu AI: CogVideoX 2

Mitä syötteitä ja tuloksia on saatavilla?: POST /v1/videos · cogvideox-2: text → video
Mitä kenttiä pyyntö käyttää?: POST /v1/videos · cogvideox-2: model, prompt, quality, with_audio, size, fps, duration

Zhipu AI: CogVideoX 2