Zhipu AI: CogVideoX 3
CogVideoX 3 skaber video ud fra tekst, et billede eller et par med første og sidste frame i producentens dokumenterede arbejdsgang. Den understøtter sekvenser på fem eller ti sekunder, flere outputstørrelser op til 4K, 30 eller 60 fps og valgfrie genererede lydeffekter.
Om modellen
Denne beskrivelse dækker modellens funktioner. Tilgængelige input, output og indstillinger i Ailoot står nedenfor for den valgte metode.
CogVideoX 3 er en videomodel fra Zhipu AI med dokumenteret tekst-til-video-, billede-til-video- og første-og-sidste-frame-generering. Producenten fremhæver billedstabilitet, instruktionsfølgning og realistiske eller tredimensionelle visuelle stilarter. Vælg tekst, når scenen begynder som en skriftlig opgavebeskrivelse, ét billede, når dens visuelle grundlag allerede findes, eller to endepunktsbilleder, når sekvensen kræver en defineret åbnings- og afslutningsvisning.
Beskriv motivet og én tydelig handling ved en tekstopgave. Angiv omgivelserne, synsvinklen og vigtige fysiske forhold, så scenen kan vurderes mod en klar hensigt. En figur, der løfter et objekt, kræver en anden sekvens end et kamera, der afslører objektet. Beskriv kun begge, når deres forhold er vigtigt for optagelsen.
Forbered referencen, så motivets særlige kendetegn er synlige, ved en billedbaseret sekvens. Producenten accepterer PNG-, JPEG- og JPG-billeder på højst 5 MB, leveret via en URL eller kodede billeddata. Bevar den faktiske reference sammen med det genererede resultat, så udseende og billedudsnit kan sammenlignes med kilden frem for med en husket udgave af den.
Producentens endepunktsframetilstand accepterer to billeder i rækkefølge: Det første fastlægger åbningsbilledet, og det andet afslutningsbilledet. Forbered dem som de to tilsigtede tilstande i én optagelse. Beskriv den overgang eller handling, der forbinder dem, og gennemgå derefter, om motivet forbliver sammenhængende mellem endepunkterne. Et par gode stillbilleder viser ikke i sig selv, at den mellemliggende bevægelse passer til den ønskede fortælling.
Prompten kan indeholde op til 512 tegn. Brug den tilgængelige tekst til handlingen, dens retning og de visuelle detaljer, som adskiller et vellykket resultat. Hold opgavebeskrivelsen fokuseret på det, der skal ske på skærmen. Beskriv den bevægelse og timing, der skal udvikles mellem eller ud fra billederne, når inputbillederne allerede fastlægger motivets udseende.
Producenten dokumenterer output på fem eller ti sekunder med fem sekunder som standard og 30 eller 60 billeder pr. sekund. Understøttede størrelser omfatter 1280×720, 720×1280, 1024×1024, 1920×1080, 1080×1920, 2048×1080 og 3840×2160. Vælg størrelsen og timingen til destinationen, og undersøg derefter det færdige klip for billedudsnit og tempoet i den faktiske handling.
Tilstandene quality og speed dokumenteres adskilt fra den valgfrie AI-lydeffektindstilling. Bevar disse valg sammen med prompten, billederne og resultatet. Producentens visuelle egenskaber og inputmuligheder beskriver modellen; de tilgængelige indstillinger i en bestemt genereringsmetode leveres af den metodes kontrakt. Bevar de faktisk anvendte indstillinger, når kandidatoptagelser sammenlignes.
Bevar den oprindelige opgaveidentitet, indtil videoen er færdig, og gem de returnerede optagelser til redigering. Gennemgå hele sekvensen, herunder motivets udseende under store bevægelser, interaktioner med sceneobjekter og slutkompositionen. Undersøg begge endepunkter og overgangen mellem dem ved arbejde med endepunktsframes. Revidér den konkrete visuelle afvigelse med bevarelse af de vellykkede referencer og optagelsesplanen, og sammenlign de færdige videoer frem for kun forhåndsvisningsbillederne.
Ailoot Ultra · Videoer POST /v1/videos cogvideox-3
cogvideox-3Start
CogVideoX 3 skaber video ud fra tekst, et billede eller et par med første og sidste frame i producentens dokumenterede arbejdsgang. Den understøtter sekvenser på fem eller ti sekunder, flere outputstørrelser op til 4K, 30 eller 60 fps og valgfrie genererede lydeffekter.
- 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-3 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.3 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.3 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-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
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-3
Aliaser for metodestier
/v1/videos/generations
Relaterede kalder-ID’er
FAQ · Zhipu AI: CogVideoX 3
- Hvilke input og resultater er tilgængelige?
POST /v1/videos·cogvideox-3:text→video- Hvilke felter bruger anmodningen?
POST /v1/videos·cogvideox-3:model,prompt,quality,with_audio,size,fps,duration