Zhipu AI: CogVideoX 2
CogVideoX 2 ustvarja video iz besedilnega opisa ali priložene slike. Proizvajalec dokumentira izbirne velikosti sličic, 30 ali 60 fps, način kakovosti ali hitrosti ter izbirne ustvarjene zvočne učinke za oblikovanje kratkega vizualnega prizora.
O modelu
Ta opis zajema zmožnosti modela. Vhodi, izhodi in možnosti, ki so na voljo v Ailoot, so spodaj navedeni za izbrano metodo.
CogVideoX 2 je model Zhipu AI za ustvarjanje videa iz pisnega opisa prizora ali priložene slike. Besedilo določi subjekt, okolje in dogajanje; slika lahko zagotovi vizualno osnovo ustvarjenega zaporedja. Uporabite vhod, ki najbolje predstavlja gradivo, že na voljo za posnetek, nato opišite vidno gibanje, ki ga mora vsebovati dokončani video.
Pri ustvarjanju iz besedila določite en skladen dogodek. Človek, ki odpira vrata delavnice, majhen čoln, ki pluje mimo pomola, ali predmet, ki se obrača pri stalni osvetlitvi, dajo posnetku jasen namen. Navedite pomembne značilnosti subjekta, zorni kot in smer gibanja. Izberite konec, uporaben v predvideni montaži, namesto da končno kompozicijo prizora pustite nedoločeno.
Pri ustvarjanju iz slike pripravite jasen pogled na subjekt in opišite, kako naj se prizor premakne iz tega izhodišča. Proizvajalec sprejema reference PNG, JPEG in JPG do 5 MB, posredovane prek URL-ja slike ali kodiranih slikovnih podatkov. V referenci ohranite vidne pomembne robove, obrazne poteze in podrobnosti predmetov ter v kompoziciji pustite prostor za zahtevano dogajanje.
Proizvajalec omejuje pisni poziv na 512 znakov. Ta prostor namenite odločilnim podrobnostim: subjektu, dogajanju, okolju in zornemu kotu. Kratek opis, ki pojasni, kateri predmet se premika in kaj ostaja pri miru, je lažje oceniti kot seznam splošnih pridevnikov o slogu. Če rezultat ne doseže cilja, popravite navodilo, povezano z opaženo težavo pri gibanju ali kadriranju.
Objavljene izhodne velikosti vključujejo kvadratne, ležeče in pokončne formate, z možnostmi od 720×480 do 3840×2160 slikovnih pik. Proizvajalec dokumentira tudi 30 ali 60 sličic na sekundo. Pred ustvarjanjem izberite obliko in hitrost sličic za predvideno uporabo, nato v dejanskem posnetku preverite, ali subjekt in njegove pomembne podrobnosti ostanejo razločni v tem kadru.
Kakovost in hitrost sta poimenovana izhodna načina v proizvajalčevem postopku. Izbirni zvočni učinki, ustvarjeni z UI, se upravljajo ločeno od vizualnega opisa. Izbrani način in nastavitev zvočnih učinkov shranite s pozivom in morebitno referenčno sliko, da lahko različice posnetkov primerjate po dejanskih nastavitvah ustvarjanja.
Ustvarjanje je asinhrono: identifikator opravila se vrne, preden je dokončani video na voljo. Ohranite ga med preverjanjem rezultata in shranite vse dokončane videodatoteke, povezane z operacijo. Za montažo shranite sam posnetek skupaj z izvorno sliko, kadar jo uporabite, namesto da bi bili odvisni od začasne lokacije rezultata ali predogledne sličice.
Celotno zaporedje preglejte z vidika kontinuitete, časovnega poteka in zahtevanega dogajanja. Posnetek izdelka potrebuje stabilno obliko in podrobnosti materiala med gibanjem; posnetek lika potrebuje skladen videz in kretnje. Končno kompozicijo in morebitni ustvarjeni zvok presodite glede na namen posnetka. Pri popravljanju konkretnega neskladja ohranite uspešne elemente prizora ter prvotni in popravljeni video primerjajte v enakih pogojih gledanja.
Ailoot Ultra · Videoposnetki POST /v1/videos cogvideox-2
cogvideox-2Začetek
CogVideoX 2 ustvarja video iz besedilnega opisa ali priložene slike. Proizvajalec dokumentira izbirne velikosti sličic, 30 ali 60 fps, način kakovosti ali hitrosti ter izbirne ustvarjene zvočne učinke za oblikovanje kratkega vizualnega prizora.
- Dovoljeni vhodi
- Besedilo
- Rezultati
- Video
Na voljo v Ailoot · vhodi in metode
Ailoot Ultra · Videoposnetki POST /v1/videos
- Vhod
text- Izhod
video
| Polje | Vrsta | Zahteva | Vrednosti in omejitve | Privzeto |
|---|---|---|---|---|
Poljemodel | Vrstastring | ZahtevaObvezno | Vrednosti in omejitve cogvideox-2 Pogoji: Uporabite natančen izbirnik modela Ailoot. | Privzeto— |
Poljeprompt | Vrstastring | ZahtevaObvezno | Vrednosti in omejitve Pogoji: Opišite prizor in gibanje. | Privzeto— |
Poljequality | Vrstaboolean | ZahtevaIzbirno | Vrednosti in omejitve Pogoji: Neobvezna oznaka kakovosti; ta izbrana shema ne določa združljivega enum ali privzete vrednosti. | Privzeto— |
Poljewith_audio | Vrstaboolean | ZahtevaIzbirno | Vrednosti in omejitve Pogoji: Ko je omogočeno, ustvarite zvočne učinke AI. | Privzetofalse |
Poljesize | Vrstastring | ZahtevaIzbirno | Vrednosti in omejitve Pogoji: Pri izbiri izrecnih mer podajte dokumentirani niz size. | Privzeto— |
Poljefps | Vrstastring | ZahtevaIzbirno | Vrednosti in omejitve 30, 60 Pogoji: Hitrost sličic je pri tej izbrani izvorni metodi predstavljena kot niz. | Privzeto30 |
Poljeduration | Vrstastring | ZahtevaIzbirno | Vrednosti in omejitve 5, 10 Pogoji: Trajanje v sekundah je pri tej izbrani izvorni metodi predstavljeno kot niz. | Privzeto5 |
Parametri in življenjski cikel metode
| Parameter | Specifikacija |
|---|---|
Parametercontent_type | Specifikacijaapplication/json |
Parameterrequired | Specifikacijamodel, prompt |
Parameteroptional | Specifikacijaquality, with_audio, size, fps, duration |
Parametermaterial_types | Specifikacijatext |
Parameterconditions | SpecifikacijaUporabite natančen izbirnik modela Ailoot., Opišite prizor in gibanje., Neobvezna oznaka kakovosti; ta izbrana shema ne določa združljivega enum ali privzete vrednosti., Ko je omogočeno, ustvarite zvočne učinke AI., Pri izbiri izrecnih mer podajte dokumentirani niz size., Hitrost sličic je pri tej izbrani izvorni metodi predstavljena kot niz., Trajanje v sekundah je pri tej izbrani izvorni metodi predstavljeno kot niz. |
Druga imena metode: /v1/videos/generations
Življenjski cikel: 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}
Cenik
Kako se izračuna končni strošek
Prikazane cene so namenjene oceni stroškov pred generiranjem. Končni znesek se izračuna na podlagi stroška, zabeleženega za izvirno generiranje. Izmerjeno trajanje izhoda in napovedane količine niso končna obračunska količina.
Tarifni podatki ne dodajajo možnosti zahteve. Podprti parametri so navedeni pri izbrani metodi.
- Hitri način
- Ni navedeno Ko je izbran hitri način
- Način flex
- Ni navedeno Ko je izbran način flex
- Najvišja raven razmišljanja
- Ni navedeno Ko najvišja raven razmišljanja uporablja privzeto prilagoditev (default)
Ocenjene cene za primerjavo
Cene po nastavitvah
Vsak strošek povežite s prikazanimi pogoji. Za vsak nabor alternativnih nastavitev uporabite eno ceno.
| Nastavitev | Cenovna lestvica | Predvidena količina | Obračunska količina | Strošek |
|---|---|---|---|---|
| NastavitevOsnovne cene žetonov | Cenovna lestvicaOsnovna cena | Predvidena količina— | Obračunska količina— | Strošek Vhod · Vhodni žetoni · Ocena samo za primerjavo — / 1K žetonov Izhod · Izhodni žetoni · Ocena samo za primerjavo — / 1K žetonov Vhod · Branje predpomnilnika · Ocena samo za primerjavo — / 1K žetonov Vhod · Zapis v predpomnilnik · Ocena samo za primerjavo — / 1K žetonov Vhod · Zapis v predpomnilnik, 1 ura · Ocena samo za primerjavo — / 1K žetonov |
| NastavitevNa zahtevo | Cenovna lestvica— | Predvidena količina— | Obračunska količinaena zahteva | Strošek Vhod · Ocena samo za primerjavo $0.2 na zahtevo |
| NastavitevOcenjeni strošek ustvarjanja | Cenovna lestvica— | Predvidena količinaocena za eno generiranje | Obračunska količina— | Strošek Izhod · Ocenjeni stroški ustvarjanja · Ocena samo za primerjavo $0.2 ocena pred ustvarjanjem Ta ocena ni dodatno plačilo ali fiksna cena za dokončano generiranje. |
Ailoot pred zahtevo rezervira ocenjeni znesek. Po rezultatu obračuna končni strošek na podlagi izmerjene porabe. Obračun pretakanja uporablja končni zapis porabe. Kako delujeta rezervacija in obračun →
Primeri zahtev
Ailoot Ultra · Videoposnetki
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
Prejmi in shrani rezultate
Ailoot Ultra · Videoposnetki
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}
Ohrani vse dokončane rezultate
Shranite vsak dokončan video ali vrnjeno datoteko; pridobite vsebino z vsake dejansko vrnjene URL gradiva.
Ohranite celoten odgovor in glave, prvotne identifikatorje, vsak dejanski izhod in vsa polja porabe/obračuna. Shranite vsako enolično sredstvo v vaši lasti in ohranite vsako vlogo, ki kaže nanj.
Če je treba preveriti izvirni odgovor
Ohranite vrnjeni javni id opravila ali operacije in vse glave. Berite samo prvotno opravilo; unknown ali result_pending_check ne dovoljujeta novega ustvarjanja.
Polja odgovora
| Polje | Vrsta |
|---|---|
Poljeid | Vrstastring |
Poljepolling_url | Vrstastring |
Poljeprovider_task_id | Vrstastring |
Poljeid | Vrstastring |
Poljetask_status | Vrstastring |
Poljevideo_result[].url | Vrstastring |
Druga imena
Druga imena modelov
Ailoot Ultra cogvideox-2
Druga imena poti metod
/v1/videos/generations
Povezani ID-ji za klic
FAQ · Zhipu AI: CogVideoX 2
- Kateri vhodi in rezultati so na voljo?
POST /v1/videos·cogvideox-2:text→video- Katera polja uporablja zahteva?
POST /v1/videos·cogvideox-2:model,prompt,quality,with_audio,size,fps,duration