Zhipu AI: CogVideoX 2
CogVideoX 2 vytvára video z textového opisu alebo dodaného obrázka. Výrobca dokumentuje voliteľné rozmery snímok, 30 alebo 60 fps, režim kvality či rýchlosti a voliteľné generované zvukové efekty na vytvorenie krátkej vizuálnej scény.
O modeli
Tento opis pokrýva možnosti modelu. Dostupné vstupy, výstupy a voľby v Ailoot sú uvedené nižšie pre vybranú metódu.
CogVideoX 2 je model Zhipu AI na generovanie videa z písomného opisu scény alebo dodaného obrázka. Text určuje subjekt, prostredie a dej; obrázok môže poskytnúť vizuálny základ generovanej sekvencie. Použite vstup, ktorý najlepšie vystihuje materiál už dostupný pre záber, a potom opíšte viditeľný pohyb, ktorý má hotové video obsahovať.
Pri tvorbe z textu definujte jeden ucelený dej. Človek otvárajúci dvere dielne, malý čln plávajúci popri móle alebo predmet otáčajúci sa pri stálom osvetlení dávajú záberu zrozumiteľný účel. Uveďte dôležité črty subjektu, uhol pohľadu a smer pohybu. Zvoľte zakončenie použiteľné v zamýšľanom strihu namiesto toho, aby ste konečnú kompozíciu scény nechali neurčenú.
Pri tvorbe z obrázka pripravte jasný pohľad na subjekt a opíšte, ako sa má scéna od tohto východiska pohybovať. Výrobca prijíma referencie PNG, JPEG a JPG do 5 MB, dodané prostredníctvom URL obrázka alebo zakódovaných obrazových dát. V referencii zachovajte viditeľné dôležité obrysy, črty tváre a detaily predmetov a v kompozícii ponechajte priestor na požadovaný dej.
Výrobca obmedzuje písomný prompt na 512 znakov. Tento priestor využite na rozhodujúce detaily: subjekt, dej, prostredie a uhol pohľadu. Krátky opis vysvetľujúci, ktorý predmet sa pohybuje a čo zostáva nehybné, sa hodnotí ľahšie než zoznam všeobecných prídavných mien opisujúcich štýl. Ak výsledok nespĺňa cieľ, upravte pokyn súvisiaci s pozorovaným problémom pohybu alebo kompozície záberu.
Zverejnené výstupné rozmery zahŕňajú štvorcové formáty aj formáty na šírku a na výšku, s možnosťami od 720×480 do 3840×2160 pixelov. Výrobca dokumentuje aj 30 alebo 60 snímok za sekundu. Pred generovaním vyberte tvar a snímkovú frekvenciu podľa miesta použitia a potom v skutočnom klipe skontrolujte, či subjekt a jeho dôležité detaily zostávajú v tejto kompozícii čitateľné.
Kvalita a rýchlosť sú pomenované výstupné režimy v postupe výrobcu. Voliteľné zvukové efekty generované AI sa riadia oddelene od vizuálneho zadania. Vybraný režim a nastavenie zvukových efektov uchovajte spolu s promptom a prípadným referenčným obrázkom, aby sa kandidátne klipy dali porovnávať podľa skutočných nastavení generovania.
Generovanie je asynchrónne: identifikátor úlohy sa vráti skôr, než je hotové video dostupné. Uchovajte ho počas kontroly výsledku a zachovajte všetky dokončené videosúbory priradené k operácii. Na strih uložte samotný klip spolu so zdrojovým obrázkom, ak bol použitý; nespoliehajte sa len na dočasné umiestnenie výsledku alebo náhľadovú snímku.
Skontrolujte celú sekvenciu z hľadiska kontinuity, načasovania a požadovaného deja. Produktový záber potrebuje stabilný tvar a detaily materiálu počas pohybu; záber postavy potrebuje súvislý vzhľad a gestá. Konečnú kompozíciu a prípadný generovaný zvuk posúďte podľa účelu záberu. Pri úprave konkrétneho nesúladu zachovajte vydarené prvky scény a pôvodné aj upravené video porovnávajte za rovnakých podmienok sledovania.
Ailoot Ultra · Generovanie videa POST /v1/videos cogvideox-2
cogvideox-2Úvod
CogVideoX 2 vytvára video z textového opisu alebo dodaného obrázka. Výrobca dokumentuje voliteľné rozmery snímok, 30 alebo 60 fps, režim kvality či rýchlosti a voliteľné generované zvukové efekty na vytvorenie krátkej vizuálnej scény.
- Povolené vstupy
- Text
- Výsledky
- Video
Dostupné v Ailoot · vstupy a metódy
Ailoot Ultra · Generovanie videa POST /v1/videos
- Vstup
text- Výstup
video
| Pole | Typ | Požiadavka | Hodnoty a limity | Predvolené |
|---|---|---|---|---|
Polemodel | Typstring | PožiadavkaPovinné | Hodnoty a limity cogvideox-2 Podmienky: Použite presný volič modelu Ailoot. | Predvolené— |
Poleprompt | Typstring | PožiadavkaPovinné | Hodnoty a limity Podmienky: Opíšte scénu a pohyb. | Predvolené— |
Polequality | Typboolean | PožiadavkaVoliteľné | Hodnoty a limity Podmienky: Voliteľný príznak kvality; táto vybraná schéma neposkytuje kompatibilný enum ani predvolenú hodnotu. | Predvolené— |
Polewith_audio | Typboolean | PožiadavkaVoliteľné | Hodnoty a limity Podmienky: Keď je zapnuté, generuje zvukové efekty pomocou AI. | Predvolenéfalse |
Polesize | Typstring | PožiadavkaVoliteľné | Hodnoty a limity Podmienky: Pri výbere explicitných rozmerov zadajte zdokumentovaný reťazec size. | Predvolené— |
Polefps | Typstring | PožiadavkaVoliteľné | Hodnoty a limity 30, 60 Podmienky: Snímková frekvencia je pri tejto vybranej natívnej metóde vyjadrená reťazcom. | Predvolené30 |
Poleduration | Typstring | PožiadavkaVoliteľné | Hodnoty a limity 5, 10 Podmienky: Dĺžka v sekundách je pri tejto vybranej natívnej metóde vyjadrená reťazcom. | Predvolené5 |
Parametre a životný cyklus metódy
| Parameter | Špecifikácia |
|---|---|
Parametercontent_type | Špecifikáciaapplication/json |
Parameterrequired | Špecifikáciamodel, prompt |
Parameteroptional | Špecifikáciaquality, with_audio, size, fps, duration |
Parametermaterial_types | Špecifikáciatext |
Parameterconditions | ŠpecifikáciaPoužite presný volič modelu Ailoot., Opíšte scénu a pohyb., Voliteľný príznak kvality; táto vybraná schéma neposkytuje kompatibilný enum ani predvolenú hodnotu., Keď je zapnuté, generuje zvukové efekty pomocou AI., Pri výbere explicitných rozmerov zadajte zdokumentovaný reťazec size., Snímková frekvencia je pri tejto vybranej natívnej metóde vyjadrená reťazcom., Dĺžka v sekundách je pri tejto vybranej natívnej metóde vyjadrená reťazcom. |
Aliasy metódy: /v1/videos/generations
Životný cyklus: 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}
Cenník
Ako sa vypočíta konečný poplatok
Zobrazené sadzby slúžia na odhad nákladov pred generovaním. Konečný poplatok sa vypočíta z nákladov zaznamenaných pri pôvodnom generovaní. Namerané trvanie výstupu a predpokladané množstvá nepredstavujú konečné účtované množstvo.
Tarifné údaje nepridávajú možnosti požiadavky. Podporované parametre sú uvedené pri vybranej metóde.
- Rýchly režim
- Neuvedené Keď je zvolený rýchly režim
- Režim Flex
- Neuvedené Keď je zvolený režim flex
- Maximálna úroveň uvažovania
- Neuvedené Keď sa pri maximálnej úrovni uvažovania používa predvolená úprava (default)
Odhadované sadzby na porovnanie
Ceny podľa konfigurácie
Každý poplatok priraďte k zobrazeným podmienkam. Pre každú skupinu alternatívnych konfigurácií použite jednu sadzbu.
| Konfigurácia | Sadzobník | Odhadované množstvo | Účtovacie množstvo | Poplatok |
|---|---|---|---|---|
| KonfiguráciaZákladné sadzby za tokeny | SadzobníkZákladná sadzba | Odhadované množstvo— | Účtovacie množstvo— | Poplatok Vstup · Vstupné tokeny · Odhad iba na porovnanie — / 1K tokenov Výstup · Výstupné tokeny · Odhad iba na porovnanie — / 1K tokenov Vstup · Čítanie cache · Odhad iba na porovnanie — / 1K tokenov Vstup · Zápis do cache · Odhad iba na porovnanie — / 1K tokenov Vstup · Zápis do cache, 1 hod · Odhad iba na porovnanie — / 1K tokenov |
| KonfiguráciaZa požiadavku | Sadzobník— | Odhadované množstvo— | Účtovacie množstvojedna požiadavka | Poplatok Vstup · Odhad iba na porovnanie $0.2 za požiadavku |
| KonfiguráciaOdhadované náklady na generovanie | Sadzobník— | Odhadované množstvoodhad pre jedno generovanie | Účtovacie množstvo— | Poplatok Výstup · Odhadované náklady na generovanie · Odhad iba na porovnanie $0.2 odhad pred generovaním Tento odhad nepredstavuje dodatočný poplatok ani pevnú sadzbu za dokončené generovanie. |
Ailoot pred požiadavkou rezervuje odhadovanú sumu. Po získaní výsledku vyúčtuje konečný poplatok podľa nameraného využitia. Pri streamovaní sa vyúčtovanie riadi konečným záznamom využitia. Ako funguje rezervácia a vyúčtovanie →
Príklady požiadaviek
Ailoot Ultra · Generovanie videa
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
Prijať a uložiť výsledky
Ailoot Ultra · Generovanie videa
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}
Uchovať všetky dokončené výsledky
Uložte každé dokončené video alebo vrátený súbor; načítajte obsah každej skutočne vrátenej URL podkladu.
Zachovajte celú odpoveď a hlavičky, pôvodné identifikátory, každý skutočný výstup a všetky polia spotreby a účtovania. Uložte každý jedinečný súbor vo vašom vlastníctve a zachovajte každú rolu, ktorá naň odkazuje.
Ak treba overiť pôvodnú odpoveď
Zachovajte vrátené verejné id úlohy alebo operácie a všetky hlavičky. Načítavajte iba pôvodnú úlohu; unknown ani result_pending_check neoprávňujú na ďalšie vytvorenie.
Polia odpovede
| Pole | Typ |
|---|---|
Poleid | Typstring |
Polepolling_url | Typstring |
Poleprovider_task_id | Typstring |
Poleid | Typstring |
Poletask_status | Typstring |
Polevideo_result[].url | Typstring |
Aliasy
Aliasy modelov
Ailoot Ultra cogvideox-2
Aliasy ciest metód
/v1/videos/generations
Súvisiace ID na volanie
FAQ · Zhipu AI: CogVideoX 2
- Aké vstupy a výsledky sú dostupné?
POST /v1/videos·cogvideox-2:text→video- Aké polia používa požiadavka?
POST /v1/videos·cogvideox-2:model,prompt,quality,with_audio,size,fps,duration