Zhipu AI: CogVideoX 3

CogVideoX 3 maakt video uit tekst, een beeld of een paar met eerste en laatste frame in de gedocumenteerde werkstroom van de maker. Het ondersteunt reeksen van vijf of tien seconden, meerdere uitvoergroottes tot 4K, 30 of 60 fps en optionele gegenereerde geluidseffecten.

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

Over het model

Deze beschrijving gaat over de mogelijkheden van het model. De via Ailoot beschikbare invoer, uitvoer en opties staan hieronder voor de geselecteerde methode.

CogVideoX 3 is het videomodel van Zhipu AI met gedocumenteerde tekst-naar-video-, beeld-naar-video- en eerste-en-laatste-framegeneratie. De maker benadrukt framestabiliteit, het volgen van instructies en realistische of driedimensionale visuele stijlen. Kies tekst wanneer de scène als schriftelijke briefing begint, één beeld wanneer de visuele basis al bestaat of twee eindpuntbeelden wanneer de reeks een bepaald openings- en slotbeeld nodig heeft.

Beschrijf voor een tekstbriefing het onderwerp en één begrijpelijke actie. Benoem de omgeving, het gezichtspunt en belangrijke fysieke relaties zodat de scène aan een heldere bedoeling kan worden getoetst. Een personage dat een object oppakt, vereist een andere reeks dan een camera die dat object onthult. Beschrijf beide alleen wanneer hun relatie voor de opname belangrijk is.

Bereid voor een op beelden gebaseerde reeks de referentie zo voor dat de onderscheidende onderwerpkenmerken zichtbaar zijn. De maker accepteert PNG-, JPEG- en JPG-beelden van maximaal 5 MB, aangeleverd via een URL of gecodeerde beeldgegevens. Bewaar de werkelijke referentie bij het gegenereerde resultaat zodat uiterlijk en beeldkader met de bron kunnen worden vergeleken in plaats van met een herinnerde versie ervan.

De eindpuntframemodus van de maker accepteert twee beelden in volgorde: het eerste legt het openingsframe vast en het tweede het eindframe. Bereid ze voor als de twee beoogde toestanden van één opname. Beschrijf de overgang of actie die ze verbindt en beoordeel daarna of het onderwerp tussen de eindpunten samenhangend blijft. Een paar goede stilstaande beelden toont op zichzelf niet dat de tussenliggende beweging bij het gewenste verhaal past.

De prompt kan maximaal 512 tekens bevatten. Gebruik de beschikbare tekst voor de actie, de richting en de visuele details die een geslaagd resultaat onderscheiden. Houd de briefing gericht op wat op het scherm moet gebeuren. Beschrijf wanneer de invoerbeelden het uiterlijk van het onderwerp al vastleggen de beweging en timing die zich tussen of vanuit die beelden moeten ontwikkelen.

De maker documenteert uitvoer van vijf of tien seconden, met vijf seconden als standaard, en 30 of 60 beelden per seconde. Ondersteunde groottes zijn 1280×720, 720×1280, 1024×1024, 1920×1080, 1080×1920, 2048×1080 en 3840×2160. Kies de grootte en timing voor de bestemming en inspecteer daarna de voltooide clip op het beeldkader en het tempo van de werkelijke actie.

De modi quality en speed zijn los van de optionele AI-geluidseffectinstelling gedocumenteerd. Bewaar deze keuzes bij de prompt, beelden en het resultaat. De visuele en invoermogelijkheden van de maker beschrijven het model; de beschikbare instellingen van een specifieke generatiemethode worden door het contract van die methode geleverd. Behoud de daadwerkelijk gebruikte instellingen wanneer u kandidaatopnamen vergelijkt.

Behoud de oorspronkelijke taakidentiteit totdat de video voltooid is en sla de teruggegeven beelden voor montage op. Beoordeel de volledige reeks, inclusief het uiterlijk van het onderwerp tijdens grote bewegingen, interacties met scèneobjecten en de eindcompositie. Inspecteer bij werk met eindpuntframes beide eindpunten en de overgang ertussen. Herzie de specifieke visuele afwijking met behoud van geslaagde referenties en het opnameplan en vergelijk de voltooide video’s in plaats van alleen hun voorbeeldbeelden.

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

cogvideox-3

Zhipu AI /cogvideox-3

Aan de slag

Toegestane invoer: Tekst
Resultaten: Video

Beschikbaar in Ailoot · invoer en methoden

Ailoot Ultra · Videomateriaal POST /v1/videos

Invoertypen: text
Uitvoertypen: video

Veld	Type	Vereiste	Waarden en limieten	Standaard
Veld`model`	Type`string`	VereisteVereist	Waarden en limieten cogvideox-3 Voorwaarden: Gebruik de exacte Ailoot-modelidentificatie.	Standaard—
Veld`prompt`	Type`string`	VereisteVereist	Waarden en limieten Voorwaarden: Beschrijf de scène en beweging.	Standaard—
Veld`quality`	Type`boolean`	VereisteOptioneel	Waarden en limieten Voorwaarden: Optionele kwaliteitsvlag; dit geselecteerde schema biedt geen compatibele enum of standaardwaarde.	Standaard—
Veld`with_audio`	Type`boolean`	VereisteOptioneel	Waarden en limieten Voorwaarden: Genereer AI-geluidseffecten wanneer ingeschakeld.	Standaardfalse
Veld`size`	Type`string`	VereisteOptioneel	Waarden en limieten Voorwaarden: Geef de gedocumenteerde groottetekenreeks op wanneer u expliciete afmetingen selecteert.	Standaard—
Veld`fps`	Type`string`	VereisteOptioneel	Waarden en limieten 30, 60 Voorwaarden: Bij deze geselecteerde native methode wordt de framesnelheid weergegeven als een tekenreeks.	Standaard30
Veld`duration`	Type`string`	VereisteOptioneel	Waarden en limieten 5, 10 Voorwaarden: Bij deze geselecteerde native methode wordt de duur in seconden weergegeven als een tekenreeks.	Standaard5

Methodeparameters en levenscyclus

Parameter	Contract
Parameter`content_type`	Contractapplication/json
Parameter`required`	Contractmodel, prompt
Parameter`optional`	Contractquality, with_audio, size, fps, duration
Parameter`material_types`	Contracttext
Parameter`conditions`	ContractGebruik de exacte Ailoot-modelidentificatie., Beschrijf de scène en beweging., Optionele kwaliteitsvlag; dit geselecteerde schema biedt geen compatibele enum of standaardwaarde., Genereer AI-geluidseffecten wanneer ingeschakeld., Geef de gedocumenteerde groottetekenreeks op wanneer u expliciete afmetingen selecteert., Bij deze geselecteerde native methode wordt de framesnelheid weergegeven als een tekenreeks., Bij deze geselecteerde native methode wordt de duur in seconden weergegeven als een tekenreeks.

Methodealiasnamen: /v1/videos/generations

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

Tarieven

Zo worden de uiteindelijke kosten berekend

De weergegeven tarieven geven een schatting van de kosten vóór de generatie. Het definitieve bedrag wordt berekend op basis van de kosten die voor de oorspronkelijke generatie zijn geregistreerd. De gemeten duur van de uitvoer en de geschatte hoeveelheden zijn niet de definitieve factureerbare hoeveelheid.

Tariefverwijzingen voegen geen verzoekopties toe. Ondersteunde parameters staan bij de geselecteerde methode.

Snelle modus: Niet opgegeven Wanneer de snelle modus is geselecteerd
Flexmodus: Niet opgegeven Wanneer de modus flex is geselecteerd
Maximale redeneerinspanning: Niet opgegeven Wanneer bij maximale redeneerinspanning de default-aanpassing wordt gebruikt

Geschatte tarieven ter vergelijking

Prijzen per configuratie

Koppel elke kostenpost aan de getoonde voorwaarden. Gebruik één tarief voor elke groep alternatieve configuraties.

Configuratie	Tariefstaffel	Verwachte hoeveelheid	Gefactureerde hoeveelheid	Kosten
ConfiguratieBasistarieven voor tokens	TariefstaffelBasistarief	Verwachte hoeveelheid—	Gefactureerde hoeveelheid—	Kosten Invoer · Invoertokens · Schatting uitsluitend ter vergelijking — / 1K tokens Uitvoer · Uitvoertokens · Schatting uitsluitend ter vergelijking — / 1K tokens Invoer · Cache lezen · Schatting uitsluitend ter vergelijking — / 1K tokens Invoer · Cache schrijven · Schatting uitsluitend ter vergelijking — / 1K tokens Invoer · Cache schrijven, 1 uur · Schatting uitsluitend ter vergelijking — / 1K tokens
ConfiguratiePer verzoek	Tariefstaffel—	Verwachte hoeveelheid—	Gefactureerde hoeveelheidéén verzoek	Kosten Invoer · Schatting uitsluitend ter vergelijking $0.3 per verzoek
ConfiguratieGeschatte generatiekosten	Tariefstaffel—	Verwachte hoeveelheidschatting voor één generatie	Gefactureerde hoeveelheid—	Kosten Uitvoer · Geschatte generatiekosten · Schatting uitsluitend ter vergelijking $0.3 schatting vóór generatie Deze schatting is geen extra bedrag of vast tarief voor de voltooide generatie.

Ailoot reserveert vóór een verzoek een geschat bedrag. Na het resultaat worden de uiteindelijke kosten afgerekend op basis van het gemeten verbruik. Bij streaming gebeurt de afrekening op basis van de definitieve verbruiksregistratie. Zo werken reservering en afrekening →

Voorbeeldverzoeken

Ailoot Ultra · Videomateriaal

curl · maak één keer aan en bewaar het ontvangstbewijsLees de oorspronkelijke taakSla elk voltooid eigen bestand op

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

Resultaten ophalen en opslaan

Ailoot Ultra · Videomateriaal

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}

Alle voltooide resultaten bewaren

Sla elke voltooide video of elk teruggegeven bestand op; haal elke daadwerkelijk teruggegeven bestands-URL op.

Bewaar het volledige antwoord en de headers, de oorspronkelijke identificaties, alle daadwerkelijke uitvoer en alle gebruiks-/afrekenvelden. Sla elke unieke asset op die u bezit en behoud elke rol die ernaar verwijst.

Als het oorspronkelijke antwoord moet worden gecontroleerd

Bewaar de geretourneerde openbare taak- of operatie-id en alle headers. Lees uitsluitend de oorspronkelijke taak; unknown of result_pending_check geeft geen toestemming voor een nieuwe aanmaak.

Antwoordvelden

Veld	Type
Veld`id`	Typestring
Veld`polling_url`	Typestring
Veld`provider_task_id`	Typestring
Veld`id`	Typestring
Veld`task_status`	Typestring
Veld`video_result[].url`	Typestring

Aliasnamen

Modelaliasnamen

Ailoot Ultra cogvideox-3

Aliasnamen voor methodepaden

/v1/videos/generations

Gerelateerde aanroeper-ID’s

cogvideox-3

FAQ · Zhipu AI: CogVideoX 3

Welke invoer en resultaten zijn beschikbaar?: POST /v1/videos · cogvideox-3: text → video
Welke velden gebruikt het verzoek?: POST /v1/videos · cogvideox-3: model, prompt, quality, with_audio, size, fps, duration

Zhipu AI: CogVideoX 3