Zhipu AI: CogVideoX 3
CogVideoX 3 lager video fra tekst, et bilde eller et par med første og siste bilde i produsentens dokumenterte prosess. Den støtter sekvenser på fem eller ti sekunder, flere utdatastørrelser opptil 4K, 30 eller 60 fps og valgfrie genererte lydeffekter.
Om modellen
Denne beskrivelsen dekker modellens funksjoner. Tilgjengelige inndata, utdata og alternativer i Ailoot er oppført nedenfor for den valgte metoden.
CogVideoX 3 er Zhipu AIs videomodell med dokumentert tekst-til-video-, bilde-til-video- og første-og-siste-bilde-generering. Produsenten fremhever bildestabilitet, instruksjonsfølging og realistiske eller tredimensjonale visuelle stiler. Velg tekst når scenen begynner som en skriftlig beskrivelse, ett bilde når det visuelle grunnlaget allerede finnes, eller to endepunktbilder når sekvensen trenger en definert åpnings- og sluttvisning.
For en tekstbeskrivelse oppgis motivet og én lesbar handling. Beskriv miljø, synsvinkel og viktige fysiske forhold, slik at scenen kan vurderes mot en tydelig hensikt. En figur som plukker opp et objekt, trenger en annen sekvens enn et kamera som avdekker objektet. Beskriv begge bare når forholdet mellom dem er viktig for opptaket.
For en bildebasert sekvens klargjøres referansen slik at motivets særtrekk er synlige. Produsenten godtar PNG-, JPEG- og JPG-bilder på høyst 5 MB, oppgitt som URL eller kodede bildedata. Behold selve referansen sammen med det genererte resultatet, slik at utseende og utsnitt kan sammenlignes med kilden fremfor en husket versjon av den.
Produsentens endepunktbildemodus godtar to bilder i rekkefølge: det første etablerer åpningsbildet og det andre sluttbildet. Klargjør dem som de to tiltenkte tilstandene i ett opptak. Beskriv overgangen eller handlingen som forbinder dem, og vurder deretter om motivet forblir sammenhengende mellom endepunktene. Et par gode stillbilder viser ikke i seg selv at bevegelsen imellom passer den ønskede historien.
Prompten kan inneholde opptil 512 tegn. Bruk teksten til handlingen, retningen og de visuelle detaljene som kjennetegner et vellykket resultat. Hold beskrivelsen rettet mot det som skal skje på skjermen. Når inndatabildene allerede etablerer motivets utseende, beskriv bevegelsen og timingen som skal utvikle seg mellom eller fra bildene.
Produsenten dokumenterer utdata på fem eller ti sekunder, med fem sekunder som standard, og 30 eller 60 bilder per sekund. Støttede størrelser omfatter 1280×720, 720×1280, 1024×1024, 1920×1080, 1080×1920, 2048×1080 og 3840×2160. Velg størrelse og timing for bruksstedet, og undersøk deretter det ferdige klippet for utsnitt og tempoet i den faktiske handlingen.
Kvalitets- og hastighetsmoduser dokumenteres separat fra den valgfrie KI-lydeffektinnstillingen. Behold disse valgene sammen med prompt, bilder og resultat. Produsentens visuelle egenskaper og inndataegenskaper beskriver modellen; tilgjengelige kontroller for en bestemt genereringsmetode angis av kontrakten for den metoden. Behold innstillingene som faktisk ble brukt, når kandidatopptak sammenlignes.
Behold den opprinnelige oppgaveidentiteten til videoen er ferdig, og lagre det returnerte materialet for redigering. Vurder hele sekvensen, inkludert motivets utseende under store bevegelser, samspill med sceneobjekter og sluttkomposisjonen. For arbeid med endepunktbilder undersøkes begge endepunktene og overgangen mellom dem. Revider det konkrete visuelle avviket, behold vellykkede referanser og opptaksplanen, og sammenlign ferdige videoer fremfor bare forhåndsvisningsbildene.
Ailoot Ultra · Videogenerering POST /v1/videos cogvideox-3
cogvideox-3Start
CogVideoX 3 lager video fra tekst, et bilde eller et par med første og siste bilde i produsentens dokumenterte prosess. Den støtter sekvenser på fem eller ti sekunder, flere utdatastørrelser opptil 4K, 30 eller 60 fps og valgfrie genererte lydeffekter.
- 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-3 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.3 per forespørsel |
| KonfigurasjonAnslått genereringskostnad | Prisplan— | Forventet mengdeestimat for én generering | Faktureringsmengde— | Kostnad Utdata · Anslått genereringskostnad · Estimat kun for sammenligning $0.3 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-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
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-3
Aliaser for metodestier
/v1/videos/generations
Tilknyttede anroper-ID-er
FAQ · Zhipu AI: CogVideoX 3
- Hvilke inndata og resultater er tilgjengelige?
POST /v1/videos·cogvideox-3:text→video- Hvilke felt bruker forespørselen?
POST /v1/videos·cogvideox-3:model,prompt,quality,with_audio,size,fps,duration