Alibaba: Wan 3.0

Alibaba Wan 3.0 vytváří video se zvukem z promptu, prvního či prvního a posledního snímku a multimodálních referencí. Profil výrobce spojuje storyboardy, úpravy zdrojového materiálu a pokračování videa v jednom modelu s výstupem MP4 dlouhým 2–30 sekund při 30 fps v rozlišení 480p, 720p nebo 1080p.

Ailoot Ultra · Video POST /v1/videos alibaba/wan-3.0

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 3.0 je univerzální profil pro tvorbu videa, který převádí zadání a podpůrné materiály na scénu s vlastním zvukem. Výrobce označuje standardní model jako wan3.0-video. Generování pouze z textu, úvodní a závěrečné snímky, multimodální reference, úpravy a pokračování používají v rámci tohoto profilu různé sestavy vstupů. Užitečné výstupy zahrnují krátký příběh, produktovou prezentaci, přechod založený na obrázcích nebo upravený zdrojový klip, jehož změny sledují konkrétní tvůrčí směr.

Pro čistě textovou scénu připravte objekt, místo, děj, kameru, vizuální styl a zvuk. Výrobce podporuje jednotlivé záběry i storyboardy s více záběry a doporučuje strukturu zhruba čtyři až šest sekund na záběr s volitelnými časovými rozsahy. Pro krátký příběh představte malého mechanického ptáka na pracovním stole, sledujte jeho první pohyb a zakončete výdrží na detailu, zatímco pokračují zvuky místnosti. Popište vizuální vztah mezi těmito momenty, aby třicetisekundový limit sloužil jednomu souvislému příběhu místo seznamu nesouvisejících akcí.

Generování z prvního snímku animuje dodaný obrázek. Obrázek určuje úvodní kompozici, prompt vysvětluje pohyb a práci kamery. Generování z prvního a posledního snímku navíc ukotvuje konec a popisuje přechod mezi oběma obrázky. Připravte krajní snímky s kompatibilní scénou a zamýšleným rámováním. Příručka pro tyto režimy doporučuje adaptivní volbu poměru stran. Jejich snímkové vstupy jsou oddělené od sestav s referenčními obrázky, videem, zvukem, souborem a webovým odkazem, proto zvolte režim materiálů odpovídající plánovanému záběru.

Referenční režim kombinuje až deset obrázků, pět videoklipů a pět zvukových klipů v celkovém limitu dvaceti materiálů. Obrazové reference mohou určit postavu, předmět, prostředí či styl; video může vést pohyb nebo práci kamery a zvuk výkon či rytmus. Štítky podle typu, například Image 1, Video 1 a Audio 1, sledují pořadí vstupů nezávisle pro každý typ. Každé referenci přiřaďte roli a popište její vztah k ostatním. Správně vypadající postava v nesprávném prostředí je jiná chyba než kamera, která nezachytí zamýšlený pohyb.

Dokumentované limity referenčních souborů jsou 20 MB na obrázek, 100 MB na video a 15 MB na zvukový klip. Referenční videa jsou dohromady omezena na patnáct sekund a zvukové reference mají samostatný souhrnný limit patnáct sekund. Referenční materiál může doprovázet jeden dokument nebo jedna reference veřejné webové stránky; dokument a odkaz se vzájemně vylučují. Zdroj musí být veřejně dostupný bez přihlášení. Připravte cílený zdroj a uveďte, který obsah má klip ovlivnit, zvlášť pokud dokument obsahuje více informací, než scéna dokáže využít.

Nativní zvuk kombinuje dialog, hudební doprovod, ruch prostředí a zvukové efekty s generovaným obrazem. Uveďte mluvená slova, mluvčího a přednes, důležité efekty a zda má být přítomna hudba. Podle příručky výrobce je zvuk ve výchozím stavu zapnutý a lze jej vypnout. U demonstrační scény může krátká úvodní replika předcházet detailu produktu, zatímco tichý mechanický zvuk označí pohyb. Hotový klip si poslechněte a ověřte skutečné znění, přiřazení mluvčího a synchronizaci místo hodnocení zvuku jen podle písemného zadání.

Pro úpravu popište změnu a zachovávaný obsah. Příručka pokrývá přidávání či odstraňování prvků, nahrazování vlastností, změnu vizuálního stylu nebo osvětlení a přepracování dialogu. Pro pokračování popište, co se má odehrát před existujícím klipem, po něm či kolem něj. Adaptivní rámování a chytrá délka pomáhají postupu se zdrojovým videem zachovat zamýšlený formát a načasování. Při dodání videovstupu nesmí podle dokumentace souhrnná délka vstupního a výstupního videa překročit 30 sekund. Ponechte si původní zdroj a zkontrolujte změněnou oblast i kontinuitu celého klipu.

Výstupem je MP4 při 30 fps v rozlišení 480p, 720p nebo 1080p. Nově generovaná videa mají délku od dvou do třiceti sekund; nastavení chytré délky může nechat volbu na modelu. Dokumentovány jsou formáty na šířku, čtverec a na výšku s adaptivním rámováním vhodným pro dodaný materiál. Výrobce zpracuje požadavek jako úlohu a vrátí adresu hotového videa platnou dvacet čtyři hodin. Skutečný výsledek, zadání a reference uchovejte jako produkční záznam a před sestavením s dalšími klipy ověřte vrácenou délku a rámování.

Standardní Wan 3.0 a varianta Prime sdílejí dokumentované univerzální režimy; Prime zdůrazňuje rychlost generování. Wan 2.7 a 2.6 mají odlišná pravidla délky a referencí podle úloh, proto jejich rozhraní nepovažujte za konfiguraci této edice. V hotové scéně zkontrolujte identitu postav a produktů, prostorovou kontinuitu, řeč, efekty, detaily převzaté ze zdroje a zamýšlený začátek i konec. Konkrétní další oprava zachová úspěšný směr a zároveň vyřeší skutečnou chybu nalezenou v klipu.

Ailoot Ultra · Video POST /v1/videos alibaba/wan-3.0

alibaba/wan-3.0

Alibaba /alibaba/wan-3.0

Úvod

Přijímané vstupy: Text · Obrázky
Výsledky: Video

Dostupné v Ailoot · vstupy a metody

Ailoot Ultra · Video POST /v1/videos

Vstup: text, image
Výstup: video
Výstupní formát: původní bajty MP4; bez normalizace a překódování

Pole	Typ	Požadavek	Hodnoty a limity	Výchozí
Pole`model`	Typ`string`	PožadavekPovinné	Hodnoty a limity alibaba/wan-3.0	Výchozí—
Pole`prompt`	Typ`string`	PožadavekPovinné	Hodnoty a limity	Výchozí—
Pole`duration`	Typ`integer`	PožadavekPovinné	Hodnoty a limity 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26, 27, 28, 29, 30 Minimum: 1 Maximum: 600	Výchozí—
Pole`resolution`	Typ`string`	PožadavekVolitelné	Hodnoty a limity 480p, 720p, 1080p	Výchozí—
Pole`aspect_ratio`	Typ`string`	PožadavekVolitelné	Hodnoty a limity 16:9, 4:3, 1:1, 3:4, 9:16	Výchozí—
Pole`generate_audio`	Typ`boolean`	PožadavekVolitelné	Hodnoty a limity false, true	Výchozí—
Pole`frame_images`	Typ`array`	PožadavekVolitelné	Hodnoty a limity Minimální počet položek: 1 Maximální počet položek: 1 Vstupní obsah: Pole objektů snímků. Každý objekt obsahuje type=image_url, image_url obsahující url a frame_type. Použijte HTTPS URL obrázku a nastavte frame_type na first_frame. Každá role snímku se smí vyskytnout nejvýše jednou. Přesné klíče: type, image_url, frame_type Podmínky: Tyto klíče popisují každý objekt snímku; image_url obsahuje pouze url. Pro požadavek obsahující pouze text vynechte frame_images.	Výchozí—
Pole`input_references`	Typ`array`	PožadavekVolitelné	Hodnoty a limity	Výchozí—
Pole`seed`	Typ`integer`	PožadavekVolitelné	Hodnoty a limity Minimum: -9 223 372 036 854 775 808 Maximum: 9 223 372 036 854 775 807	Výchozí—
Pole`callback_url`	Typ`string`	PožadavekVolitelné	Hodnoty a limity Vzor: ^https://	Výchozí—
Pole`session_id`	Typ`string`	PožadavekVolitelné	Hodnoty a limity	Výchozí—
Pole`trace`	Typ`object`	PožadavekVolitelné	Hodnoty a limity	Výchozí—
Pole`user`	Typ`string`	PožadavekVolitelné	Hodnoty a limity	Výchozí—

Kombinace vstupních materiálů

Text na video · Textové zadání. · Povinné: model, prompt, duration

Zadejte prompt jako text a duration v celých sekundách. Vyberte podporované rozlišení a případně poměr stran.

model: Typ: string · alibaba/wan-3.0

prompt: Typ: string · Maximální počet bajtů UTF-8: 10 000 · Vyžadován obsah kromě bílých znaků: Ano

Obrázek na video · Textové zadání a obrázek prvního snímku. · Povinné: model, prompt, duration, frame_images

frame_images je pole. Každý objekt snímku obsahuje type, image_url a frame_type; image_url obsahuje url. Nastavte type na image_url. Použijte first_frame. Každá role snímku se smí vyskytnout nejvýše jednou. Pro každý snímek zadejte veřejnou HTTPS URL obrázku. Zvolte podporované rozlišení a případně poměr stran.

Přesné klíče: type, image_url, frame_type

model: Typ: string · alibaba/wan-3.0

prompt: Typ: string · Maximální počet bajtů UTF-8: 10 000 · Vyžadován obsah kromě bílých znaků: Ano

Reference to video · Textové zadání a podporované obrazové reference. · Povinné: model, prompt, duration, input_references

input_references je pole objektů. Nastavte type na image_url a použijte odpovídající pole obsahující url. Používejte veřejné HTTPS URL. Vynecháním frame_images zvolíte režim referencí. Vyberte podporované rozlišení a případně poměr stran.

model: Typ: string · alibaba/wan-3.0

prompt: Typ: string · Maximální počet bajtů UTF-8: 10 000 · Vyžadován obsah kromě bílých znaků: Ano

Parametry a životní cyklus metody

Parametr	Kontrakt
Parametr`content_type`	Kontraktapplication/json
Parametr`required`	Kontraktmodel, prompt, duration
Parametr`material_types`	Kontrakttext, image
Parametr`additional_properties`	Kontraktfalse
Parametr`optional_controls`	Kontraktresolution, aspect_ratio, generate_audio, frame_images, input_references, seed, callback_url, session_id, trace, user

Životní cyklus: submit_once_poll_original

GET /v1/videos/{public_id}

GET /v1/videos/{public_id}/content

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í	Účtovací jednotka	Podmínky účtování	Poplatek
KonfiguraceZákladní sazby za tokeny	Tabulka sazebZákladní sazba	Předpokládané množství—	Účtovací jednotka—	Podmínky úč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ů
KonfiguraceCena videa	Tabulka sazeb—	Předpokládané množství—	Účtovací jednotkaza sekundu videa	Podmínky účtováníresolution: 1080p	Poplatek Výstup · Cena videa · Odhad pouze pro srovnání $0.4 za sekundu videa
KonfiguraceCena videa	Tabulka sazeb—	Předpokládané množství—	Účtovací jednotkaza sekundu videa	Podmínky účtováníresolution: 480p	Poplatek Výstup · Cena videa · Odhad pouze pro srovnání $0.1 za sekundu videa
KonfiguraceCena videa	Tabulka sazeb—	Předpokládané množství—	Účtovací jednotkaza sekundu videa	Podmínky účtováníresolution: 720p	Poplatek Výstup · Cena videa · Odhad pouze pro srovnání $0.2 za sekundu videa
KonfiguraceOdhadovaná cena generování	Tabulka sazeb—	Předpokládané množstvíodhad pro jedno generování	Účtovací jednotka—	Podmínky úč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í →

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

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	Podmínky účtování	Poplatek
KonfiguraceCena videa	Podmínky účtováníresolution: 480p	Poplatek Výstup · Cena videa $0.1 za sekundu videa Zveřejněná referenční cena pro zobrazenou konfiguraci. Konečné poplatky odpovídají skutečně účtované konfiguraci.
KonfiguraceCena videa	Podmínky účtováníresolution: 720p	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.
KonfiguraceCena videa	Podmínky účtováníresolution: 1080p	Poplatek Výstup · Cena videa $0.4 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

curl · vytvořte video

set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_REQUEST'
from pathlib import Path
Path('request.json').write_text('{"aspect_ratio":"16:9","duration":8,"model":"alibaba/wan-3.0","prompt":"A serene mountain landscape at sunset","resolution":"720p"}', encoding='utf-8')
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

podepsané URL obsahu spravovaného službou

GET /v1/videos/{public_id}
GET /v1/videos/{public_id}/content

Ověřit stav úlohy

Získat stav původní operace pomocí GET

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

Uložte každý dokončený výstup, který vám patří

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ždý skutečný výstup spravovaný službou a jeho vrácená metadata s naměřenými hodnotami.

Pokud je nutné ověřit původní odpověď

503 result_pending_check + původní id + X-Should-Retry:false; původní požadavek nikdy neopakujte

Pole odpovědi

Pole	Typ	Význam
Pole`index`	Typinteger	VýznamPozice tohoto videa v seznamu výstupů, číslovaná od nuly.
Pole`content_url`	Typstring	VýznamPodepsaná HTTPS URL pro stažení tohoto dokončeného videa.
Pole`sha256`	Typstring \| null	VýznamOtisk SHA-256 původních bajtů videa; null, není-li dostupný.
Pole`size_bytes`	Typinteger \| null	VýznamVelikost původního videosouboru v bajtech; null, není-li dostupná.
Pole`duration_ms`	Typinteger \| null	VýznamNaměřená délka videa v milisekundách; null, není-li dostupná.
Pole`width`	Typinteger \| null	VýznamŠířka videa v pixelech; null, není-li dostupná.
Pole`height`	Typinteger \| null	VýznamVýška videa v pixelech; null, není-li dostupná.
Pole`video_codec`	Typstring \| null	VýznamIdentifikátor video kodeku; null, není-li zaznamenán.
Pole`has_audio`	Typboolean \| null	VýznamZda video obsahuje zvukovou stopu; null, nebylo-li změřeno.
Pole`audio_codec`	Typstring \| null	VýznamIdentifikátor zvukového kodeku; null, není-li žádný identifikátor zaznamenán.

Chyby a další kroky

Odpověď	Podmínka	Další krok
Odpověď404 · `not_found_error`	PodmínkaPřístup k videu není dostupný nebo toto ID videa nebylo nalezeno.	Další krokZkontrolujte přístup k videu. U existujícího videa použijte jeho původní veřejné ID a stejný klíč API.
Odpověď401 · `authentication_error`	PodmínkaKlíč API neodpovídá ověřenému účtu.	Další krokPřed odesláním zkontrolujte svůj klíč API a přístup k účtu.
Odpověď400 · `invalid_request_error`	PodmínkaPožadavek se nepodařilo načíst nebo je index pro stažení neplatný.	Další krokOpravte tělo požadavku. Pro stažení vyberte index výstupu vrácený původní úlohou.
Odpověď422 · `price_unavailable`	PodmínkaVybranou konfiguraci videa nelze ocenit.	Další krokPřed odesláním opraveného požadavku zvolte podporovanou konfiguraci videa a vyplňte její povinné volby.
Odpověď422 · `invalid_request_error`	PodmínkaVstup videa nebo původní úloha pro pokračování jsou neplatné.	Další krokPoužívejte platné HTTPS vstupy. Pro pokračování použijte původní veřejné ID svého dokončeného videa se stejným klíčem API.
Odpověď402 · `billing_error`	PodmínkaDostupný zůstatek nebo limity neumožňují rezervaci.	Další krokPřed odesláním nového požadavku zkontrolujte dostupný zůstatek a limity.
Odpověď503 · `server_error`	PodmínkaOvěřování videa, úložiště nebo přístup ke službě jsou dočasně nedostupné.	Další krokPočkejte na dostupnost služby. Pokud už máte ID videa, kontrolujte tuto původní úlohu místo vytváření dalšího generování.
Odpověď503 · `result_pending_check`	PodmínkaPůvodní výsledek videa a vyúčtovanou částku je třeba zkontrolovat.	Další krokUchovejte vrácené ID videa a kontrolujte tuto úlohu. Dokud probíhá kontrola, neposílejte náhradní požadavek na generování.
Odpověď503 · `owned_result_unavailable`	PodmínkaStávající video je dočasně nedostupné ke stažení.	Další krokPozději zkontrolujte tutéž úlohu videa a stáhněte její existující výstup. Nové generování vytvoří samostatnou operaci.
Odpověď409 · `video_not_ready`	PodmínkaObsah videa nebyl zveřejněn.	Další krokZkontrolujte stav původní úlohy. Stáhněte výstup, až nahlásí completed; nahlásí-li failed, řiďte se jejím upozorněním na kontrolu vyúčtování.

Aliasy

Aliasy modelu

Ailoot Ultra alibaba/wan-3.0

Aliasy cest metod

Použijte cesty metod uvedené výše.

Související ID modelů

alibaba/wan-3.0

FAQ · Alibaba: Wan 3.0

Jaké vstupy a výsledky jsou dostupné?: POST /v1/videos · alibaba/wan-3.0: text, image → video
Jaká pole požadavek používá?: POST /v1/videos · alibaba/wan-3.0: model, prompt, duration, resolution, aspect_ratio, generate_audio, frame_images, input_references, seed, callback_url, session_id, trace, user
Jaké limity platí?: POST /v1/videos · alibaba/wan-3.0: duration.minimum: 1; duration.maximum: 600; frame_images.max_items: 1; frame_images.min_items: 1; seed.minimum: -9223372036854775808; seed.maximum: 9223372036854775807

Alibaba: Wan 3.0

Alibaba: Wan 3.0

Úvod

Dostupné v Ailoot · vstupy a metody

Tarify

Jak se vypočítá konečný poplatek

Odhadované sazby pro srovnání

Ceny podle konfigurace

Podrobnosti referenčního tarifu

Ceny podle konfigurace

Příklady požadavků

Ailoot Ultra · Video

Přijímání a ukládání výsledků

Ailoot Ultra · Video

Ověřit stav úlohy

Uchovejte všechny dokončené výsledky

Pokud je nutné ověřit původní odpověď

Aliasy

Aliasy modelu

Aliasy cest metod

Související ID modelů

Společnost a její portfolio projektů

Nakupujte tokeny se slevou.

Připojte API k produktu, který prodáváte.