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 · Videogeneratie 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 · Videogeneratie 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 · Videogeneratie POST /v1/videos

Invoer: text
Uitvoer: video

Veld	Type	Vereiste	Waarden en limieten	Standaard
Veld`model`	Type`string`	VereisteVereist	Waarden en limieten cogvideox-3 Voorwaarden: Gebruik de exacte modelselectie van Ailoot.	Standaard—
Veld`prompt`	Type`string`	VereisteVereist	Waarden en limieten Voorwaarden: Beschrijf de scène en de beweging.	Standaard—
Veld`quality`	Type`boolean`	VereisteOptioneel	Waarden en limieten Voorwaarden: Optionele kwaliteitsvlag; dit geselecteerde schema geeft geen compatibele enum of standaardwaarde op.	Standaard—
Veld`with_audio`	Type`boolean`	VereisteOptioneel	Waarden en limieten Voorwaarden: Genereer AI-geluidseffecten wanneer dit is ingeschakeld.	Standaardfalse
Veld`size`	Type`string`	VereisteOptioneel	Waarden en limieten Voorwaarden: Geef de gedocumenteerde groottetekenreeks op wanneer je expliciete afmetingen selecteert.	Standaard—
Veld`fps`	Type`string`	VereisteOptioneel	Waarden en limieten 30, 60 Voorwaarden: Bij deze geselecteerde natieve methode wordt de beeldfrequentie als een tekenreeks weergegeven.	Standaard30
Veld`duration`	Type`string`	VereisteOptioneel	Waarden en limieten 5, 10 Voorwaarden: Bij deze geselecteerde natieve methode wordt de duur in seconden als een tekenreeks weergegeven.	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 modelselectie van Ailoot., Beschrijf de scène en de beweging., Optionele kwaliteitsvlag; dit geselecteerde schema geeft geen compatibele enum of standaardwaarde op., Genereer AI-geluidseffecten wanneer dit is ingeschakeld., Geef de gedocumenteerde groottetekenreeks op wanneer je expliciete afmetingen selecteert., Bij deze geselecteerde natieve methode wordt de beeldfrequentie als een tekenreeks weergegeven., Bij deze geselecteerde natieve methode wordt de duur in seconden als een tekenreeks weergegeven.

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 getoonde tarieven ramen de kosten vóór de generatie. De definitieve kosten worden berekend op basis van de kosten die voor de oorspronkelijke generatie zijn geregistreerd. De gemeten duur van het gegenereerde resultaat en de geraamde hoeveelheden vormen 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 geselecteerd is
Flex-modus: Niet opgegeven Wanneer de flex-modus geselecteerd is
Maximale redeneerinspanning: Niet opgegeven Wanneer voor 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 aanvraag	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 raming is geen extra kost 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 · Videogeneratie

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 · Videogeneratie

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 identificatiecodes, alle werkelijke uitvoer en alle velden voor verbruik en boekhouding. Sla elke unieke asset die je toebehoort op en behoud elke rol die ernaar verwijst.

Als het oorspronkelijke antwoord moet worden gecontroleerd

Bewaar de teruggestuurde openbare taak- of operatie-id en alle headers. Raadpleeg uitsluitend de oorspronkelijke taak; unknown of result_pending_check geeft geen toestemming om opnieuw een taak aan te maken.

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