Zhipu AI: CogVideoX 2

CogVideoX 2 genererar video från en textbeskrivning eller en tillhandahållen bild. Tillverkaren dokumenterar valbara bildstorlekar, 30 eller 60 fps, kvalitets- eller hastighetslägen och valfria genererade ljudeffekter för att utforma en kort visuell scen.

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

Om modellen

Den här beskrivningen omfattar modellens förmågor. Tillgängliga indata, utdata och alternativ i Ailoot anges nedan för den valda metoden.

CogVideoX 2 är Zhipu AI:s videogenereringsmodell för en skriftlig scenbeskrivning eller en tillhandahållen bild. Texten fastställer motiv, miljö och handling; en bild kan ge den visuella grunden för den genererade sekvensen. Välj den indata som bäst motsvarar det material som redan finns för tagningen och beskriv sedan den synliga rörelse som den färdiga videon ska innehålla.

Definiera en sammanhängande händelse vid textbaserat skapande. En person som öppnar en verkstadsdörr, en liten båt som passerar en brygga eller ett föremål som roterar i jämnt ljus ger var och en tagningen ett tydligt syfte. Ange motivets viktiga egenskaper, kameravinkeln och rörelsens riktning. Välj ett slut som kan användas i den avsedda redigeringen i stället för att lämna scenens slutkomposition ospecificerad.

Vid bildbaserat skapande förbereds en tydlig bild av motivet och en beskrivning av hur scenen ska röra sig utifrån den. Tillverkaren accepterar PNG-, JPEG- och JPG-referenser på högst 5 MB via bild-URL eller kodade bilddata. Håll viktiga konturer, ansiktsdrag och objektdetaljer synliga i referensen och lämna utrymme i kompositionen för den begärda handlingen.

Tillverkaren begränsar den skriftliga prompten till 512 tecken. Använd utrymmet för de avgörande detaljerna: motiv, handling, miljö och kameravinkel. En kort beskrivning som förklarar vilket föremål som rör sig och vad som förblir stilla är lättare att bedöma än en lista med allmänna stiladjektiv. Om resultatet missar målet, ändra instruktionen som hör till det observerade rörelse- eller inramningsproblemet.

De publicerade utdatastorlekarna omfattar kvadratiska, liggande och stående format, med alternativ från 720×480 till 3840×2160 pixlar. Tillverkaren dokumenterar också 30 eller 60 bildrutor per sekund. Välj form och bildfrekvens för destinationen före generering och granska sedan den faktiska videon för att se om motivet och dess viktiga detaljer förblir läsbara i den inramningen.

Kvalitet och hastighet är namngivna utdatalägen i tillverkarens arbetsflöde. Valfria AI-genererade ljudeffekter styrs separat från den visuella beskrivningen. Behåll det valda läget och inställningen för ljudeffekter med prompten och eventuell referensbild så att olika kandidatvideor kan jämföras utifrån sina faktiska genereringsinställningar.

Genereringen är asynkron: en uppgiftsidentitet returneras innan den färdiga videon är tillgänglig. Behåll identiteten genom resultatkontrollen och spara alla färdiga videofiler som hör till operationen. Spara själva videon för redigering, tillsammans med källbilden när en sådan används, i stället för att förlita dig på en tillfällig resultatadress eller en förhandsbild.

Granska hela sekvensens kontinuitet, timing och begärda handling. En produktvideo behöver behålla form och materialdetaljer under rörelsen; en karaktärsscen behöver ett sammanhängande utseende och sammanhängande gester. Kontrollera slutkompositionen och eventuellt genererat ljud mot tagningens syfte. Behåll de lyckade scenelementen när en konkret avvikelse rättas och använd samma visningsförhållanden vid jämförelsen mellan ursprungliga och reviderade videor.

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

cogvideox-2

Zhipu AI /cogvideox-2

Start

Godkända indata: Text
Resultat: Video

Tillgängligt i Ailoot · indata & metoder

Ailoot Ultra · Videor POST /v1/videos

Indatatyper: text
Utdatatyper: video

Fält	Typ	Krav	Värden & gränser	Standard
Fält`model`	Typ`string`	KravObligatoriskt	Värden & gränser cogvideox-2 Villkor: Använd den exakta modellväljaren för Ailoot.	Standard—
Fält`prompt`	Typ`string`	KravObligatoriskt	Värden & gränser Villkor: Beskriv scenen och rörelsen.	Standard—
Fält`quality`	Typ`boolean`	KravValfritt	Värden & gränser Villkor: Valfri kvalitetsflagga; detta valda schema anger ingen kompatibel enum eller något standardvärde.	Standard—
Fält`with_audio`	Typ`boolean`	KravValfritt	Värden & gränser Villkor: Generera AI-ljudeffekter när funktionen är aktiverad.	Standardfalse
Fält`size`	Typ`string`	KravValfritt	Värden & gränser Villkor: Ange den dokumenterade storlekssträngen när du väljer uttryckliga dimensioner.	Standard—
Fält`fps`	Typ`string`	KravValfritt	Värden & gränser 30, 60 Villkor: Bildfrekvensen representeras som en sträng för denna valda leverantörsspecifika metod.	Standard30
Fält`duration`	Typ`string`	KravValfritt	Värden & gränser 5, 10 Villkor: Längden i sekunder representeras som en sträng för denna valda leverantörsspecifika metod.	Standard5

Metodparametrar och livscykel

Parameter	Avtal
Parameter`content_type`	Avtalapplication/json
Parameter`required`	Avtalmodel, prompt
Parameter`optional`	Avtalquality, with_audio, size, fps, duration
Parameter`material_types`	Avtaltext
Parameter`conditions`	AvtalAnvänd den exakta modellväljaren för Ailoot., Beskriv scenen och rörelsen., Valfri kvalitetsflagga; detta valda schema anger ingen kompatibel enum eller något standardvärde., Generera AI-ljudeffekter när funktionen är aktiverad., Ange den dokumenterade storlekssträngen när du väljer uttryckliga dimensioner., Bildfrekvensen representeras som en sträng för denna valda leverantörsspecifika metod., Längden i sekunder representeras som en sträng för denna valda leverantörsspecifika metod.

Metodalias: /v1/videos/generations

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

Priser

Så beräknas slutavgiften

De visade priserna används för att uppskatta kostnaden före genereringen. Den slutliga debiteringen beräknas utifrån den kostnad som registrerats för den ursprungliga genereringen. Uppmätt längd på resultatet och uppskattade mängder utgör inte den slutliga debiterbara mängden.

Tariffuppgifter lägger inte till begäransalternativ. Parametrar som stöds anges för den valda metoden.

Snabbt läge: Ej angivet När snabbt läge är valt
Flex-läge: Ej angivet När läget flex är valt
Högsta resonemangsnivå: Ej angivet När den högsta resonemangsnivån använder standardjusteringen (default)

Uppskattade priser för jämförelse

Priser efter konfiguration

Matcha varje avgift mot de visade villkoren. Använd ett pris för varje uppsättning alternativa konfigurationer.

Konfiguration	Prislista	Prognostiserad mängd	Debiteringsmängd	Avgift
KonfigurationGrundpriser för token	PrislistaGrundpris	Prognostiserad mängd—	Debiteringsmängd—	Avgift Indata · Indatatoken · Uppskattning endast för jämförelse — / 1K token Utdata · Utdatatoken · Uppskattning endast för jämförelse — / 1K token Indata · Cacheläsning · Uppskattning endast för jämförelse — / 1K token Indata · Skrivning till cache · Uppskattning endast för jämförelse — / 1K token Indata · Skrivning till cache, 1 tim · Uppskattning endast för jämförelse — / 1K token
KonfigurationPer begäran	Prislista—	Prognostiserad mängd—	Debiteringsmängden förfrågan	Avgift Indata · Uppskattning endast för jämförelse $0.2 per begäran
KonfigurationUppskattad genereringskostnad	Prislista—	Prognostiserad mängduppskattning för en generering	Debiteringsmängd—	Avgift Utdata · Uppskattad genereringskostnad · Uppskattning endast för jämförelse $0.2 uppskattning före generering Denna uppskattning är varken en extra avgift eller ett fast pris för den slutförda genereringen.

Ailoot reserverar ett uppskattat belopp före en begäran. Efter resultatet slutregleras avgiften utifrån uppmätt förbrukning. Slutreglering för strömning använder den slutliga förbrukningsposten. Så fungerar reservation och slutreglering →

Exempelbegäranden

Ailoot Ultra · Videor

curl · skapa en gång och bevara kvittotLäs den ursprungliga uppgiftenSpara varje färdig resurs som tillhör dig

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

Ta emot och spara resultat

Ailoot Ultra · Videor

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}

Behåll alla färdiga resultat

Spara varje färdig video eller returnerad fil; hämta varje faktiskt returnerad resurs-URL.

Behåll hela svaret och svarshuvudena, ursprungliga identifierare, varje faktiskt resultat och alla förbruknings- och redovisningsfält. Spara varje unik tillgång som du äger och behåll varje roll som pekar på den.

Om det ursprungliga svaret behöver kontrolleras

Behåll det returnerade offentliga uppgifts- eller operations-id:t och samtliga svarshuvuden. Läs endast den ursprungliga uppgiften; unknown eller result_pending_check ger inte tillstånd att skapa på nytt.

Svarsfält

Fält	Typ
Fält`id`	Typstring
Fält`polling_url`	Typstring
Fält`provider_task_id`	Typstring
Fält`id`	Typstring
Fält`task_status`	Typstring
Fält`video_result[].url`	Typstring

Alias

Modellalias

Ailoot Ultra cogvideox-2

Alias för metodsökvägar

/v1/videos/generations

Relaterade anropar-ID:n

cogvideox-2

FAQ · Zhipu AI: CogVideoX 2

Vilka indata och resultat finns?: POST /v1/videos · cogvideox-2: text → video
Vilka fält använder begäran?: POST /v1/videos · cogvideox-2: model, prompt, quality, with_audio, size, fps, duration

Zhipu AI: CogVideoX 2