Alibaba: Wan 2.7
Alibaba Wan 2.7 vytvára videá so zvukom z textu, úvodného a záverečného obrázka alebo vizuálnych referencií. Jeho obrazový postup tiež pokračuje v zdrojovom klipe s použitím požadovanej celkovej dĺžky. Výrobca uvádza MP4 v 720p alebo 1080p pri 30 fps: 2–15 sekúnd pre textové a obrazové režimy a najviac 10 sekúnd pre generovanie podľa referencií.
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.
Alibaba Wan 2.7 je rodina generovania videa s pomenovanými profilmi text-to-video, image-to-video a vedenými referenciami. Výrobca dokumentuje scény so synchronizovaným zvukom a viaczáberové príbehy, pričom jeho obrazový postup pridáva generovanie z prvej/poslednej snímky a pokračovanie úvodného videa. Užitočným výsledkom je krátky klip s jeho zvukom, napríklad produktový prechod, kompaktný príbeh alebo pokračovanie, ktoré zapadá do existujúceho záberu. Režim vyberte podľa zdrojového materiálu a potrebnej kontroly nad začiatkom či koncom.
Pri text-to-video opíšte subjekt, prostredie, akciu, kameru, štýl a zvuk. Storyboard môže určiť každý záber a časový rozsah, kým zadanie jedného záberu má uviesť, že akcia zostáva neprerušená. Návod na zadania Wan 2.7 necháva model interpretovať štruktúru záberov z písaného zadania namiesto použitia ovládania shot_type z 2.6. Aktuálne textové API prijíma čínske alebo anglické zadania s najviac 5 000 znakmi a samostatné negatívne zadanie s 500 znakmi; nadbytočný text sa oreže. V tomto limite jasne uveďte kľúčovú akciu a obmedzenia.
Image-to-video z prvej snímky animuje dodaný úvodný obrázok. Generovanie z prvej/poslednej snímky určuje aj koncový bod a pohyb, ktorý ich spája. Obrazový návod 2.7 podporuje pri týchto kombináciách snímok aj riadiaci zvukový zdroj. Pripravte koncové body zdieľajúce scénu a zamýšľaný subjekt a opíšte prechod namiesto žiadosti, aby model oba obrázky reinterpretoval ako nesúvisiace štýlové referencie. Výstup približne zachováva proporcie prvého obrázka; návod chápe rozlíšenie ako úroveň počtu pixelov a vhodne zaokrúhľuje zakódované rozmery.
Pokračovanie videa začína zdrojovým klipom a môže použiť aj záverečný obrázok. Požadovaná dĺžka predstavuje celé vrátené video vrátane pôvodného úseku. Príklad v návode spája dvojsekundový zdroj s desiatimi sekundami nového obsahu do dvanásťsekundového výsledku. Pripravte záverečnú akciu zdroja a povedzte, čo nasleduje, aby kamera aj subjekt pokračovali súdržným smerom. Spojenie kontrolujte z hľadiska vzhľadu, pohybu, svetla a zvuku namiesto hodnotenia iba novo vygenerovaného konca.
Aktuálny samostatný referenčný profil výrobcu používa obrázky alebo video na usmernenie postáv, predmetov či scény. Jeho návod povoľuje spolu až päť referenčných obrázkov a videí a používa označenia podľa typu, napríklad Image 1 a Video 1. Opíšte úlohu každého materiálu a zamýšľanú interakciu. Pri scéne vedenej referenciami ukážte postavu z jednej referencie, ako nesie predmet z druhej cez určené miesto. Referenčné rámovanie sa líši od generovania z prvej snímky: zadanie môže stanoviť novú kompozíciu namiesto požiadavky, aby sa video začínalo jedným dodaným statickým obrázkom.
Pri vlastnom zvuku v textovom generovaní sú dokumentované formáty WAV a MP3, dĺžka od dvoch do tridsiatich sekúnd a maximum 15 MB. Zvolená dĺžka videa určuje použitú časť: dlhší zvuk sa oreže na túto dĺžku, kým zvuk kratší než video necháva zvyšok tichý. Pripravte presný zvukový úsek patriaci do záberu a nechajte priestor na zamýšľanú vizuálnu akciu. Bez dodaného zvukového súboru výrobca opisuje generovanie hudobného podkladu alebo efektov vhodných pre scénu; skutočný zvuk aj požadovanú reč kontrolujte spolu s obrazom.
Aktuálna matica modelov uvádza MP4 v 720p alebo 1080p pri 30 snímkach za sekundu s dĺžkou videa generovaného z textu alebo obrázka od dvoch do pätnástich sekúnd. Samostatný referenčný profil je obmedzený na dĺžku od dvoch do desiatich sekúnd. Textové generovanie ponúka rámovanie 16:9, 9:16, 1:1, 4:3 a 3:4. Úlohy podmienené obrázkom používajú vlastné pravidlá približného zachovania proporcií zdroja, preto vstupný výrez pripravte pre zamýšľané umiestnenie. Pravidlo dĺžky alebo pomeru strán z referenčného profilu nemá nahrádzať postup so snímkami či pokračovaním.
Dokumentovaný postup výrobcu je asynchrónny: identifikátor úlohy sleduje spracovanie a úspešný výsledok poskytuje umiestnenie videa. Pri výsledkoch je dokumentovaná platnosť odkazu dvadsaťštyri hodín, preto uchovajte samotný klip aj tvorivé materiály pre kontrolu úprav. Možnosti prepisovania zadania, vodoznaku a seedu patria k zvolenému rozhraniu. Výrobca uvádza, že pevný seed môže zlepšiť reprodukovateľnosť, ale nezaručuje identický výsledok. Vrátený výstup porovnajte so zadaním namiesto predpokladu, že samotné nastavenia zachovajú každý detail.
V porovnaní s Wan 2.6 pridáva obrazový návod 2.7 konkrétne kontrolu prvej/poslednej snímky a pokračovanie videa prostredníctvom multimodálnych mediálnych vstupov. Wan 3.0 zavádza inú komplexnú štruktúru a dlhší limit generovania. Tento profil 2.7 si zachováva ovládanie a limity špecifické pre úlohy. V celej scéne kontrolujte kontinuitu subjektu, ukotvenie snímok, referenčnú identitu, dialóg, pohyb a spoje a ďalšiu opravu zamerajte na skutočne nájdený problém.
Ailoot Ultra · Video POST /v1/videos alibaba/wan-2.7
alibaba/wan-2.7Úvod
Alibaba Wan 2.7 vytvára videá so zvukom z textu, úvodného a záverečného obrázka alebo vizuálnych referencií. Jeho obrazový postup tiež pokračuje v zdrojovom klipe s použitím požadovanej celkovej dĺžky. Výrobca uvádza MP4 v 720p alebo 1080p pri 30 fps: 2–15 sekúnd pre textové a obrazové režimy a najviac 10 sekúnd pre generovanie podľa referencií.
- Povolené vstupy
- Text
- Výsledky
- Video
Dostupné v Ailoot · vstupy a metódy
Ailoot Ultra · Video POST /v1/videos
- Vstup
text- Výstup
video- Výstupný formát
- mp4
- Počet výstupov
- Do 4 výstups
| Pole | Typ | Požiadavka | Hodnoty a limity | Predvolené |
|---|---|---|---|---|
Polemodel | Typstring | PožiadavkaPovinné | Hodnoty a limity alibaba/wan-2.7 | Predvolené— |
Poleprompt | Typstring | PožiadavkaPovinné | Hodnoty a limity Maximálny počet bajtov UTF-8: 10 000 Vyžaduje sa aspoň jeden znak, ktorý nie je bielym znakom: Áno | Predvolené— |
Poleduration | Typinteger | PožiadavkaPovinné | Hodnoty a limity 2, 3, 4, 5, 6, 7, 8, 9, 10 | Predvolené— |
Poleresolution | Typstring | PožiadavkaPovinné | Hodnoty a limity 720p | Predvolené— |
Poleaspect_ratio | Typstring | PožiadavkaPovinné | Hodnoty a limity 16:9, 9:16, 1:1, 4:3, 3:4 | Predvolené— |
Polegenerate_audio | Typboolean | PožiadavkaPovinné | Hodnoty a limity false, true | Predvolené— |
Kombinácie vstupných podkladov
Z textu na video · Povinné: prompt
Parametre a životný cyklus metódy
| Parameter | Špecifikácia |
|---|---|
Parametercontent_type | Špecifikáciaapplication/json |
Parameterrequired | Špecifikáciamodel, prompt, duration, resolution, aspect_ratio, generate_audio |
Parameteradditional_properties | Špecifikáciafalse |
Parameterparameters | Špecifikácia{"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]} |
Parametermaterial_types | Špecifikáciatext |
Aliasy metódy: /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
Zachovajte celú odpoveď a pôvodné vrátené ID.
Vytvorenie s neznámym výsledkom nikdy znova neodosielajte.
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 | Možnosti generovania audia | Rozlíšenie | Účtovacia jednotka | Poplatok |
|---|---|---|---|---|---|---|
| KonfiguráciaZákladné sadzby za tokeny | SadzobníkZákladná sadzba | Odhadované množstvo— | Možnosti generovania audia— | Rozlíšenie— | Účtovacia jednotka— | 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áciaUltra | Sadzobník— | Odhadované množstvoPožadované nastavenie; iba odhad. | Možnosti generovania audiaBez audia · S audiom | Rozlíšenie720p | Účtovacia jednotkaza sekundu výstupného videa | Poplatok Výstup · odhadovaná sekunda videa · Odhad iba na porovnanie $0.2 za sekundu výstupného videa Zobrazená sadzba odhaduje náklady pred generovaním. Konečný poplatok sa vypočíta z nákladov zaznamenaných pri pôvodnom generovaní. Fyzická dĺžka videa nie je účtovaným množstvom. |
| KonfiguráciaOdhadované náklady na generovanie | Sadzobník— | Odhadované množstvoodhad pre jedno generovanie | Možnosti generovania audia— | Rozlíšenie— | Účtovacia jednotka— | Poplatok Výstup · Odhadované náklady na generovanie · Odhad iba na porovnanie $0.4 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 →
Podrobnosti referenčnej tarify
Referenčné sadzobníky modelu nemenia výber metódy, cenové odhady ani poplatky. Aktívne poplatky používajú sadzby vybranej metódy Ailoot.
Cenové referencie konfigurácií videa
Ceny podľa konfigurácie
| Konfigurácia | Podmienky účtovania | Poplatok |
|---|---|---|
| KonfiguráciaCena videa | Podmienky účtovaniaV tomto cenovom kľúči nie je uvedená žiadna ďalšia podmienka. | Poplatok Výstup · Cena videa $0.2 za sekundu videa Zverejnený cenový údaj pre zobrazenú konfiguráciu. Konečné poplatky sa riadia skutočne účtovanou konfiguráciou. |
Príklady požiadaviek
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
Prijať a uložiť výsledky
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
Skontrolovať 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
Čítanie ďalšieho 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
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 každú podpísanú URL vo vašom vlastníctve v dokončenom data[] a všetky metadáta stavu. Uložte každý výstup vrátane jeho vygenerovaného zvuku. Platná zvuková stopa AAC môže byť prítomná aj pri generate_audio=false; zachovajte celý pôvodný MP4 vrátane tohto zvuku.
Ak treba overiť pôvodnú odpoveď
Načítajte existujúcu pôvodnú úlohu; odoslanie s neznámym výsledkom nikdy neopakujte.
Maximálny počet výstupov: 4.
Polia odpovede
| 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ýznamPôvodná odpoveď stavu alebo obsahu HTTP503 result_pending_check: rovnaké pôvodné verejné ID videa ako id. |
Poleerror.type | Typstring | Významserver_error pri HTTP503 result_pending_check. |
Chyby a ďalšie kroky
| Odpoveď | Podmienka | Ďalší krok |
|---|---|---|
Odpoveď400 · invalid_request_error | PodmienkaNačítanie nespracovaného tela požiadavky zlyhá pred parsovaním profilu videa | Ďalší krokZachovajte vrátenú odpoveď a opravte nečitateľné telo požiadavky. |
Odpoveď422 · price_unavailable | PodmienkaParsovanie presného profilu videa zlyhá alebo úplný parsovaný profil nemá pripravenú presnú cenovú kartu | Ďalší krokZachovajte odpoveď; použite úplný presný povolený profil a jeho zverejnenú kartu. Táto vetva sa vykonáva pred odoslaním poskytovateľovi. |
Odpoveď409 · video_not_ready | PodmienkaPôvodný obsah výsledku zatiaľ nie je dostupný | Ďalší krokPriebežne zisťujte stav pomocou pôvodne vráteného ID a rešpektujte Retry-After. |
Odpoveďserver_error | PodmienkaVrátená odpoveď uvádza, že operáciu alebo výsledok je potrebné skontrolovať | Ďalší krokUchovajte pôvodné vrátené ID operácie/úlohy, hlavičky požiadavky a odpoveď; naďalej čítajte údaje o tejto pôvodnej operácii podporovaným spôsobom. Požiadavku na vytvorenie znova neodosielajte. |
Odpoveď503 · result_pending_check | PodmienkaGET pôvodného stavu alebo obsahu: úloha nie je zverejnená, pôvodná úloha nemá stav failed/cancelled/expired a miestny stav je unknown alebo je stav pôvodnej úlohy completed. | Ďalší krokZachovajte pôvodné id a operation_id (rovnaké verejné ID videa), odpoveď a hlavičky; načítavajte iba pôvodný stav alebo obsah. Nikdy neodosielajte novú požiadavku na generovanie. |
Aliasy
Aliasy modelov
Ailoot Ultra alibaba/wan-2.7
Aliasy ciest metód
/v1/videos/generations, /videos, /videos/generations
Súvisiace ID na volanie
FAQ · Alibaba: Wan 2.7
- Aké vstupy a výsledky sú dostupné?
POST /v1/videos·alibaba/wan-2.7:text→video- Aké polia používa požiadavka?
POST /v1/videos·alibaba/wan-2.7:model,prompt,duration,resolution,aspect_ratio,generate_audio