Zhipu AI: CogVideoX 2
CogVideoX 2 genererer video ud fra en tekstbeskrivelse eller et leveret billede. Producenten dokumenterer valgbare billedstørrelser, 30 eller 60 fps, tilstandene quality eller speed og valgfrie genererede lydeffekter til at forme en kort visuel scene.
Om modellen
Denne beskrivelse dækker modellens funktioner. Tilgængelige input, output og indstillinger i Ailoot står nedenfor for den valgte metode.
CogVideoX 2 er en videogenereringsmodel fra Zhipu AI til en skriftlig scenebeskrivelse eller et leveret billede. Tekst fastlægger motivet, omgivelserne og handlingen; et billede kan give det visuelle grundlag for den genererede sekvens. Brug det input, der bedst repræsenterer det materiale, som allerede er tilgængeligt til optagelsen, og beskriv derefter den synlige bevægelse, den færdige video skal indeholde.
Definér én sammenhængende hændelse ved tekstbaseret skabelse. En person, der åbner en værkstedsdør, en lille båd, der bevæger sig forbi en mole, eller et objekt, der drejer under stabilt lys, giver hver optagelsen et tydeligt formål. Angiv motivets vigtige egenskaber, synsvinklen og bevægelsesretningen. Vælg en afslutning, der kan bruges i den tilsigtede redigering, frem for at lade scenens slutkomposition være uspecificeret.
Forbered en tydelig visning af motivet ved billedbaseret skabelse, og beskriv, hvordan scenen skal bevæge sig ud fra den. Producenten accepterer PNG-, JPEG- og JPG-referencer på op til 5 MB, leveret som billed-URL eller kodede billeddata. Hold vigtige kanter, ansigtstræk og objektdetaljer synlige i referencen, og efterlad plads til den ønskede handling i kompositionen.
Producenten begrænser den skriftlige prompt til 512 tegn. Brug pladsen til de afgørende detaljer: motiv, handling, omgivelser og synsvinkel. En kort beskrivelse, der forklarer, hvilket objekt der bevæger sig, og hvad der forbliver fast, er lettere at vurdere end en liste over brede stiladjektiver. Revidér den instruktion, der er knyttet til det observerede bevægelses- eller billedudsnitsproblem, hvis resultatet ikke opfylder målet.
De offentliggjorte outputstørrelser omfatter kvadratiske, liggende og stående formater med valg fra 720×480 til 3840×2160 pixels. Producenten dokumenterer også 30 eller 60 billeder pr. sekund. Vælg formen og billedhastigheden til destinationen før generering, og undersøg derefter det faktiske klip for at se, om motivet og dets vigtige detaljer forbliver læsbare i det billedudsnit.
quality og speed er navngivne outputtilstande i producentens arbejdsgang. Valgfrie AI-genererede lydeffekter styres adskilt fra den visuelle opgavebeskrivelse. Gem den valgte tilstand og lydeffektindstillingen sammen med prompten og et eventuelt referencebillede, så kandidatklip kan sammenlignes ud fra deres faktiske genereringsindstillinger.
Generering er asynkron: En opgaveidentitet returneres, før den færdige video er tilgængelig. Bevar den identitet gennem resultatkontrol, og gem alle komplette videofiler, der er knyttet til handlingen. Gem selve klippet til redigering sammen med kildebilledet, når det bruges, frem for at være afhængig af en midlertidig resultatplacering eller et forhåndsvisningsbillede.
Gennemgå hele sekvensen for kontinuitet, timing og den ønskede handling. En produktoptagelse kræver stabil form og materialedetaljer under bevægelse; en figuroptagelse kræver sammenhængende udseende og bevægelser. Kontrollér slutkompositionen og eventuel genereret lyd mod optagelsens formål. Bevar de vellykkede sceneelementer, når en konkret afvigelse revideres, og brug de samme visningsforhold til at sammenligne de oprindelige og reviderede videoer.
Ailoot Ultra · Videoer POST /v1/videos cogvideox-2
cogvideox-2Start
CogVideoX 2 genererer video ud fra en tekstbeskrivelse eller et leveret billede. Producenten dokumenterer valgbare billedstørrelser, 30 eller 60 fps, tilstandene quality eller speed og valgfrie genererede lydeffekter til at forme en kort visuel scene.
- Accepterede input
- Tekst
- Resultater
- Video
Tilgængelig i Ailoot · input og metoder
Ailoot Ultra · Videoer POST /v1/videos
- Inputtyper
text- Outputtyper
video
| Felt | Type | Krav | Værdier og grænser | Standard |
|---|---|---|---|---|
Feltmodel | Typestring | KravPåkrævet | Værdier og grænser cogvideox-2 Betingelser: Brug den præcise Ailoot-modelvælger. | Standard— |
Feltprompt | Typestring | KravPåkrævet | Værdier og grænser Betingelser: Beskriv scenen og bevægelsen. | Standard— |
Feltquality | Typeboolean | KravValgfrit | Værdier og grænser Betingelser: Valgfrit kvalitetsflag; dette valgte skema angiver ingen kompatibel enum eller standardværdi. | Standard— |
Feltwith_audio | Typeboolean | KravValgfrit | Værdier og grænser Betingelser: Generér AI-lydeffekter, når funktionen er aktiveret. | Standardfalse |
Feltsize | Typestring | KravValgfrit | Værdier og grænser Betingelser: Angiv den dokumenterede størrelsesstreng, når du vælger eksplicitte dimensioner. | Standard— |
Feltfps | Typestring | KravValgfrit | Værdier og grænser 30, 60 Betingelser: Billedfrekvensen repræsenteres som en streng i denne valgte native metode. | Standard30 |
Feltduration | Typestring | KravValgfrit | Værdier og grænser 5, 10 Betingelser: Varigheden i sekunder repræsenteres som en streng i denne valgte native metode. | Standard5 |
Metodeparametre og livscyklus
| Parameter | Kontrakt |
|---|---|
Parametercontent_type | Kontraktapplication/json |
Parameterrequired | Kontraktmodel, prompt |
Parameteroptional | Kontraktquality, with_audio, size, fps, duration |
Parametermaterial_types | Kontrakttext |
Parameterconditions | KontraktBrug den præcise Ailoot-modelvælger., Beskriv scenen og bevægelsen., Valgfrit kvalitetsflag; dette valgte skema angiver ingen kompatibel enum eller standardværdi., Generér AI-lydeffekter, når funktionen er aktiveret., Angiv den dokumenterede størrelsesstreng, når du vælger eksplicitte dimensioner., Billedfrekvensen repræsenteres som en streng i denne valgte native metode., Varigheden i sekunder repræsenteres som en streng i denne valgte native metode. |
Metodealiaser: /v1/videos/generations
Livscyklus: 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ådan beregnes det endelige beløb
De viste satser bruges til at anslå omkostningen før genereringen. Det endelige beløb beregnes ud fra den registrerede omkostning for den oprindelige generering. Den målte varighed af outputtet og de anslåede mængder er ikke den endelige fakturerbare mængde.
Tarifoplysninger tilføjer ikke anmodningsmuligheder. Understøttede parametre står ved den valgte metode.
- Hurtig tilstand
- Ikke angivet Når hurtig tilstand er valgt
- flex-tilstand
- Ikke angivet Når flex-tilstanden er valgt
- Maksimal ræsonneringsindsats
- Ikke angivet Når default-justeringen anvendes ved maksimal ræsonneringsindsats
Estimerede takster til sammenligning
Priser efter konfiguration
Knyt hver omkostning til de viste betingelser. Brug én takst for hver gruppe af alternative konfigurationer.
| Konfiguration | Takstplan | Forventet mængde | Afregnet mængde | Beløb |
|---|---|---|---|---|
| KonfigurationGrundpriser for tokens | TakstplanGrundtakst | Forventet mængde— | Afregnet mængde— | Beløb Input · Inputtokens · Estimat kun til sammenligning — / 1K tokens Output · Outputtokens · Estimat kun til sammenligning — / 1K tokens Input · Cachelæsning · Estimat kun til sammenligning — / 1K tokens Input · Cacheskrivning · Estimat kun til sammenligning — / 1K tokens Input · Cacheskrivning, 1 time · Estimat kun til sammenligning — / 1K tokens |
| KonfigurationPr. forespørgsel | Takstplan— | Forventet mængde— | Afregnet mængdeén forespørgsel | Beløb Input · Estimat kun til sammenligning $0.2 pr. anmodning |
| KonfigurationAnslået genereringsomkostning | Takstplan— | Forventet mængdeestimat for én generering | Afregnet mængde— | Beløb Output · Anslået genereringsomkostning · Estimat kun til sammenligning $0.2 estimat før generering Dette estimat er hverken et ekstra gebyr eller en fast pris for den færdige generering. |
Ailoot reserverer et estimeret beløb før en anmodning. Efter resultatet afregnes det endelige beløb ud fra det målte forbrug. Ved streaming bruges den endelige forbrugsregistrering til afregningen. Sådan fungerer reservation og afregning →
Eksempelanmodninger
Ailoot Ultra · Videoer
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
Hent og gem resultater
Ailoot Ultra · Videoer
GET /v1/videos/{request_id}GET /v1/videos/generations/{request_id}GET /v1/videos/{request_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}
Behold alle færdige resultater
Gem hver færdig video eller returneret fil; hent hver faktisk returneret fil-URL.
Behold hele svaret og alle headere, de oprindelige identifikatorer, hvert faktisk output og alle felter til forbrug og afregning. Gem hvert entydigt aktiv, du ejer, og behold alle roller, der henviser til det.
Hvis det oprindelige svar skal kontrolleres
Behold det returnerede offentlige opgave- eller operations-id og alle headere. Læs kun den oprindelige opgave; unknown eller result_pending_check giver ikke tilladelse til en ny oprettelse.
Svarfelter
| Felt | Type |
|---|---|
Feltid | Typestring |
Feltpolling_url | Typestring |
Feltprovider_task_id | Typestring |
Feltid | Typestring |
Felttask_status | Typestring |
Feltvideo_result[].url | Typestring |
Aliaser
Modelaliaser
Ailoot Ultra cogvideox-2
Aliaser for metodestier
/v1/videos/generations
Relaterede kalder-ID’er
FAQ · Zhipu AI: CogVideoX 2
- Hvilke input og resultater er tilgængelige?
POST /v1/videos·cogvideox-2:text→video- Hvilke felter bruger anmodningen?
POST /v1/videos·cogvideox-2:model,prompt,quality,with_audio,size,fps,duration