Alibaba: Wan 2.7
Alibaba Wan 2.7 vytváří videa se zvukem z textu, úvodního a závěrečného obrázku nebo vizuálních referencí. Jeho obrazový postup také pokračuje ve zdrojovém klipu s použitím požadované celkové délky. Výrobce uvádí 720p či 1080p MP4 při 30 snímcích za sekundu: 2–15 sekund pro textové/obrazové režimy a až 10 sekund pro generování podle referencí.
O modelu
Tento popis zahrnuje schopnosti modelu. Vstupy, výstupy a možnosti dostupné v Ailoot jsou uvedeny níže pro vybranou metodu.
Alibaba Wan 2.7 je rodina modelů generování videa s pojmenovanými profily pro tvorbu z textu, z obrázku a pomocí referencí. Výrobce dokumentuje scény se synchronizovaným zvukem a příběhy s více záběry; obrazový postup přidává generování z prvního a posledního snímku a pokračování úvodního videa. Užitečným výsledkem je krátký klip se zvukem, například produktový přechod, kompaktní příběh nebo pokračování navazující na existující záběr. Režim zvolte podle zdrojového materiálu a požadované kontroly nad začátkem či koncem.
Pro tvorbu videa z textu popište objekt, prostředí, děj, kameru, styl a zvuk. Storyboard může určit každý záběr a časový rozsah; zadání jediného záběru má uvést, že děj zůstává nepřerušený. Příručka promptů Wan 2.7 nechává model interpretovat strukturu záběrů z písemného zadání místo použití ovládání shot_type z verze 2.6. Současné textové API přijímá čínské nebo anglické prompty do 5 000 znaků se samostatným negativním promptem do 500 znaků; nadbytečný text se ořízne. V rámci tohoto limitu jasně uveďte zásadní děj a omezení.
Tvorba videa z prvního snímku animuje dodaný úvodní obrázek. Generování z prvního a posledního snímku určuje také konečný stav a pohyb, který je spojuje. Obrazová příručka 2.7 vedle těchto kombinací snímků podporuje řídicí zvukový zdroj. Připravte krajní snímky se společnou scénou a zamýšleným objektem a popište přechod místo žádosti, aby model oba obrázky reinterpretoval jako nesouvisející stylové reference. Výstup přibližně odpovídá poměrům prvního obrázku; příručka chápe rozlišení jako úroveň počtu pixelů a odpovídajícím způsobem zaokrouhluje kódované rozměry.
Pokračování videa začíná zdrojovým klipem a může využít i závěrečný obrázek. Požadovaná délka je délka celého vráceného videa včetně původního segmentu. Příklad příručky spojuje dvousekundový zdroj s deseti sekundami nového obsahu do dvanáctisekundového výsledku. Připravte závěrečný děj zdroje a uveďte, co nastane dál, aby kamera i objekt pokračovaly souvislým směrem. U napojení zkontrolujte vzhled, pohyb, světlo a zvuk místo hodnocení jen nově generovaného konce.
Současný samostatný referenční profil výrobce používá obrázky nebo video jako vodítko pro postavy, předměty či scénu. Příručka dovoluje celkem až pět referenčních obrázků a videí a používá štítky podle typu, například Image 1 a Video 1. Popište roli každého materiálu a zamýšlenou interakci. U scény vedené referencemi nechte postavu z jedné reference nést předmět z druhé přes určené místo. Referenční rámování se liší od generování z prvního snímku: zadání může určit novou kompozici místo požadavku, aby video začínalo jedním dodaným obrázkem.
Pro vlastní zvuk při textovém generování jsou dokumentovány formáty WAV a MP3 s délkou dvě až třicet sekund a maximem 15 MB. Zvolená délka videa určuje použitou část: delší zvuk se ořízne na tuto délku, zatímco zvuk kratší než video ponechá zbytek tichý. Připravte přesnou zvukovou pasáž patřící k záběru a ponechte prostor pro zamýšlený vizuální děj. Bez dodaného zvukového souboru výrobce popisuje generování hudebního podkladu nebo efektů vhodných pro scénu; skutečný zvuk i požadovanou řeč zkontrolujte společně s obrazem.
Současná tabulka modelů uvádí pro tvorbu z textu či obrázku výstup MP4 v rozlišení 720p nebo 1080p při 30 fps o délce dvě až patnáct sekund. Samostatný referenční profil je omezen na dvě až deset sekund. Textové generování nabízí rámování 16:9, 9:16, 1:1, 4:3 a 3:4. Úlohy podmíněné obrázky používají vlastní pravidla přibližného zachování poměrů zdroje, proto vstup ořízněte pro zamýšlené použití. Pravidla délky či poměru stran referenčního profilu nenahrazují postup se snímky ani pokračování.
Dokumentovaný postup výrobce je asynchronní: identifikátor úlohy sleduje zpracování a úspěšný výsledek poskytne adresu videa. Dokumentace uvádí dvacet čtyři hodin platnosti odkazů na výsledky, proto si pro střihovou kontrolu ponechte samotný klip i tvůrčí materiály. Možnosti přepsání promptu, vodoznaku a seedu náležejí vybranému rozhraní. Výrobce uvádí, že pevný seed může zlepšit opakovatelnost, ale nezaručuje totožný výsledek. Vrácený výstup porovnejte se zadáním místo předpokladu, že samotná nastavení zachovají každý detail.
Oproti Wan 2.6 přidává obrazová příručka 2.7 konkrétně ovládání prvního a posledního snímku a pokračování videa prostřednictvím multimodálních mediálních vstupů. Wan 3.0 zavádí jinou univerzální strukturu a delší limit generování. Tento profil 2.7 si ponechává ovládání a limity specifické pro jednotlivé úlohy. V celé scéně zkontrolujte kontinuitu objektu, ukotvující snímky, identitu referencí, dialog, pohyb a napojení a další opravu zaměřte na skutečně nalezený problém.
Ailoot Ultra · Video POST /v1/videos alibaba/wan-2.7
alibaba/wan-2.7Úvod
Alibaba Wan 2.7 vytváří videa se zvukem z textu, úvodního a závěrečného obrázku nebo vizuálních referencí. Jeho obrazový postup také pokračuje ve zdrojovém klipu s použitím požadované celkové délky. Výrobce uvádí 720p či 1080p MP4 při 30 snímcích za sekundu: 2–15 sekund pro textové/obrazové režimy a až 10 sekund pro generování podle referencí.
- Přijímané vstupy
- Text
- Výsledky
- Video
Dostupné v Ailoot · vstupy a metody
Ailoot Ultra · Video POST /v1/videos
- Vstup
text- Výstup
video- Výstupní formát
- mp4
- Počet výstupů
- Až 4 výstups
| Pole | Typ | Požadavek | Hodnoty a limity | Výchozí |
|---|---|---|---|---|
Polemodel | Typstring | PožadavekPovinné | Hodnoty a limity alibaba/wan-2.7 | Výchozí— |
Poleprompt | Typstring | PožadavekPovinné | Hodnoty a limity Maximální počet bajtů UTF-8: 10 000 Vyžadován obsah kromě bílých znaků: Ano | Výchozí— |
Poleduration | Typinteger | PožadavekPovinné | Hodnoty a limity 2, 3, 4, 5, 6, 7, 8, 9, 10 | Výchozí— |
Poleresolution | Typstring | PožadavekPovinné | Hodnoty a limity 720p | Výchozí— |
Poleaspect_ratio | Typstring | PožadavekPovinné | Hodnoty a limity 16:9, 9:16, 1:1, 4:3, 3:4 | Výchozí— |
Polegenerate_audio | Typboolean | PožadavekPovinné | Hodnoty a limity false, true | Výchozí— |
Kombinace vstupních materiálů
Text na video · Povinné: prompt
Parametry a životní cyklus metody
| Parametr | Kontrakt |
|---|---|
Parametrcontent_type | Kontraktapplication/json |
Parametrrequired | Kontraktmodel, prompt, duration, resolution, aspect_ratio, generate_audio |
Parametradditional_properties | Kontraktfalse |
Parametrparameters | Kontrakt{"name":"model","type":"string","required":true,"enum":["alibaba/wan-2.7"]}, {"name":"prompt","type":"string","required":true,"non_whitespace":true,"max_utf8_bytes":10000}, {"name":"duration","type":"integer","required":true,"enum":[2,3,4,5,6,7,8,9,10]}, {"name":"resolution","type":"string","required":true,"enum":["720p"]}, {"name":"aspect_ratio","type":"string","required":true,"enum":["16:9","9:16","1:1","4:3","3:4"]}, {"name":"generate_audio","type":"boolean","required":true,"enum":[false,true]} |
Parametrmaterial_types | Kontrakttext |
Aliasy metody: /v1/videos/generations, /videos, /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/videos/generations/{request_id}/content
Uchovejte celou odpověď a původní vrácená ID.
Vytvoření s neznámým výsledkem nikdy znovu neodesílejte.
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í | Možnosti generování zvuku | Rozlišení | Účtovací jednotka | Poplatek |
|---|---|---|---|---|---|---|
| KonfiguraceZákladní sazby za tokeny | Tabulka sazebZákladní sazba | Předpokládané množství— | Možnosti generování zvuku— | Rozlišení— | Účtovací jednotka— | 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ů |
| KonfiguraceUltra | Tabulka sazeb— | Předpokládané množstvíPožadované nastavení; pouze odhad. | Možnosti generování zvukuBez zvuku · Se zvukem | Rozlišení720p | Účtovací jednotkaza sekundu výstupního videa | Poplatek Výstup · odhadovaná sekunda videa · Odhad pouze pro srovnání $0.2 za sekundu výstupního videa Zobrazená sazba slouží k odhadu ceny před generováním. Konečná částka se vypočítá z nákladů zaznamenaných pro původní generování. Skutečná délka videa není účtovaným množstvím. |
| KonfiguraceOdhadovaná cena generování | Tabulka sazeb— | Předpokládané množstvíodhad pro jedno generování | Možnosti generování zvuku— | Rozlišení— | Účtovací jednotka— | Poplatek Výstup · Odhadovaná cena generování · Odhad pouze pro srovnání $0.4 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í →
Podrobnosti referenčního tarifu
Referenční tabulky modelu nemění výběr metody, cenové nabídky ani poplatky. Skutečné poplatky používají sazby vybrané metody Ailoot.
Cenové reference konfigurací videa
Ceny podle konfigurace
| Konfigurace | Podmínky účtování | Poplatek |
|---|---|---|
| KonfiguraceCena videa | Podmínky účtováníV tomto cenovém klíči není uvedena žádná další podmínka. | Poplatek Výstup · Cena videa $0.2 za sekundu videa Zveřejněná referenční cena pro zobrazenou konfiguraci. Konečné poplatky odpovídají skutečně účtované konfiguraci. |
Příklady požadavků
Ailoot Ultra · Video
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads('{"model": "alibaba/wan-2.7", "prompt": "a calm greenhouse", "duration": 6, "resolution": "720p", "aspect_ratio": "16:9", "generate_audio": true}')
Path('request.json').write_text(json.dumps(p,ensure_ascii=False))
PY_REQUEST
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
python3 - <<'PY_RESULT'
import json
from pathlib import Path
r=json.loads(Path('result.json').read_text())
print(json.dumps(r,ensure_ascii=False,indent=2))
print('Keep the complete JSON and response headers; do not resubmit an unknown creation.')
PY_RESULT
Přijímání a ukládání výsledků
Ailoot Ultra · Video
mp4
GET /v1/videos/{request_id}GET /v1/videos/generations/{request_id}GET /v1/videos/{request_id}/contentGET /v1/videos/generations/{request_id}/content
Ověřit stav úlohy
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_STATUS_URL'
import json
from pathlib import Path
from urllib.parse import quote
r=json.loads(Path('result.json').read_text())
if not isinstance(r.get('id'),str) or not r['id']:raise SystemExit('Keep the original response and headers for reconciliation; no returned ID')
Path('status-url.txt').write_text('https://api.ailoot.ai/v1/videos/'+quote(r['id'],safe=''))
PY_STATUS_URL
curl --fail-with-body --silent --show-error "$(cat status-url.txt)" \
-H "Authorization: Bearer $AILOOT_API_KEY" -D status-headers.txt -o status.json
python3 - <<'PY_RESULT'
import json
from pathlib import Path
r=json.loads(Path('status.json').read_text())
print(json.dumps(r,ensure_ascii=False,indent=2))
print('Keep the complete JSON and response headers; do not resubmit an unknown creation.')
PY_RESULT
Další načtení obsahu
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())
if r.get('status')!='completed':raise SystemExit('Keep the original ID and read its status; never recreate an unknown job')
if not isinstance(r.get('data'),list) or not r['data']:raise SystemExit('Keep the complete original status; no completed outputs supplied')
urls=[]
for i,u in enumerate(r.get('data',[])):
if not isinstance(u,str):raise SystemExit('Keep the original response; unexpected asset shape')
urls.append((str(i),u))
for label,path in urls:
u=urljoin('https://api.ailoot.ai',path);z=urlsplit(u)
if z.scheme!='https' or z.netloc!='api.ailoot.ai' or z.username or z.password:raise SystemExit('Use the actual returned Ailoot owned content URL')
target=Path('owned-'+label+'.bin')
subprocess.run(['curl','--fail-with-body','--silent','--show-error',u,'-H','Authorization: Bearer '+os.environ['AILOOT_API_KEY'],'-D',str(target)+'.headers','-o',str(target)],check=True)
print('All returned owned URLs saved; complete metadata, timing and usage remain in the JSON.')
PY_ASSETS
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 každou podepsanou URL spravovanou službou z pole data[] dokončeného výsledku a úplná stavová metadata. Uložte každý výstup včetně jeho generovaného zvuku. Platná zvuková stopa AAC může být přítomna i při generate_audio=false; uchovejte celý původní MP4 včetně tohoto zvuku.
Pokud je nutné ověřit původní odpověď
Načítejte existující původní úlohu; odeslání s neznámým výsledkem nikdy neopakujte.
Maximální počet výstupů: 4.
Pole odpovědi
| Pole | Typ | Význam |
|---|---|---|
Poleid | Typstring | Význam— |
Poleobject | Typstring | Význam— |
Polemodel | Typstring | Význam— |
Polestatus | Typstring | Význam— |
Poledata[] | Typsigned content URL | Význam— |
Polecharge_pending_check | Typboolean | Význam— |
Poleerror.code | Typstring | Význam— |
Poleerror.message | Typstring | Význam— |
Poleoperation_id | Typstring | VýznamOdpověď původního stavu či obsahu HTTP503 result_pending_check: stejné původní veřejné ID videa v poli id. |
Poleerror.type | Typstring | Významserver_error při HTTP503 result_pending_check. |
Chyby a další kroky
| Odpověď | Podmínka | Další krok |
|---|---|---|
Odpověď400 · invalid_request_error | PodmínkaNačtení nezpracovaného těla požadavku selže před zpracováním profilu videa | Další krokZachovejte vrácenou odpověď a opravte nečitelné tělo požadavku. |
Odpověď422 · price_unavailable | PodmínkaPřesný profil videa nelze zpracovat nebo pro celý zpracovaný profil není připravena přesná cenová karta | Další krokZachovejte odpověď; použijte celý přesný profil s povoleným přístupem a jeho zveřejněnou kartu. Tato větev se provádí před odesláním poskytovateli. |
Odpověď409 · video_not_ready | PodmínkaObsah původního výsledku zatím není dostupný | Další krokDotazujte se na původní vrácené ID a dodržujte Retry-After. |
Odpověďserver_error | PodmínkaVrácená odpověď uvádí, že operaci nebo výsledek je třeba zkontrolovat | Další krokUchovejte původní vrácené ID operace nebo úlohy, hlavičky požadavku a odpověď; pokračujte v podporovaném načítání údajů o této původní operaci. Požadavek na vytvoření znovu neodesílejte. |
Odpověď503 · result_pending_check | PodmínkaGET původního stavu či obsahu: úloha není zveřejněna, původní úloha nemá stav failed/cancelled/expired a místní stav je unknown nebo stav původní úlohy je completed. | Další krokUchovejte původní id a operation_id (stejné veřejné ID videa), odpověď a hlavičky; načítejte pouze původní stav či obsah. Nikdy neodesílejte nový požadavek na generování. |
Aliasy
Aliasy modelu
Ailoot Ultra alibaba/wan-2.7
Aliasy cest metod
/v1/videos/generations, /videos, /videos/generations
Související ID modelů
FAQ · Alibaba: Wan 2.7
- Jaké vstupy a výsledky jsou dostupné?
POST /v1/videos·alibaba/wan-2.7:text→video- Jaká pole požadavek používá?
POST /v1/videos·alibaba/wan-2.7:model,prompt,duration,resolution,aspect_ratio,generate_audio