Alibaba: Wan 2.7
Az Alibaba Wan 2.7 szövegből, kezdő- és záróképekből vagy vizuális referenciákból készít hanggal ellátott videókat. Képi munkafolyamata forrásklipet is folytat a kért teljes időtartam alapján. A gyártó 720p vagy 1080p MP4-et ad meg 30 fps mellett: szöveges/képi módban 2–15 másodpercet, referenciás generálásnál legfeljebb 10 másodpercet.
A modellről
Ez a leírás a modell képességeit ismerteti. Az Ailootban elérhető bemenetek, kimenetek és lehetőségek alább, a kiválasztott metódusnál láthatók.
Az Alibaba Wan 2.7 videógeneráló család külön elnevezett szöveg-videó, kép-videó és referenciák vezérelte profilokkal. A gyártó hanggal szinkronizált jeleneteket és többfelvételes történeteket dokumentál, képes munkafolyamata pedig első/utolsó képkockás generálást és kezdővideó folytatását is hozzáadja. A hasznos eredmény rövid, hangos klip, például termékátmenet, tömör történet vagy meglévő felvételhez illeszkedő folytatás. A módot a forrásanyag és a kezdet vagy vég feletti szükséges irányítás alapján válaszd.
Szöveg-videó módban írd le a témát, környezetet, cselekvést, kamerát, stílust és hangot. Storyboardban megnevezhető minden felvétel és időtartomány; egyfelvételes leírásnál mondd ki, hogy a cselekvés folyamatos marad. A Wan 2.7 promptútmutatója az írott leírásból értelmezteti a felvételszerkezetet, a 2.6 shot_type vezérlőjének használata helyett. A jelenlegi szöveges API kínai vagy angol promptot fogad legfeljebb 5 000 karakterrel, külön 500 karakteres negatív prompttal; a többletszöveget levágja. E kereten belül világosan add meg a lényegi cselekvést és megkötéseket.
Az első képkockás kép-videó mód megadott nyitóképet animál. Az első/utolsó képkockás generálás a végpontot és az oda vezető mozgást is meghatározza. A 2.7 képes útmutató ezek mellett a képkocka-kombinációk mellett vezérlő hangforrást is támogat. Közös jelenethez és szándékolt témához tartozó végpontokat készíts elő, és az átmenetet írd le, ne a két kép egymástól független stílusreferenciaként való újraértelmezését kérd. A kimenet megközelíti az első kép arányait; az útmutató a felbontást pixelszámszintként kezeli, és megfelelően kerekíti a kódolt méreteket.
A videófolytatás forrásklippel indul, és záróképet is használhat. A kért időtartam a teljes visszaadott videó, az eredeti szakasszal együtt. Az útmutató példája kétmásodperces forrást és tíz másodpercnyi új tartalmat egyesít tizenkét másodperces eredménnyé. Készítsd elő a forrás utolsó cselekvését, és mondd el, mi következik, hogy a kamera és a téma összefüggő irányban folytatódjon. Az illesztést a megjelenés, mozgás, fény és hang szempontjából ellenőrizd, ne csak az újonnan generált befejezést értékeld.
A gyártó jelenlegi külön referenciaprofilja képekkel vagy videóval irányít karaktereket, tárgyakat vagy jelenetet. Útmutatója összesen legfeljebb öt referenciaképet és -videót enged, és típusonkénti címkéket használ, például Image 1 és Video 1. Írd le minden anyag szerepét és a kívánt kölcsönhatást. Referenciák vezérelte jelenetben például az egyik referencia karaktere vigye a másik tárgyát egy megadott helyszínen át. A referenciás képkivágás eltér az első képkockás generálástól: a leírás új kompozíciót határozhat meg ahelyett, hogy a videónak egy megadott állóképpel kellene nyitnia.
Szöveges generálás egyéni hangjához a dokumentált formátum WAV és MP3, két–harminc másodperces időtartammal és legfeljebb 15 MB-tal. A kiválasztott videóhossz határozza meg a felhasznált részt: a hosszabb hangot erre az időre vágja, a videónál rövidebb hang pedig a hátralévő részt némán hagyja. Készítsd elő a felvételhez tartozó pontos hangrészletet, és hagyj helyet a kívánt vizuális cselekvésnek. Hangfájl nélkül a gyártó a jelenethez illő háttérzene vagy effektusok generálását írja le; a tényleges hangot és minden kért beszédet a képpel együtt ellenőrizd.
A jelenlegi modelltáblázat 720p vagy 1080p MP4-et sorol fel 30 fps mellett, két–tizenöt másodperces szöveges és képes kimenettel. A külön referenciaprofil két–tíz másodpercre korlátozott. A szöveges generálás 16:9, 9:16, 1:1, 4:3 és 3:4 képkivágást kínál. A képi bemenettel vezérelt feladatok saját, közelítő forrásarány-szabályokat használnak, ezért a bemeneti kivágást a célfelhasználáshoz készítsd elő. A referenciaprofil időtartam- vagy oldalarányszabálya nem helyettesítheti a képkockás vagy folytatási munkafolyamatét.
A dokumentált gyártói folyamat aszinkron: feladatazonosító követi a feldolgozást, siker esetén pedig megkapod a videó helyét. Az eredményekhez huszonnégy órás linkérvényességet dokumentálnak, ezért szerkesztési ellenőrzéshez őrizd meg magát a klipet és az alkotói anyagokat. A promptátírás, vízjel és seed lehetőségei a kiválasztott felülethez tartoznak. A gyártó szerint a rögzített seed javíthatja a reprodukálhatóságot, de nem garantál azonos eredményt. A visszaadott alkotást vesd össze a leírással, ne feltételezd, hogy a beállítások önmagukban minden részletet megőriznek.
A Wan 2.6-hoz képest a 2.7 képes útmutató kifejezetten hozzáadja az első/utolsó képkockás irányítást és a videófolytatást multimodális médiabemeneteken keresztül. A Wan 3.0 eltérő mindent egyben szerkezetet és hosszabb generálási keretet vezet be. Ez a 2.7 profil megtartja feladatspecifikus vezérlőit és korlátait. A teljes jeleneten ellenőrizd a téma folytonosságát, rögzítő képkockákat, referenciaazonosságot, párbeszédet, mozgást és illesztéseket, majd a következő javítást a ténylegesen talált problémára célozd.
Ailoot Ultra · Videó POST /v1/videos alibaba/wan-2.7
alibaba/wan-2.7Kezdő lépések
Az Alibaba Wan 2.7 szövegből, kezdő- és záróképekből vagy vizuális referenciákból készít hanggal ellátott videókat. Képi munkafolyamata forrásklipet is folytat a kért teljes időtartam alapján. A gyártó 720p vagy 1080p MP4-et ad meg 30 fps mellett: szöveges/képi módban 2–15 másodpercet, referenciás generálásnál legfeljebb 10 másodpercet.
- Elfogadott bemenetek
- Szöveg
- Eredmények
- Videó
Elérhető az Ailootban · bemenetek és metódusok
Ailoot Ultra · Videó POST /v1/videos
- Bemenet
text- Kimenet
video- Kimeneti formátum
- mp4
- Kimenetek száma
- Legfeljebb 4 kimenets
| Mező | Típus | Követelmény | Értékek és korlátok | Alapértelmezett |
|---|---|---|---|---|
Mezőmodel | Típusstring | KövetelményKötelező | Értékek és korlátok alibaba/wan-2.7 | Alapértelmezett— |
Mezőprompt | Típusstring | KövetelményKötelező | Értékek és korlátok Maximális UTF-8 bájtszám: 10 000 Nem csak szóközből álló tartalom szükséges: Igen | Alapértelmezett— |
Meződuration | Típusinteger | KövetelményKötelező | Értékek és korlátok 2, 3, 4, 5, 6, 7, 8, 9, 10 | Alapértelmezett— |
Mezőresolution | Típusstring | KövetelményKötelező | Értékek és korlátok 720p | Alapértelmezett— |
Mezőaspect_ratio | Típusstring | KövetelményKötelező | Értékek és korlátok 16:9, 9:16, 1:1, 4:3, 3:4 | Alapértelmezett— |
Mezőgenerate_audio | Típusboolean | KövetelményKötelező | Értékek és korlátok false, true | Alapértelmezett— |
Bemeneti anyagok kombinációi
Szövegből videó · Kötelező: prompt
Metódus paraméterei és életciklusa
| Paraméter | Szerződés |
|---|---|
Paramétercontent_type | Szerződésapplication/json |
Paraméterrequired | Szerződésmodel, prompt, duration, resolution, aspect_ratio, generate_audio |
Paraméteradditional_properties | Szerződésfalse |
Paraméterparameters | Szerződés{"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]} |
Paramétermaterial_types | Szerződéstext |
Metódus álnevei: /v1/videos/generations, /videos, /videos/generations
Életciklus: 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
Őrizze meg a teljes választ és az eredetileg visszaadott azonosítókat.
Ismeretlen kimenetelű létrehozást soha ne küldjön be újra.
Díjcsomagok
A végső díj számítása
A megjelenített díjtételek a generálás előtti költségbecsléshez szolgálnak. A végleges díj az eredeti generáláshoz rögzített költségből számítódik. A kimenet mért időtartama és az előre jelzett mennyiségek nem azonosak a véglegesen elszámolandó mennyiséggel.
A díjszabás nem ad új kérési lehetőségeket. A támogatott paraméterek a kiválasztott módszernél szerepelnek.
- Gyors mód
- Nincs megadva Ha a gyors mód van kiválasztva
- Flex mód
- Nincs megadva Ha a flex mód van kiválasztva
- Maximális gondolkodási ráfordítás
- Nincs megadva Ha a maximális gondolkodási ráfordításra a default beállításhoz tartozó korrekció vonatkozik
Becsült díjak összehasonlításhoz
Árak beállításonként
Minden díjat a megjelenített feltételekhez rendeljen. Az alternatív beállítások minden csoportjához egy díjtételt használjon.
| Beállítás | Díjtáblázat | Előre jelzett mennyiség | Hanggenerálási lehetőségek | Felbontás | Elszámolási egység | Díj |
|---|---|---|---|---|---|---|
| BeállításTokenek alapdíjai | DíjtáblázatAlapdíj | Előre jelzett mennyiség— | Hanggenerálási lehetőségek— | Felbontás— | Elszámolási egység— | Díj Bemenet · Bemeneti tokenek · Becslés, csak összehasonlításra — / 1K token Kimenet · Kimeneti tokenek · Becslés, csak összehasonlításra — / 1K token Bemenet · Gyorsítótár olvasása · Becslés, csak összehasonlításra — / 1K token Bemenet · Írás a gyorsítótárba · Becslés, csak összehasonlításra — / 1K token Bemenet · Írás a gyorsítótárba, 1 óra · Becslés, csak összehasonlításra — / 1K token |
| BeállításUltra | Díjtáblázat— | Előre jelzett mennyiségKért beállítások; csak becslés. | Hanggenerálási lehetőségekHang nélkül · Hanggal | Felbontás720p | Elszámolási egységkimeneti videómásodpercenként | Díj Kimenet · becsült videómásodperc · Becslés, csak összehasonlításra $0.2 kimeneti videómásodpercenként A megjelenített díj a generálás előtti költséget becsüli. A végleges díjat az eredeti generálásnál rögzített költségből számítják. A videó tényleges lejátszási időtartama nem a számlázott mennyiség. |
| BeállításA generálás becsült költsége | Díjtáblázat— | Előre jelzett mennyiségbecslés egy generálásra | Hanggenerálási lehetőségek— | Felbontás— | Elszámolási egység— | Díj Kimenet · Becsült generálási költség · Becslés, csak összehasonlításra $0.4 becslés a generálás előtt Ez a becslés nem jelent további díjat, és nem rögzített díjszabás az elkészült generálásra. |
Az Ailoot a kérés előtt becsült összeget foglal le. Az eredmény után a mért használat alapján elszámolja a végső díjat. Folyamatos átvitel esetén a végső használati rekordot használja. A foglalás és az elszámolás működése →
A referencia-díjszabás részletei
A modellszintű referenciatáblázatok nem módosítják a metódusválasztást, az árajánlatokat vagy a díjakat. A tényleges díjak a kiválasztott Ailoot-metódus díjtételeit használják.
Videóbeállítások árhivatkozásai
Árak beállításonként
| Beállítás | Elszámolási feltételek | Díj |
|---|---|---|
| BeállításVideó ára | Elszámolási feltételekEbben az árképzési kulcsban nincs további feltétel megadva. | Díj Kimenet · Videó ára $0.2 videómásodpercenként A megjelenített konfiguráció közzétett árreferenciája. A végleges díjak a ténylegesen elszámolt konfigurációt követik. |
Példakérések
Ailoot Ultra · Videó
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
Eredmények fogadása és mentése
Ailoot Ultra · Videó
mp4
GET /v1/videos/{request_id}GET /v1/videos/generations/{request_id}GET /v1/videos/{request_id}/contentGET /v1/videos/generations/{request_id}/content
Feladatállapot ellenőrzése
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
További tartalomlekérések
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
Őrizzen meg minden elkészült eredményt
Mentsen minden elkészült videót és visszaadott fájlt; töltse le az összes ténylegesen visszaadott médiafájl URL-jének tartalmát.
Őrizze meg a befejezett data[] összes aláírt saját URL-címét és a teljes állapot-metaadatokat. Mentse el az összes kimenetet a generált hangjával együtt. Érvényes AAC-hangsáv generate_audio=false mellett is jelen lehet; őrizze meg a teljes eredeti MP4 fájlt ezzel a hanggal együtt.
Ha az eredeti választ ellenőrizni kell
A meglévő eredeti feladatot kérdezze le; ismeretlen kimenetelű küldést soha ne küldjön be újra.
Maximális kimenetszám: 4.
Válaszmezők
| Mező | Típus | Jelentés |
|---|---|---|
Mezőid | Típusstring | Jelentés— |
Mezőobject | Típusstring | Jelentés— |
Mezőmodel | Típusstring | Jelentés— |
Mezőstatus | Típusstring | Jelentés— |
Meződata[] | Típussigned content URL | Jelentés— |
Mezőcharge_pending_check | Típusboolean | Jelentés— |
Mezőerror.code | Típusstring | Jelentés— |
Mezőerror.message | Típusstring | Jelentés— |
Mezőoperation_id | Típusstring | JelentésHTTP503 result_pending_check válasz az eredeti status/content lekérdezésre: az id ugyanaz az eredeti nyilvános videóazonosító. |
Mezőerror.type | Típusstring | Jelentésserver_error a HTTP503 result_pending_check válasznál. |
Hibák és következő lépések
| Válasz | Feltétel | Következő lépés |
|---|---|---|
Válasz400 · invalid_request_error | FeltételA nyers kéréstörzs beolvasása a videóprofil feldolgozása előtt sikertelen | Következő lépésŐrizze meg a visszaadott választ, és javítsa az olvashatatlan kéréstörzset. |
Válasz422 · price_unavailable | FeltételA pontos videóprofil feldolgozása sikertelen, vagy a teljes feldolgozott profilhoz nincs kész, pontos árkártya | Következő lépésŐrizze meg a választ; használja a teljes, pontosan engedélyezett profilt és annak közzétett árkártyáját. Ez az ág a szolgáltatónak történő küldés előtt fut le. |
Válasz409 · video_not_ready | FeltételAz eredeti eredmény tartalma még nem érhető el | Következő lépésKérdezze le az eredetileg visszaadott azonosítót, és tartsa be a Retry-After előírását. |
Válaszserver_error | FeltételA visszaadott válasz szerint a művelet vagy az eredmény ellenőrzést igényel | Következő lépésŐrizze meg az eredetileg visszaadott művelet- vagy feladatazonosítót, a kérés fejléceit és a választ; folytassa az eredeti művelet támogatott lekérdezéseit. Ne küldje be újra a létrehozási kérést. |
Válasz503 · result_pending_check | FeltételAz eredeti status/content GET lekérdezésekor: a feladat nincs közzétéve, az eredeti feladat állapota nem failed/cancelled/expired, és a helyi állapot unknown, vagy az eredeti feladat állapota completed. | Következő lépésŐrizze meg az eredeti id és operation_id értéket (ugyanaz a nyilvános videóazonosító), a választ és a fejléceket; csak az eredeti status/content értéket kérdezze le. Soha ne küldjön be új generálási kérést. |
Álnevek
Modell álnevei
Ailoot Ultra alibaba/wan-2.7
Metódusútvonalak álnevei
/v1/videos/generations, /videos, /videos/generations
Kapcsolódó modellazonosítók
FAQ · Alibaba: Wan 2.7
- Milyen bemenetek és eredmények érhetők el?
POST /v1/videos·alibaba/wan-2.7:text→video- Mely mezőket használja a kérés?
POST /v1/videos·alibaba/wan-2.7:model,prompt,duration,resolution,aspect_ratio,generate_audio