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

Invoertypen: text
Uitvoertypen: video

Veld	Type	Vereiste	Waarden en limieten	Standaard
Veld`model`	Type`string`	VereisteVereist	Waarden en limieten cogvideox-2 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.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 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-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 · 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-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