Wan 3.0 Video Prime API

Używaj wan3.0-video-prime poprzez asynchroniczne API wideo APIMaster. Obecna integracja zapewnia 480P / 720P / 1080P, 2–30 sekund jako liczbę całkowitą oraz jedno wideo na zadanie. Przegląd parametrów i integracji: 2026-10-26.

Punkty końcowe i uwierzytelnianie

Operacja	Metoda i URL
Utworzenie	POST https://apimaster.ai/v1/videos
Odpytanie	GET https://apimaster.ai/v1/videos/{task_id}
Pobranie	GET https://apimaster.ai/v1/videos/{task_id}/content

Używaj Authorization: Bearer YOUR_API_KEY w każdym żądaniu oraz Content-Type: application/json podczas tworzenia zadania. Używaj klucza API APIMaster, a nie klucza Alibaba Cloud. APIMaster dostarcza nagłówek asynchroniczny upstream; nie musisz używać X-DashScope-Async.

Zgodny punkt końcowy tworzenia /videos/generations zwraca inną kopertę odpowiedzi; poniższe przykłady konsekwentnie używają /videos.

Bieżące możliwości tras

Ten model jest obecnie obsługiwany przez dwie integracje: trasę natywną Alibaba Cloud oraz trasę GMI. Zaawansowane pola wymagają odpowiedniej trasy; przesłanie pola nie wybiera tej trasy. Przed użyciem przykładów specyficznych dla trasy potwierdź, do której trasy ma dostęp Twój klucz API.

Możliwość	Natywna Alibaba Cloud	GMI
Tekst-na-wideo, pierwsza klatka, pierwsza/ostatnia klatka, obrazy referencyjne	Zintegrowane	Zintegrowane, z innymi polami multimediów
Referencyjny dźwięk	metadata.input.media	audio_url
Dokument / publiczna strona internetowa	Pola multimediów natywnych są przekazywane; nieobjęte kontrolą ukończonej generacji	Nieobsługiwane
Wideo referencyjne, edycja, rozszerzanie	Zablokowane przed przesłaniem	Nieobsługiwane
Automatyczny czas trwania -1	Zablokowane	Zablokowane
Proporcje 21:9	Akceptowane	Odrzucane
Jawny przełącznik dźwięku	generate_audio / audio	Nieobsługiwane; pomiń te pola
Wyłączanie przepisywania promptu / stały seed 0	Obecna serializacja nie zachowuje prompt_extend: false ani seed: 0; nie polegaj na nich	Jawne false i 0 są zachowywane

Ciche wideo 5-sekundowe 720P na trasie natywnej zostało pomyślnie ukończone, pobrane i zdekodowane w kontroli akceptacyjnej z 2026-10-24. Inne kombinacje multimediów są opisane na podstawie adaptera i oficjalnego kontraktu, a nie przedstawiane jako kombinacje przetestowane pod kątem generacji. Dostępność tras i ceny mogą się zmieniać; zobacz kartę modelu.

Kompletne wspólne parametry żądania

Wyślij te pola na najwyższym poziomie. Dla najszerszej zgodności używaj jawnych duration, resolution i aspect_ratio, niepustego promptu o długości do 5 000 znaków i pomiń opcje specyficzne dla trasy.

Pole	Typ	Wymagane / domyślne	Zachowanie APIMaster
model	string	Wymagane	Dokładnie wan3.0-video-prime
prompt	string	Wymagane na obu trasach	Niepuste, również przy generacji z obrazu. GMI waliduje 1–5 000 znaków; adapter natywny wymaga niepustego tekstu. Oficjalny limit natywny to 20 000; unikaj polegania na tym wyższym limicie na różnych trasach
duration	integer	5	2–30 sekund; bez -1, ułamków ani automatycznego czasu trwania
seconds	string	Opcjonalne	Alias tekstowy, np. "5"; musi być zgodny z duration, gdy podano oba
resolution	string	720P	480P, 720P, 1080P; wartości pisane małymi literami na najwyższym poziomie są normalizowane. Ten domyślny dla APIMaster różni się od oficjalnego domyślnego natywnego
aspect_ratio	string	16:9	Typowe wartości: adaptive, 16:9, 9:16, 1:1, 4:3, 3:4. 21:9 tylko na trasie natywnej
ratio	string	Opcjonalne	Alias aspect_ratio; używaj jednego pola i nie wysyłaj sprzecznych wartości
size	string	Opcjonalne	Alias wymiarów, np. 1280x720; obowiązuje walidacja specyficzna dla trasy. Preferuj resolution i aspect_ratio. GMI wymaga, aby krótszy bok odpowiadał poziomowi rozdzielczości; natywna trasa akceptuje tylko obsługiwane mapowania wymiarów
input_reference	string	Opcjonalne	URL obrazu pierwszej klatki. Dla zgodności międzytarasowej używaj publicznie pobieralnego URL HTTP(S); nie łącz z innymi wejściami pierwszej klatki
prompt_extend	boolean	Natywna true; GMI pozostawia wartość domyślną dostawcy, gdy pominięto	Przepisywanie promptu. Natywna trasa obecnie nie może niezawodnie wyłączyć tego przez false; GMI przekazuje jawną wartość logiczną
watermark	boolean	Oficjalne natywne domyślne false; GMI pozostawia wartość domyślną dostawcy, gdy pominięto	Przełącznik znaku wodnego
seed	integer	Losowy, gdy pominięto	Przenośny stały zakres: 1–2147483647. Natywna trasa akceptuje także -1 dla losowości; natywne 0 jest pomijane podczas serializacji. GMI akceptuje 0–2147483647 i odrzuca -1. Stały seed nie gwarantuje identycznego wyniku

Natywne aliasy wymiarów to 832x480, 480x832, 1280x720, 720x1280, 1920x1080 i 1080x1920 dla typowych przypadków poziomego/pionowego formatu. Niektóre mapowania wymiarów kwadratowych redukują się do 1:1; inne zmapowane wymiary mogą nadal nie przejść walidacji proporcji. Nie używaj size do żądania dowolnych wymiarów.

Tabele parametrów specyficznych dla trasy

Pola GMI

Są to pola najwyższego poziomu dodatkowo względem wspólnej tabeli. Adapter GMI odrzuca nierozpoznane pola, w tym metadata, images, image_urls, audio, generate_audio, video_urls i reference_video.

Pole	Typ	Wymagane / domyślne	Zachowanie
negative_prompt	string	Opcjonalne	Maksymalnie 500 znaków
first_frame	string	Opcjonalne	Publiczny URL obrazu HTTP(S); alternatywa dla input_reference
last_frame	string	Opcjonalne	Publiczny URL obrazu ostatniej klatki HTTP(S); podaj także pierwszą klatkę
reference_image	string lub string[]	Opcjonalne	1–10 publicznych URL obrazów referencyjnych HTTP(S); dla wielu obrazów użyj tablicy
audio_url	string	Opcjonalne	Publiczny URL referencyjnego dźwięku HTTP(S); podlega walidacji multimediów przez dostawcę

W jednym żądaniu używaj albo kontrolek klatek, albo obrazów referencyjnych. Natywne metadata.input.media nie jest tłumaczone na te pola w GMI.

Pola natywne Alibaba Cloud

Natywne ustrukturyzowane wejścia należą do metadata. Wysyłanie oficjalnych obiektów input lub parameters bezpośrednio na najwyższym poziomie nie jest kontraktem APIMaster. Zawsze zachowuj wymagany prompt najwyższego poziomu prompt.

Pole	Typ	Wymagane / domyślne	Zachowanie
generate_audio	boolean	Oficjalne natywne domyślne true	Czy dane wyjściowe zawierają ścieżkę dźwiękową; false jest zachowywane
audio	boolean	Opcjonalne	Alias generate_audio; podaj tylko jeden
images	string[]	Opcjonalne	Konwertowane na wpisy multimediów reference_image; nie są to uporządkowane pierwsze/ostatnie klatki. Nie łącz z input_reference
metadata	object	Opcjonalne	Opakowuje natywne input i parameters; nie może zmienić model
metadata.input	object	Opcjonalne	Natywny kontener danych wejściowych
metadata.input.prompt	string	Opcjonalne	Natywne nadpisanie promptu; preferuj wyłącznie prompt najwyższego poziomu
metadata.input.media	object[]	Opcjonalne	Natywna kolekcja multimediów, z type i url w każdym elemencie
metadata.input.media[].type	string	Wymagane dla każdego elementu	first_frame, last_frame, reference_image, reference_audio, file, link; reference_video jest obecnie odrzucane
metadata.input.media[].url	string	Wymagane dla każdego elementu	Lokalizacja multimediów; zalecane są publiczne URL HTTP(S). Oficjalne tymczasowe URL-e OSS wymagają osobno ważnego kontekstu przesłania upstream; APIMaster nie zapewnia tego kontekstu przesłania
metadata.parameters	object	Opcjonalne	Natywny kontener parametrów; nie może być null
metadata.parameters.resolution	string	720P	Wersalikami 480P, 720P, 1080P
metadata.parameters.ratio	string	16:9	Natywne proporcje, w tym adaptive i 21:9
metadata.parameters.duration	integer	5	2–30; bez -1
metadata.parameters.audio	boolean	Oficjalne natywne domyślne true	Przełącznik dźwięku wyjściowego
metadata.parameters.prompt_extend	boolean	true	Musi pozostać true dla file / link; jawne false ma powyższe ograniczenie serializacji
metadata.parameters.watermark	boolean	Oficjalne natywne domyślne false	Przełącznik znaku wodnego
metadata.parameters.seed	integer	Losowy	-1 lub 0–2147483647; 0 ma powyższe ograniczenie serializacji

Opcje natywne najwyższego poziomu nadpisują odpowiadające im parametry metadata. input_reference najwyższego poziomu zastępuje natywną tablicę multimediów; images dołącza wpisy obrazów referencyjnych, gdy input_reference jest nieobecne. Używaj jednego stylu wejścia i jednego stylu parametrów, aby uniknąć przypadkowych nadpisań. Nie używaj przestarzałych img_url, first_frame_url, last_frame_url ani audio_url wewnątrz natywnego input; adapter odrzuca te przestarzałe pola multimediów dla Wan 3.0.

Ograniczenia multimediów

Poniższe oficjalne natywne reguły multimediów wyjaśniają również walidację po stronie dostawcy; akceptacja URL przez adapter nie dowodzi, że multimedia są prawidłowe.

Multimedia	Limity / uwagi integracji
Pierwsza / ostatnia klatka	Maksymalnie po jednej; ostatnia klatka wymaga pierwszej klatki. Nie mieszaj kontrolek klatek z reference_image
Obrazy referencyjne	Maksymalnie 10; JPEG/JPG, PNG bez przezroczystości, BMP lub WEBP; każdy bok 240–8 000 px, proporcje co najwyżej 8:1, co najwyżej 20 MB na obraz
Referencyjny dźwięk	Natywnie: maksymalnie 5, WAV/MP3, każdy 1–15 sekund, łącznie maksymalnie 15 sekund, co najwyżej 15 MB na plik. GMI udostępnia jeden audio_url
Plik / strona internetowa	Tylko natywnie: maksymalnie jeden plik lub jedna publicznie czytelna strona; nie łącz file i link. Oficjalne formaty plików: DOCX, DOC, XLSX, XLS, PPTX, PPT, PDF, TXT, KEY, PAGES, NUMBERS, MD; co najwyżej 100 MB, z limitem 50 stron dla odpowiednich formatów stronicowanych. Zachowaj prompt_extend: true
Wideo referencyjne	Oficjalnie dostępne, ale obecnie zablokowane przez natywną walidację rozliczania APIMaster; nieudostępniane w GMI. Nie używaj tutaj przykładów edycji ani rozszerzania wideo z oficjalnego API

Oficjalny natywny limit łącznej liczby multimediów to 20 elementów; nadal obowiązują limity indywidualne i kombinacyjne. URL-e danych Base64 obrazów są częścią oficjalnego natywnego formatu wejściowego, ale nie są akceptowane przez walidację URL GMI. Na różnych trasach preferuj pobieralne URL-e HTTP(S).

Przykłady

Tekst-na-wideo, wspólne pola

curl "https://apimaster.ai/v1/videos" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"wan3.0-video-prime","prompt":"A paper boat drifting across a quiet pond at sunrise, gentle camera movement.","duration":5,"resolution":"720P","aspect_ratio":"16:9"}'

Pierwsza klatka, wspólne pola

{"model":"wan3.0-video-prime","prompt":"The boat moves slowly forward, with soft ripples.","input_reference":"https://example.com/boat.png","duration":5,"resolution":"720P","aspect_ratio":"16:9"}

GMI pierwsza / ostatnia klatka

{"model":"wan3.0-video-prime","prompt":"Move smoothly from the first frame to the last frame.","first_frame":"https://example.com/start.png","last_frame":"https://example.com/end.png","duration":5,"resolution":"720P","prompt_extend":false,"seed":0}

Natywna pierwsza / ostatnia klatka i ciche wyjście

{"model":"wan3.0-video-prime","prompt":"Move smoothly from the first frame to the last frame.","duration":5,"resolution":"720P","generate_audio":false,"metadata":{"input":{"media":[{"type":"first_frame","url":"https://example.com/start.png"},{"type":"last_frame","url":"https://example.com/end.png"}]}}}

Natywny obraz referencyjny i dźwięk

{"model":"wan3.0-video-prime","prompt":"Animate the character in image 1, with the mood of audio 1.","duration":5,"resolution":"720P","metadata":{"input":{"media":[{"type":"reference_image","url":"https://example.com/character.png"},{"type":"reference_audio","url":"https://example.com/music.mp3"}]}}}

Zastąp przykładowe URL-e multimediów rzeczywistymi publicznymi plikami. Przykłady specyficzne dla trasy wymagają pasującej trasy i nadal podlegają kontrolom kombinacji upstream.

Odpowiedź, odpytywanie i pobieranie

Tworzenie zwraca identyfikator zadania APIMaster, na przykład:

{"id":"task_example","task_id":"task_example","object":"video","model":"wan3.0-video-prime","status":"queued"}

Pole	Znaczenie
id / task_id	Identyfikator zadania APIMaster, a nie identyfikator zadania upstream
status	queued, in_progress, completed, failed
progress	Zgłaszany postęp; nie jest gwarancją ukończenia
error.code / error.message	Szczegóły błędu, gdy mają zastosowanie
metadata.url	Uwierzytelniony adres treści zwracany przy ukończeniu

Odpytuj co 10–20 sekund z tym samym kluczem API, aż do statusu końcowego; pomyślne utworzenie oznacza jedynie akceptację. Generacja może potrwać kilka minut. Odpytuj zaakceptowane zadanie zamiast wielokrotnego tworzenia płatnych zadań.

curl "https://apimaster.ai/v1/videos/task_example" -H "Authorization: Bearer YOUR_API_KEY"
curl -L "https://apimaster.ai/v1/videos/task_example/content" \
  -H "Authorization: Bearer YOUR_API_KEY" -o wan-prime.mp4

Pobierz i zapisz ukończone wideo niezwłocznie; URL-e wyników upstream mogą wygasnąć. Powtarzane odpytywanie nie tworzy dodatkowej opłaty za generację.

Rozliczanie i typowe błędy

Rozliczanie odbywa się za sekundę przy żądanej rozdzielczości, z cenami trasy/konta pokazanymi na karcie modelu. Przesłanie rezerwuje szacowaną opłatę. Natywne ukończenie używa zwróconego czasu trwania podlegającego rozliczeniu i zamrożonej ceny przesłania; GMI stosuje kontrakt zarezerwowanego czasu trwania. Nieudane zadania zwalniają/zwracają swoją rezerwację generacji. Wyłączony dźwięk nie oznacza tańszego poziomu. Użyj dziennika użycia dla ostatecznej kwoty.

Błąd / objaw	Działanie
duration must be an integer from 2 to 30	Użyj jawnej liczby całkowitej; -1 nie jest zintegrowane
unsupported Wan request field ...	Usuń pole nieobsługiwane przez GMI lub potwierdź dostęp do pasującej trasy natywnej
unsupported aspect ratio	Użyj typowych proporcji; 21:9 wymaga trasy natywnej
reference video requires an input-duration quote	Usuń wideo referencyjne; ta możliwość jest obecnie zablokowana
prompt is required / błąd pobierania multimediów	Dodaj tekst najwyższego poziomu; użyj publicznie pobieralnych, prawidłowych multimediów
prompt_extend: false lub seed: 0 nie ma efektu na trasie natywnej	Obecne ograniczenie serializacji; użyj dodatniego seeda i nie polegaj na wyłączaniu przepisywania

Źródła: oficjalne informacje o modelu, oficjalna dokumentacja natywnego API oraz oficjalny przewodnik użytkowania. Oficjalna możliwość nie oznacza, że to samo pole jest udostępniane na każdej trasie APIMaster.