Zhipu AI: CogVideoX 2
CogVideoX 2 generuje video z textového popisu nebo dodaného obrázku. Výrobce dokumentuje volitelné velikosti snímků, 30 nebo 60 fps, režimy kvality či rychlosti a volitelné generované zvukové efekty pro utváření krátké vizuální scény.
O modelu
Tento popis zahrnuje schopnosti modelu. Vstupy, výstupy a možnosti dostupné v Ailoot jsou uvedeny níže pro vybranou metodu.
CogVideoX 2 je model Zhipu AI pro generování videa z písemného popisu scény nebo dodaného obrázku. Text určuje hlavní objekt, prostředí a děj; obrázek může poskytnout vizuální základ generované sekvence. Použijte vstup nejlépe vyjadřující materiál, který již máte pro záběr, a poté popište viditelný pohyb v dokončeném videu.
Při tvorbě z textu definujte jednu soudržnou událost. Člověk otevírající dveře dílny, malá loď plující kolem mola nebo předmět otáčející se při stálém světle dávají záběru srozumitelný účel. Uveďte důležité vlastnosti hlavního objektu, pohled a směr pohybu. Zvolte zakončení použitelné v zamýšleném střihu, místo ponechání neurčené konečné kompozice scény.
Při tvorbě z obrázku připravte jasný pohled na hlavní objekt a popište, jak se z něj má scéna pohybově rozvinout. Výrobce přijímá reference PNG, JPEG a JPG do 5 MB dodané pomocí URL obrázku nebo kódovaných obrazových dat. Ponechte v referenci viditelné důležité hrany, rysy obličeje a detaily objektu a v kompozici ponechte prostor pro požadovanou akci.
Výrobce omezuje písemný prompt na 512 znaků. Využijte prostor pro rozhodující detaily: hlavní objekt, akci, prostředí a pohled. Krátký popis vysvětlující, který objekt se pohybuje a co zůstává nehybné, se posuzuje snáze než seznam obecných stylových přídavných jmen. Pokud výsledek míjí cíl, upravte pokyn vztahující se k pozorovanému problému pohybu nebo zarámování.
Zveřejněné výstupní velikosti zahrnují čtvercové, vodorovné a svislé formáty s volbami od 720×480 do 3840×2160 pixelů. Výrobce také dokumentuje 30 nebo 60 snímků za sekundu. Před generováním vyberte tvar a snímkovou frekvenci pro cílové použití a poté prohlédněte skutečný klip, zda hlavní objekt a důležité detaily zůstávají v tomto zarámování čitelné.
Kvalita a rychlost jsou pojmenované výstupní režimy v postupu výrobce. Volitelné zvukové efekty generované AI se ovládají odděleně od vizuálního zadání. Uchovejte vybraný režim a nastavení zvukových efektů s promptem a případným referenčním obrázkem, aby bylo možné kandidátní klipy porovnávat podle skutečných nastavení generování.
Generování je asynchronní: identita úlohy se vrací dříve, než je hotové video dostupné. Zachovejte tuto identitu při kontrole výsledku a uchovejte všechny dokončené videosoubory související s operací. Pro střih uložte samotný klip spolu se zdrojovým obrázkem, pokud byl použit, místo spoléhání na dočasné umístění výsledku nebo náhledový snímek.
Zkontrolujte celou sekvenci z hlediska návaznosti, časování a požadované akce. Produktový záběr potřebuje během pohybu stabilní tvar a detaily materiálu; záběr postavy potřebuje soudržný vzhled a gesta. Posuďte konečnou kompozici a případný generovaný zvuk vůči účelu záběru. Při revizi konkrétního nesouladu zachovejte úspěšné prvky scény a používejte stejné podmínky sledování pro porovnání původních a upravených videí.
Ailoot Ultra · Tvorba videa POST /v1/videos cogvideox-2
cogvideox-2Úvod
CogVideoX 2 generuje video z textového popisu nebo dodaného obrázku. Výrobce dokumentuje volitelné velikosti snímků, 30 nebo 60 fps, režimy kvality či rychlosti a volitelné generované zvukové efekty pro utváření krátké vizuální scény.
- Přijímané vstupy
- Text
- Výsledky
- Video
Dostupné v Ailoot · vstupy a metody
Ailoot Ultra · Tvorba videa POST /v1/videos
- Vstup
text- Výstup
video
| Pole | Typ | Požadavek | Hodnoty a limity | Výchozí |
|---|---|---|---|---|
Polemodel | Typstring | PožadavekPovinné | Hodnoty a limity cogvideox-2 Podmínky: Použijte přesný identifikátor modelu Ailoot. | Výchozí— |
Poleprompt | Typstring | PožadavekPovinné | Hodnoty a limity Podmínky: Popište scénu a pohyb. | Výchozí— |
Polequality | Typboolean | PožadavekVolitelné | Hodnoty a limity Podmínky: Volitelný příznak kvality; toto vybrané schéma neposkytuje kompatibilní výčet ani výchozí hodnotu. | Výchozí— |
Polewith_audio | Typboolean | PožadavekVolitelné | Hodnoty a limity Podmínky: Je-li zapnuto, generuje zvukové efekty pomocí AI. | Výchozífalse |
Polesize | Typstring | PožadavekVolitelné | Hodnoty a limity Podmínky: Při výběru konkrétních rozměrů zadejte dokumentovaný řetězec velikosti. | Výchozí— |
Polefps | Typstring | PožadavekVolitelné | Hodnoty a limity 30, 60 Podmínky: U této zvolené nativní metody se snímková frekvence zadává jako řetězec. | Výchozí30 |
Poleduration | Typstring | PožadavekVolitelné | Hodnoty a limity 5, 10 Podmínky: U této zvolené nativní metody se délka v sekundách zadává jako řetězec. | Výchozí5 |
Parametry a životní cyklus metody
| Parametr | Kontrakt |
|---|---|
Parametrcontent_type | Kontraktapplication/json |
Parametrrequired | Kontraktmodel, prompt |
Parametroptional | Kontraktquality, with_audio, size, fps, duration |
Parametrmaterial_types | Kontrakttext |
Parametrconditions | KontraktPoužijte přesný identifikátor modelu Ailoot., Popište scénu a pohyb., Volitelný příznak kvality; toto vybrané schéma neposkytuje kompatibilní výčet ani výchozí hodnotu., Je-li zapnuto, generuje zvukové efekty pomocí AI., Při výběru konkrétních rozměrů zadejte dokumentovaný řetězec velikosti., U této zvolené nativní metody se snímková frekvence zadává jako řetězec., U této zvolené nativní metody se délka v sekundách zadává jako řetězec. |
Aliasy metody: /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}
Tarify
Jak se vypočítá konečný poplatek
Zobrazené sazby slouží k odhadu ceny před generováním. Konečný poplatek se vypočítá z nákladů zaznamenaných u původního generování. Naměřená délka výstupu ani odhadovaná množství nejsou konečným účtovaným množstvím.
Údaje o tarifech nepřidávají možnosti požadavku. Podporované parametry jsou uvedeny u vybrané metody.
- Rychlý režim
- Neuvedeno Při výběru rychlého režimu
- Režim flex
- Neuvedeno Při výběru režimu flex
- Maximální intenzita uvažování
- Neuvedeno Když se při maximální intenzitě uvažování použije výchozí úprava (default)
Odhadované sazby pro srovnání
Ceny podle konfigurace
Přiřaďte každý poplatek k uvedeným podmínkám. Pro každou sadu alternativních konfigurací použijte jednu sazbu.
| Konfigurace | Tabulka sazeb | Předpokládané množství | Množství pro účtování | Poplatek |
|---|---|---|---|---|
| KonfiguraceZákladní sazby za tokeny | Tabulka sazebZákladní sazba | Předpokládané množství— | Množství pro účtování— | Poplatek Vstup · Vstupní tokeny · Odhad pouze pro srovnání — / 1K tokenů Výstup · Výstupní tokeny · Odhad pouze pro srovnání — / 1K tokenů Vstup · Čtení z mezipaměti · Odhad pouze pro srovnání — / 1K tokenů Vstup · Zápis do mezipaměti · Odhad pouze pro srovnání — / 1K tokenů Vstup · Zápis do mezipaměti, 1 hodina · Odhad pouze pro srovnání — / 1K tokenů |
| KonfiguraceZa požadavek | Tabulka sazeb— | Předpokládané množství— | Množství pro účtováníjeden požadavek | Poplatek Vstup · Odhad pouze pro srovnání $0.2 za požadavek |
| KonfiguraceOdhadovaná cena generování | Tabulka sazeb— | Předpokládané množstvíodhad pro jedno generování | Množství pro účtování— | Poplatek Výstup · Odhadovaná cena generování · Odhad pouze pro srovnání $0.2 odhad před generováním Tento odhad není dodatečným poplatkem ani pevnou sazbou za dokončené generování. |
Ailoot před požadavkem rezervuje odhadovanou částku. Po výsledku vyúčtuje konečný poplatek podle naměřeného využití. Při streamování se účtování řídí konečným záznamem využití. Jak funguje rezervace a vyúčtování →
Příklady požadavků
Ailoot Ultra · Tvorba 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
Přijímání a ukládání výsledků
Ailoot Ultra · Tvorba 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}
Uchovejte všechny dokončené výsledky
Uložte každé dokončené video či vrácený soubor; stáhněte obsah každé skutečně vrácené URL souboru.
Uchovejte celou odpověď a hlavičky, původní identifikátory, každý skutečný výstup a všechna pole využití a účtování. Uložte každý jedinečný soubor spravovaný službou a zachovejte každou roli, která na něj odkazuje.
Pokud je nutné ověřit původní odpověď
Uchovejte vrácené veřejné id úlohy nebo operace a všechny hlavičky. Načítejte pouze původní úlohu; unknown ani result_pending_check neopravňují k dalšímu vytvoření.
Pole odpovědi
| Pole | Typ |
|---|---|
Poleid | Typstring |
Polepolling_url | Typstring |
Poleprovider_task_id | Typstring |
Poleid | Typstring |
Poletask_status | Typstring |
Polevideo_result[].url | Typstring |
Aliasy
Aliasy modelu
Ailoot Ultra cogvideox-2
Aliasy cest metod
/v1/videos/generations
Související ID modelů
FAQ · Zhipu AI: CogVideoX 2
- Jaké vstupy a výsledky jsou dostupné?
POST /v1/videos·cogvideox-2:text→video- Jaká pole požadavek používá?
POST /v1/videos·cogvideox-2:model,prompt,quality,with_audio,size,fps,duration