Zhipu AI: CogVideoX 3
CogVideoX 3 vytváří video z textu, obrázku nebo dvojice prvního a posledního snímku v dokumentovaném postupu výrobce. Podporuje pětisekundové nebo desetisekundové sekvence, několik výstupních velikostí až do 4K, 30 nebo 60 fps a volitelné generované zvukové efekty.
O modelu
Tento popis zahrnuje schopnosti modelu. Vstupy, výstupy a možnosti dostupné v Ailoot jsou uvedeny níže pro vybranou metodu.
CogVideoX 3 je videomodel Zhipu AI s dokumentovaným generováním text–video, obrázek–video a z prvního a posledního snímku. Výrobce zdůrazňuje stabilitu snímků, dodržování pokynů a realistické nebo trojrozměrné vizuální styly. Zvolte text, pokud scéna začíná jako písemné zadání, jeden obrázek, pokud již existuje její vizuální základ, nebo dva krajní obrázky, pokud sekvence potřebuje definovaný úvodní a závěrečný pohled.
V textovém zadání popište hlavní objekt a jednu srozumitelnou akci. Uveďte prostředí, pohled a důležité fyzické vztahy, aby bylo možné scénu posoudit vůči jasnému záměru. Postava zvedající předmět potřebuje jinou sekvenci než kamera odhalující tento předmět. Obojí popisujte jen tehdy, pokud je jejich vztah pro záběr důležitý.
U sekvence založené na obrázku připravte referenci tak, aby byly viditelné rozlišující vlastnosti hlavního objektu. Výrobce přijímá obrázky PNG, JPEG a JPG nejvýše 5 MB dodané prostřednictvím URL nebo kódovaných obrazových dat. Uchovejte skutečnou referenci s generovaným výsledkem, aby bylo možné vzhled a zarámování porovnat se zdrojem, nikoli se zapamatovanou verzí.
Režim krajních snímků výrobce přijímá dva obrázky v pořadí: první určuje úvodní snímek a druhý závěrečný snímek. Připravte je jako dva zamýšlené stavy jednoho záběru. Popište přechod nebo akci, které je propojují, a poté zkontrolujte soudržnost hlavního objektu mezi oběma konci. Dvojice dobrých statických obrázků sama neukazuje, že pohyb mezi nimi odpovídá požadovanému příběhu.
Prompt může obsahovat až 512 znaků. Využijte dostupný text pro akci, její směr a vizuální detaily odlišující úspěšný výsledek. Zadání zaměřte na to, co se má stát na obrazovce. Pokud vstupní obrázky již určují vzhled hlavního objektu, popište pohyb a časování, které se mají rozvinout mezi nimi nebo z nich.
Výrobce dokumentuje pětisekundový nebo desetisekundový výstup s výchozími pěti sekundami a 30 nebo 60 snímky za sekundu. Podporované velikosti zahrnují 1280×720, 720×1280, 1024×1024, 1920×1080, 1080×1920, 2048×1080 a 3840×2160. Vyberte velikost a časování pro cílové použití a poté prohlédněte dokončený klip z hlediska zarámování a tempa skutečné akce.
Režimy kvality a rychlosti jsou dokumentovány odděleně od volitelného nastavení zvukových efektů AI. Uchovejte tyto volby s promptem, obrázky a výsledkem. Vizuální a vstupní schopnosti výrobce popisují model; dostupné ovládací prvky konkrétní generovací metody poskytuje kontrakt této metody. Při porovnávání kandidátních záběrů zachovejte skutečně použitá nastavení.
Zachovejte původní identitu úlohy do dokončení videa a uložte vrácený materiál pro střih. Zkontrolujte celou sekvenci včetně vzhledu hlavního objektu při výrazném pohybu, interakcí s předměty ve scéně a konečné kompozice. U práce s krajními snímky prohlédněte oba konce i přechod mezi nimi. Upravte konkrétní vizuální nesoulad při zachování úspěšných referencí a plánu záběru a porovnávejte dokončená videa, nikoli jen jejich náhledové obrázky.
Ailoot Ultra · Tvorba videa POST /v1/videos cogvideox-3
cogvideox-3Úvod
CogVideoX 3 vytváří video z textu, obrázku nebo dvojice prvního a posledního snímku v dokumentovaném postupu výrobce. Podporuje pětisekundové nebo desetisekundové sekvence, několik výstupních velikostí až do 4K, 30 nebo 60 fps a volitelné generované zvukové efekty.
- 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-3 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.3 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.3 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-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
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-3
Aliasy cest metod
/v1/videos/generations
Související ID modelů
FAQ · Zhipu AI: CogVideoX 3
- Jaké vstupy a výsledky jsou dostupné?
POST /v1/videos·cogvideox-3:text→video- Jaká pole požadavek používá?
POST /v1/videos·cogvideox-3:model,prompt,quality,with_audio,size,fps,duration