Zhipu AI: CogVideoX 3

CogVideoX 3 luo videon tekstistä, kuvasta tai ensimmäisen ja viimeisen ruudun kuvaparista valmistajan dokumentoidussa työnkulussa. Se tukee viiden tai kymmenen sekunnin jaksoja, useita tuloskokoja 4K:hon asti, 30 tai 60 fps:n kuvataajuutta ja valinnaisia generoituja äänitehosteita.

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

Tietoa mallista

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

CogVideoX 3 on Zhipu AI:n videomalli, jolle on dokumentoitu tekstistä videoksi, kuvasta videoksi sekä ensimmäisestä ja viimeisestä ruudusta generointi. Valmistaja painottaa kuvien vakautta, ohjeiden noudattamista sekä realistisia tai kolmiulotteisia visuaalisia tyylejä. Valitse teksti, kun kohtaus alkaa kirjallisena kuvauksena, yksi kuva, kun visuaalinen perusta on jo olemassa, tai kaksi päätepistekuvaa, kun jaksolle tarvitaan määritelty alku- ja loppunäkymä.

Kuvaa tekstipohjaisessa tehtävässä kohde ja yksi ymmärrettävä toiminto. Määritä ympäristö, näkökulma ja tärkeät fyysiset suhteet, jotta kohtausta voidaan arvioida selkeää tarkoitusta vasten. Esineen nostava hahmo tarvitsee erilaisen jakson kuin esineen paljastava kamera. Kuvaa molemmat vain silloin, kun niiden välinen suhde on otokselle tärkeä.

Valmistele kuvapohjaisen jakson referenssi niin, että kohteen tunnusomaiset piirteet näkyvät. Valmistaja hyväksyy enintään 5 MB:n PNG-, JPEG- ja JPG-kuvia URL-osoitteena tai koodattuna kuvadatana. Säilytä varsinainen referenssi generoidun tuloksen yhteydessä, jotta ulkoasua ja rajausta voidaan verrata lähteeseen eikä siitä muistettuun versioon.

Valmistajan pääteruututila hyväksyy kaksi kuvaa järjestyksessä: ensimmäinen määrittää aloitusruudun ja toinen lopetusruudun. Valmistele ne yhden otoksen kahdeksi aiotuksi tilaksi. Kuvaa niitä yhdistävä siirtymä tai toiminto ja tarkista sitten, pysyykö kohde yhtenäisenä päätepisteiden välillä. Kaksi hyvää stillkuvaa ei itsessään osoita, että niiden välinen liike sopii haluttuun tarinaan.

Kehote voi sisältää enintään 512 merkkiä. Käytä saatavilla olevaa tekstiä toimintaan, sen suuntaan ja visuaalisiin yksityiskohtiin, jotka erottavat onnistuneen tuloksen. Keskity kuvauksessa siihen, mitä ruudulla tulee tapahtua. Kun syötekuvat jo määrittävät kohteen ulkoasun, kuvaa liike ja ajoitus, joiden tulee kehittyä kuvien välillä tai niistä lähtien.

Valmistaja dokumentoi viiden tai kymmenen sekunnin tulosteen, oletuksena viisi sekuntia, sekä 30 tai 60 kuvaa sekunnissa. Tuetut koot sisältävät 1280×720, 720×1280, 1024×1024, 1920×1080, 1080×1920, 2048×1080 ja 3840×2160. Valitse koko ja ajoitus käyttökohteen mukaan ja tarkista sitten valmiin leikkeen rajaus ja todellisen toiminnan tahti.

Laatu- ja nopeustilat dokumentoidaan erillään valinnaisesta tekoälyäänitehosteen asetuksesta. Säilytä nämä valinnat kehotteen, kuvien ja tuloksen yhteydessä. Valmistajan visuaaliset ja syöteominaisuudet kuvaavat mallia; yksittäisen generointimenetelmän käytettävissä olevat asetukset määritetään kyseisen menetelmän sopimuksessa. Säilytä tosiasiassa käytetyt asetukset leike-ehdokkaita vertaillessasi.

Säilytä alkuperäisen tehtävän tunniste videon valmistumiseen asti ja tallenna palautettu kuvamateriaali editointiin. Tarkista koko jakso, mukaan lukien kohteen ulkoasu laajan liikkeen aikana, vuorovaikutus kohtauksen esineiden kanssa ja lopullinen sommittelu. Tarkista pääteruututyössä molemmat päätepisteet ja niiden välinen siirtymä. Korjaa täsmällinen visuaalinen poikkeama säilyttäen onnistuneet referenssit ja otossuunnitelma ja vertaa valmiita videoita pelkkien esikatselukuvien sijaan.

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

cogvideox-3

Zhipu AI /cogvideox-3

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-3 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.3 pyyntöä kohden
AsetuksetArvioitu luontikustannus	Hinnasto—	Ennustettu määräyhden generoinnin arvio	Laskutusmäärä—	Veloitus Tuloste · Arvioidut generointikustannukset · Arvio vain vertailua varten $0.3 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-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

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

Menetelmäpolkujen aliakset

/v1/videos/generations

Liittyvät kutsujan ID:t

cogvideox-3

FAQ · Zhipu AI: CogVideoX 3

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

Zhipu AI: CogVideoX 3