Zhipu AI: CogVideoX 2
CogVideoX 2 genererer video fra en tekstbeskrivelse eller et oppgitt bilde. Produsenten dokumenterer valgbare bildestørrelser, 30 eller 60 fps, kvalitets- eller hastighetsmoduser og valgfrie genererte lydeffekter for å forme en kort visuell scene.
Om modellen
Denne beskrivelsen dekker modellens funksjoner. Tilgjengelige inndata, utdata og alternativer i Ailoot er oppført nedenfor for den valgte metoden.
CogVideoX 2 er Zhipu AIs videogenereringsmodell for en skriftlig scenebeskrivelse eller et oppgitt bilde. Teksten etablerer motiv, miljø og handling; et bilde kan gi det visuelle grunnlaget for den genererte sekvensen. Bruk inndataene som best representerer materialet som allerede finnes for opptaket, og beskriv deretter den synlige bevegelsen den ferdige videoen skal inneholde.
For tekststyrt skaping defineres én sammenhengende hendelse. En person som åpner en verksteddør, en liten båt som passerer en brygge, eller et objekt som dreier i jevnt lys, gir alle opptaket et lesbart formål. Oppgi viktige motivtrekk, synsvinkel og bevegelsesretning. Velg en avslutning som kan brukes i den planlagte redigeringen, fremfor å la scenens sluttkomposisjon være uspesifisert.
For bildebasert skaping klargjøres en tydelig visning av motivet og en beskrivelse av hvordan scenen skal bevege seg videre fra den. Produsenten godtar PNG-, JPEG- og JPG-referanser på opptil 5 MB, oppgitt som bilde-URL eller kodede bildedata. Hold viktige kanter, ansiktstrekk og objektdetaljer synlige i referansen, og la komposisjonen ha plass til den ønskede handlingen.
Produsenten begrenser den skriftlige prompten til 512 tegn. Bruk plassen til avgjørende detaljer: motiv, handling, miljø og synsvinkel. En kort beskrivelse som forklarer hvilket objekt som beveger seg og hva som forblir stille, er lettere å vurdere enn en liste med generelle stiladjektiver. Hvis resultatet ikke når målet, revider instruksjonen knyttet til det observerte bevegelses- eller utsnittproblemet.
De publiserte utdatastørrelsene omfatter kvadratiske, liggende og stående formater, med valg fra 720×480 til 3840×2160 piksler. Produsenten dokumenterer også 30 eller 60 bilder per sekund. Velg form og bildefrekvens for bruksstedet før generering, og undersøk deretter selve klippet for å se om motivet og viktige detaljer fortsatt er tydelige i dette utsnittet.
Kvalitet og hastighet er navngitte utdatamoduser i produsentens prosess. Valgfrie KI-genererte lydeffekter styres separat fra den visuelle beskrivelsen. Behold valgt modus og lydeffektinnstilling sammen med prompten og eventuelt referansebilde, slik at ulike kandidatklipp kan sammenlignes ved hjelp av de faktiske genereringsinnstillingene.
Generering er asynkron: en oppgaveidentitet returneres før den ferdige videoen er tilgjengelig. Behold identiteten gjennom resultatkontrollen og alle ferdige videofiler knyttet til operasjonen. Lagre selve klippet for redigering, sammen med kildebildet når det brukes, fremfor å være avhengig av en midlertidig resultatplassering eller et forhåndsvisningsbilde.
Vurder hele sekvensen for kontinuitet, timing og ønsket handling. Et produktopptak trenger stabil form og materialdetaljer gjennom bevegelsen; et figuropptak trenger et sammenhengende utseende og gester. Kontroller sluttkomposisjonen og eventuell generert lyd mot opptakets formål. Behold vellykkede sceneelementer når et konkret avvik revideres, og bruk de samme visningsforholdene til å sammenligne originalvideoen og den reviderte videoen.
Ailoot Ultra · Videogenerering POST /v1/videos cogvideox-2
cogvideox-2Start
CogVideoX 2 genererer video fra en tekstbeskrivelse eller et oppgitt bilde. Produsenten dokumenterer valgbare bildestørrelser, 30 eller 60 fps, kvalitets- eller hastighetsmoduser og valgfrie genererte lydeffekter for å forme en kort visuell scene.
- Godkjente inndata
- Tekst
- Resultater
- Video
Tilgjengelig i Ailoot · inndata & metoder
Ailoot Ultra · Videogenerering POST /v1/videos
- Inndatatyper
text- Utdatatyper
video
| Felt | Type | Krav | Verdier & grenser | Standard |
|---|---|---|---|---|
Feltmodel | Typestring | KravPåkrevd | Verdier & grenser cogvideox-2 Vilkår: Bruk den eksakte modellvelgeren for Ailoot. | Standard— |
Feltprompt | Typestring | KravPåkrevd | Verdier & grenser Vilkår: Beskriv scenen og bevegelsen. | Standard— |
Feltquality | Typeboolean | KravValgfritt | Verdier & grenser Vilkår: Valgfritt kvalitetsflagg; dette valgte skjemaet oppgir ingen kompatibel enum eller standardverdi. | Standard— |
Feltwith_audio | Typeboolean | KravValgfritt | Verdier & grenser Vilkår: Generer KI-lydeffekter når funksjonen er aktivert. | Standardfalse |
Feltsize | Typestring | KravValgfritt | Verdier & grenser Vilkår: Oppgi den dokumenterte størrelsesstrengen når du velger eksplisitte mål. | Standard— |
Feltfps | Typestring | KravValgfritt | Verdier & grenser 30, 60 Vilkår: Bildefrekvensen representeres som en streng i denne valgte opprinnelige metoden. | Standard30 |
Feltduration | Typestring | KravValgfritt | Verdier & grenser 5, 10 Vilkår: Varighet i sekunder representeres som en streng i denne valgte opprinnelige metoden. | Standard5 |
Metodeparametere og livssyklus
| Parameter | Avtale |
|---|---|
Parametercontent_type | Avtaleapplication/json |
Parameterrequired | Avtalemodel, prompt |
Parameteroptional | Avtalequality, with_audio, size, fps, duration |
Parametermaterial_types | Avtaletext |
Parameterconditions | AvtaleBruk den eksakte modellvelgeren for Ailoot., Beskriv scenen og bevegelsen., Valgfritt kvalitetsflagg; dette valgte skjemaet oppgir ingen kompatibel enum eller standardverdi., Generer KI-lydeffekter når funksjonen er aktivert., Oppgi den dokumenterte størrelsesstrengen når du velger eksplisitte mål., Bildefrekvensen representeres som en streng i denne valgte opprinnelige metoden., Varighet i sekunder representeres som en streng i denne valgte opprinnelige metoden. |
Metodealiaser: /v1/videos/generations
Livssyklus: 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
Slik beregnes det endelige beløpet
De viste satsene anslår kostnaden før generering. Det endelige beløpet beregnes ut fra kostnaden som er registrert for den opprinnelige genereringen. Målt varighet på utdataene og anslåtte mengder er ikke den endelige fakturerbare mengden.
Tariffopplysninger legger ikke til forespørselsvalg. Støttede parametere står ved den valgte metoden.
- Hurtigmodus
- Ikke angitt Når hurtigmodus er valgt
- Flex-modus
- Ikke angitt Når flex-modus er valgt
- Maksimal resonneringsinnsats
- Ikke angitt Når justeringen «default» brukes for maksimal resonneringsinnsats
Estimerte satser for sammenligning
Priser etter konfigurasjon
Knytt hver kostnad til de viste vilkårene. Bruk én sats for hvert sett med alternative konfigurasjoner.
| Konfigurasjon | Prisplan | Forventet mengde | Faktureringsmengde | Kostnad |
|---|---|---|---|---|
| KonfigurasjonGrunnpriser for tokener | PrisplanGrunnsats | Forventet mengde— | Faktureringsmengde— | Kostnad Inndata · Inngående tokener · Estimat kun for sammenligning — / 1K tokener Utdata · Utgående tokener · Estimat kun for sammenligning — / 1K tokener Inndata · Lesing fra hurtigbuffer · Estimat kun for sammenligning — / 1K tokener Inndata · Skriving til hurtigbuffer · Estimat kun for sammenligning — / 1K tokener Inndata · Skriving til hurtigbuffer, 1 time · Estimat kun for sammenligning — / 1K tokener |
| KonfigurasjonPer forespørsel | Prisplan— | Forventet mengde— | Faktureringsmengdeén forespørsel | Kostnad Inndata · Estimat kun for sammenligning $0.2 per forespørsel |
| KonfigurasjonAnslått genereringskostnad | Prisplan— | Forventet mengdeestimat for én generering | Faktureringsmengde— | Kostnad Utdata · Anslått genereringskostnad · Estimat kun for sammenligning $0.2 estimat før generering Dette anslaget er verken en tilleggsavgift eller en fast sats for den fullførte genereringen. |
Ailoot reserverer et estimert beløp før en forespørsel. Etter resultatet gjøres det endelige beløpet opp basert på målt forbruk. Oppgjør for strømming bruker den endelige forbruksposten. Slik fungerer reservasjon og oppgjør →
Eksempelforespørsler
Ailoot Ultra · Videogenerering
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
Motta og lagre resultater
Ailoot Ultra · Videogenerering
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 ferdige resultater
Lagre hver ferdige video eller returnerte fil; hent hver faktisk returnerte ressurs-URL.
Behold hele svaret og alle svarhoder, opprinnelige identifikatorer, alle faktiske utdata og alle felt for forbruk og avregning. Lagre hver unike ressurs du eier, og behold alle roller som viser til den.
Hvis det opprinnelige svaret må kontrolleres
Behold den returnerte offentlige oppgave- eller operasjons-ID-en og alle svarhoder. Les bare den opprinnelige oppgaven; unknown eller result_pending_check gir ikke tillatelse til en ny opprettelse.
Svarfelter
| Felt | Type |
|---|---|
Feltid | Typestring |
Feltpolling_url | Typestring |
Feltprovider_task_id | Typestring |
Feltid | Typestring |
Felttask_status | Typestring |
Feltvideo_result[].url | Typestring |
Aliaser
Modellaliaser
Ailoot Ultra cogvideox-2
Aliaser for metodestier
/v1/videos/generations
Tilknyttede anroper-ID-er
FAQ · Zhipu AI: CogVideoX 2
- Hvilke inndata og resultater er tilgjengelige?
POST /v1/videos·cogvideox-2:text→video- Hvilke felt bruker forespørselen?
POST /v1/videos·cogvideox-2:model,prompt,quality,with_audio,size,fps,duration