Zhipu AI: CogVideoX 2

CogVideoX 2 genereert video uit een tekstbeschrijving of een aangeleverd beeld. De maker documenteert selecteerbare framegroottes, 30 of 60 fps, de modi quality of speed en optionele gegenereerde geluidseffecten om een korte visuele scène vorm te geven.

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

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 2 is het videogeneratiemodel van Zhipu AI voor een geschreven scènebeschrijving of een aangeleverd beeld. Tekst legt het onderwerp, de omgeving en de actie vast; een beeld kan de visuele basis voor de gegenereerde reeks bieden. Gebruik de invoer die het al beschikbare materiaal voor de opname het best vertegenwoordigt en beschrijf daarna de zichtbare beweging die de afgewerkte video moet bevatten.

Definieer voor tekstgestuurde creatie één samenhangende gebeurtenis. Een persoon die een werkplaatsdeur opent, een kleine boot die langs een pier beweegt of een object dat onder constant licht draait, geeft de opname telkens een begrijpelijk doel. Benoem de belangrijke onderwerpkenmerken, het gezichtspunt en de bewegingsrichting. Kies een einde dat in de beoogde montage kan worden gebruikt in plaats van de eindcompositie van de scène onbepaald te laten.

Bereid voor creatie op basis van een beeld een duidelijke weergave van het onderwerp voor en beschrijf hoe de scène daaruit moet bewegen. De maker accepteert PNG-, JPEG- en JPG-referenties tot 5 MB, aangeleverd via een beeld-URL of gecodeerde beeldgegevens. Houd belangrijke randen, gezichtskenmerken en objectdetails zichtbaar in de referentie en laat binnen de compositie ruimte voor de gevraagde actie.

De maker beperkt de geschreven prompt tot 512 tekens. Gebruik die ruimte voor de beslissende details: onderwerp, actie, omgeving en gezichtspunt. Een korte beschrijving die uitlegt welk object beweegt en wat vast blijft, is makkelijker te beoordelen dan een lijst met brede stijladjectieven. Herzie wanneer het resultaat het doel mist de instructie die met het waargenomen bewegings- of kadreringsprobleem verband houdt.

De gepubliceerde uitvoergroottes omvatten vierkante, liggende en staande formaten, met keuzes van 720×480 tot 3840×2160 pixels. De maker documenteert ook 30 of 60 beelden per seconde. Selecteer vóór generatie de vorm en beeldsnelheid voor de bestemming en inspecteer daarna de werkelijke clip om te zien of het onderwerp en de belangrijke details in dat beeldkader leesbaar blijven.

quality en speed zijn benoemde uitvoermodi in de werkstroom van de maker. Optionele, door AI gegenereerde geluidseffecten worden los van de visuele briefing geregeld. Bewaar de geselecteerde modus en de geluidseffectinstelling bij de prompt en een eventuele referentieafbeelding zodat kandidaatclips met hun werkelijke generatie-instellingen kunnen worden vergeleken.

Generatie is asynchroon: er wordt een taakidentiteit teruggegeven voordat de afgewerkte video beschikbaar is. Behoud die identiteit tijdens resultaatcontrole en bewaar alle voltooide videobestanden die bij de bewerking horen. Sla de clip zelf voor montage op, samen met het bronbeeld wanneer dat is gebruikt, in plaats van op een tijdelijke resultaatlocatie of een voorbeeldframe te vertrouwen.

Beoordeel de volledige reeks op continuïteit, timing en de gevraagde actie. Een productopname vereist stabiele vorm en materiaaldetails tijdens beweging; een personageopname vereist een samenhangend uiterlijk en gebaren. Toets de eindcompositie en eventueel gegenereerd geluid aan het doel van de opname. Behoud de geslaagde scène-elementen wanneer u een concrete afwijking herziet en gebruik dezelfde kijkomstandigheden om de oorspronkelijke en herziene video’s te vergelijken.

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

cogvideox-2

Zhipu AI /cogvideox-2

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-2 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.2 per verzoek
ConfiguratieGeschatte generatiekosten	Tariefstaffel—	Verwachte hoeveelheidschatting voor één generatie	Gefactureerde hoeveelheid—	Kosten Uitvoer · Geschatte generatiekosten · Schatting uitsluitend ter vergelijking $0.2 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-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

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

Aliasnamen voor methodepaden

/v1/videos/generations

Gerelateerde aanroeper-ID’s

cogvideox-2

FAQ · Zhipu AI: CogVideoX 2

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

Zhipu AI: CogVideoX 2