Zhipu AI: CogVideoX 3

CogVideoX 3 skapar video från text, en bild eller ett par med första och sista bildrutan i tillverkarens dokumenterade arbetsflöde. Det stöder sekvenser på fem eller tio sekunder, flera storlekar upp till 4K, 30 eller 60 fps och valfria genererade ljudeffekter.

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

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 3 är Zhipu AI:s videomodell med dokumenterad text-till-video-, bild-till-video- och första-och-sista-bildruta-generering. Tillverkaren betonar bildstabilitet, instruktionsefterlevnad samt realistiska eller tredimensionella visuella stilar. Välj text när scenen börjar som en skriftlig beskrivning, en bild när den visuella grunden redan finns eller två ändpunktsbilder när sekvensen behöver en bestämd öppnings- och slutvy.

Beskriv motivet och en tydlig handling i en textinstruktion. Ange miljö, kameravinkel och viktiga fysiska relationer så att scenen kan bedömas mot en tydlig avsikt. En karaktär som plockar upp ett föremål kräver en annan sekvens än en kamera som avslöjar föremålet. Beskriv båda endast när deras relation är viktig för tagningen.

För en bildbaserad sekvens bör referensen förberedas så att motivets särskiljande egenskaper är synliga. Tillverkaren accepterar PNG-, JPEG- och JPG-bilder på högst 5 MB via en URL eller kodade bilddata. Behåll den faktiska referensen med det genererade resultatet så att utseende och inramning kan jämföras med källan i stället för med ett minne av den.

Tillverkarens ändpunktsläge accepterar två bilder i ordning: den första fastställer öppningsbilden och den andra slutbilden. Förbered dem som två avsedda tillstånd i samma tagning. Beskriv övergången eller handlingen som förbinder dem och granska sedan om motivet förblir sammanhängande mellan ändpunkterna. Två bra stillbilder visar inte i sig att rörelsen mellan dem passar den avsedda berättelsen.

Prompten får innehålla upp till 512 tecken. Använd textutrymmet för handlingen, dess riktning och de visuella detaljer som skiljer ett lyckat resultat från ett misslyckat. Håll beskrivningen inriktad på vad som ska hända på skärmen. När indatabilderna redan fastställer motivets utseende bör texten beskriva rörelsen och timingen som ska utvecklas mellan eller från dem.

Tillverkaren dokumenterar fem eller tio sekunders utdata, med fem sekunder som standard, och 30 eller 60 bildrutor per sekund. Storlekarna omfattar 1280×720, 720×1280, 1024×1024, 1920×1080, 1080×1920, 2048×1080 och 3840×2160. Välj storlek och timing för destinationen och granska sedan den färdiga videons inramning och den faktiska handlingens tempo.

Kvalitets- och hastighetslägen dokumenteras separat från inställningen för valfria AI-ljudeffekter. Behåll dessa val med prompten, bilderna och resultatet. Tillverkarens visuella möjligheter och indatatyper beskriver modellen; vilka kontroller en viss genereringsmetod erbjuder anges i den metodens kontrakt. Bevara de inställningar som faktiskt användes när kandidatsekvenser jämförs.

Behåll den ursprungliga uppgiftsidentiteten tills videon är färdig och spara det returnerade materialet för redigering. Granska hela sekvensen, inklusive motivets utseende under stora rörelser, dess samspel med scenens föremål och slutkompositionen. Vid arbete med ändpunktsbilder granskas både ändpunkterna och övergången mellan dem. Ändra den specifika visuella avvikelsen samtidigt som lyckade referenser och tagningens plan bevaras och jämför de färdiga videorna, inte bara förhandsbilderna.

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

cogvideox-3

Zhipu AI /cogvideox-3

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-3 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.3 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.3 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-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

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

Alias för metodsökvägar

/v1/videos/generations

Relaterade anropar-ID:n

cogvideox-3

FAQ · Zhipu AI: CogVideoX 3

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

Zhipu AI: CogVideoX 3