API wideo Wan 3.0
Parametry, kombinacje multimediów, zadania asynchroniczne, pobieranie i rozliczanie za sekundę dla wan3.0-video w APIMaster.
API wideo Wan 3.0
wan3.0-video to standardowy model Wan 3; jest to osobny model od wan3.0-video-prime. Obsługuje tekst, obrazy, wideo, dźwięk, dokumenty oraz publiczne strony internetowe. Każde udane zadanie generuje jedno wideo MP4/H.264 o długości do 30 sekund. Integracja zweryfikowana: 2026-11-17.
Jedno żądanie obsługuje maksymalnie 20 elementów multimedialnych łącznie. Wygenerowany film ma 30 fps.
Punkty końcowe i uwierzytelnianie
| Operacja | Punkt końcowy |
|---|---|
| Tworzenie | POST https://apimaster.ai/v1/videos |
| Zapytanie | GET https://apimaster.ai/v1/videos/{task_id} |
| Pobieranie | GET https://apimaster.ai/v1/videos/{task_id}/content |
Authorization: Bearer YOUR_API_KEY · Content-Type: application/json
Wszystkie parametry żądania
Używaj jednego formatu mediów w żądaniu. Użyj metadata.input.media dla mieszanych mediów referencyjnych lub dokumentów.
| Parametr | Typ | Wymagany / domyślny | Znaczenie i prawidłowe wartości |
|---|---|---|---|
model |
string | Wymagany | Dokładnie wan3.0-video; nie należy zastępować wartością Prime |
prompt |
string | Wymagany | Opisz wynik po chińsku lub angielsku; oficjalny limit 20 000 znaków, dłuższy tekst natywny jest obcinany. Odwołuj się do Image 1, Video 1, Audio 1 w kolejności multimediów; każdy typ multimediów ma własną numerację |
duration |
integer | 5 |
2–30 sekund wyjściowych; -1 pozwala modelowi wybrać czas trwania. Przy wideo referencyjnym czas wejściowy plus wyjściowy nie może przekroczyć 30 sekund |
seconds |
string | Opcjonalny | Alias czasu trwania, np. "5" lub "-1"; musi być zgodny z duration, gdy oba są podane |
resolution |
string | 1080P |
480P, 720P, 1080P; wartości najwyższego poziomu pisane małymi literami są normalizowane |
aspect_ratio |
string | adaptive |
adaptive, 21:9, 16:9, 4:3, 1:1, 3:4, 9:16 |
ratio |
string | Opcjonalny | Alias dla aspect_ratio; przy przedłużaniu wideo zalecana jest wartość adaptive |
size |
string | Opcjonalny | Alias zgodności: poziom rozdzielczości lub obsługiwane odwzorowanie pikseli, np. 1280x720; preferuj jawne podanie rozdzielczości i proporcji, a nie dowolne rozmiary pikseli |
generate_audio |
boolean | true po stronie nadrzędnej |
Czy wynik zawiera ścieżkę audio. Jawne false jest zachowywane. Dźwięk nie zmienia stawki za sekundę |
audio |
boolean | Opcjonalny | Alias dla generate_audio; używaj jednego przełącznika audio |
prompt_extend |
boolean | true |
Inteligentne przepisywanie promptu; jawne false jest zachowywane. Musi być true dla wejścia dokumentowego/stronowego |
watermark |
boolean | false po stronie nadrzędnej |
Dodaj znak wodny do wyniku; jawne false jest zachowywane |
seed |
integer | Losowy | -1 lub 0–2147483647. Pominięcie lub -1 oznacza żądanie losowego ziarna; 0 jest przekazywane. Powtórzone ziarna nie gwarantują identycznego wyniku |
input_reference |
string | Opcjonalny | URL obrazu pierwszej klatki; zastępuje natywną tablicę multimediów. Nie mieszaj stylów wejścia |
images |
string[] | Opcjonalny | Tablica ułatwiająca, dołączana jako elementy reference_image, gdy input_reference jest nieobecny |
metadata |
object | Opcjonalny | Kontener dla poniższych obiektów natywnych; nie może zmienić wybranego modelu |
metadata.input |
object | Opcjonalny | Natywny obiekt wejściowy |
metadata.input.prompt |
string | Opcjonalny | Natywne nadpisanie promptu; zachowaj wymagany prompt najwyższego poziomu |
metadata.input.media |
object[] | Opcjonalny | Uporządkowana tablica multimediów. Każdy element wymaga type i url; patrz limity poniżej |
metadata.input.media[].type |
string | Wymagany dla każdego elementu | first_frame, last_frame, reference_image, reference_video, reference_audio, file, link |
metadata.input.media[].url |
string | Wymagany dla każdego elementu | Publiczny URL multimediów HTTP(S); typy obrazów akceptują także ciąg data:{MIME_type};base64,.... Multimedia nieobrazowe wymagają publicznego URL |
metadata.parameters |
object | Opcjonalny | Natywny obiekt parametrów; nie może być null |
metadata.parameters.resolution |
string | 1080P |
Wielkie litery 480P, 720P, 1080P |
metadata.parameters.ratio |
string | adaptive |
Te same wartości proporcji obrazu, co wymienione powyżej |
metadata.parameters.duration |
integer | 5 |
2–30 lub -1; to samo ograniczenie łącznego czasu trwania |
metadata.parameters.audio |
boolean | true po stronie nadrzędnej |
Ten sam przełącznik audio wyjścia |
metadata.parameters.prompt_extend |
boolean | true |
Ten sam przełącznik przepisywania promptu; file/link wymaga true |
metadata.parameters.watermark |
boolean | false po stronie nadrzędnej |
Ten sam przełącznik znaku wodnego |
metadata.parameters.seed |
integer | Losowy | Ten sam zakres ziarna, w tym jawne 0 |
Natywne pola negative_prompt, img_url, first_frame_url, last_frame_url i audio_url nie są mechanizmami kontroli multimediów Wan 3. Należy zamiast tego użyć udokumentowanej tablicy multimediów.
Limity multimediów i prawidłowe kombinacje
| Typ multimediów | Liczba i ograniczenia |
|---|---|
first_frame, last_frame |
Co najwyżej po jednym każdy. Ostatnia klatka wymaga pierwszej klatki. Formantów klatek nie można łączyć z żadnym typem referencji, pliku ani linku |
reference_image |
Co najwyżej 10. JPEG/JPG, PNG bez przezroczystości, BMP lub WEBP; każdy bok 240–8,000 pikseli, współczynnik proporcji maksymalnie 8:1, każdy plik maksymalnie 20 MB |
reference_video |
Co najwyżej 5 klipów MP4/MOV; każdy 1–15 sekund, łączny wkład maksymalnie 15 sekund; co najmniej 16 fps; każdy bok 240–4,096 pikseli, współczynnik proporcji maksymalnie 8:1, każdy plik maksymalnie 100 MB |
reference_audio |
Co najwyżej 5 klipów WAV/MP3; każdy 1–15 sekund, łącznie maksymalnie 15 sekund; każdy plik maksymalnie 15 MB |
file |
Co najwyżej jeden plik DOCX/DOC/XLSX/XLS/PPTX/PPT/PDF/TXT/KEY/PAGES/NUMBERS/MD; maksymalnie 100 MB. Dokumenty stronicowe PDF, DOCX, DOC, PPTX, PPT oraz KEY/PAGES mają limit 50 stron |
link |
Co najwyżej jedna publicznie dostępna strona bez logowania; nie łączyć z file |
Obrazy, wideo i audio referencyjne można łączyć. Plik lub link może towarzyszyć multimediom referencyjnym. Tryb pierwszej/ostatniej klatki akceptuje wyłącznie formanty klatek; w przypadku generowania sterowanego dźwiękiem należy użyć trybu obraz referencyjny plus audio referencyjne. Analiza multimediów i moderacja treści nadal podlegają kontroli po stronie usług nadrzędnych.
Generowanie wideo z tekstu wykorzystuje prompt bez multimediów. Animacja z pierwszej klatki używa first_frame; przejścia używają first_frame plus last_frame. Generowanie referencyjne wykorzystuje typy referencyjne. W celu edycji lub rozszerzenia należy podać reference_video i opisać edycję lub rozszerzenie w prompcie; do rozszerzenia używaj adaptive.
Przykłady
Tekst na wideo
curl "https://apimaster.ai/v1/videos" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"wan3.0-video","prompt":"A paper boat drifting on a quiet pond, static camera.","duration":2,"resolution":"480P","aspect_ratio":"16:9","generate_audio":false,"prompt_extend":false,"watermark":false,"seed":0}'
Pierwsza i ostatnia klatka
{"model":"wan3.0-video","prompt":"Move smoothly from the first frame to the last.","duration":5,"resolution":"720P","metadata":{"input":{"media":[{"type":"first_frame","url":"https://example.com/start.png"},{"type":"last_frame","url":"https://example.com/end.png"}]}}}
Obraz referencyjny i dźwięk
{"model":"wan3.0-video","prompt":"Animate Image 1 to the rhythm 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"}]}}}
Edycja / rozszerzanie wideo i inteligentne dopasowanie czasu trwania
{"model":"wan3.0-video","prompt":"Extend Video 1 forward as the camera follows the paper boat.","duration":-1,"resolution":"480P","aspect_ratio":"adaptive","metadata":{"input":{"media":[{"type":"reference_video","url":"https://example.com/input.mp4"}]}}}
Dokument / strona internetowa
{"model":"wan3.0-video","prompt":"Create a product introduction based on this document.","duration":10,"resolution":"720P","prompt_extend":true,"metadata":{"input":{"media":[{"type":"file","url":"https://example.com/product.pdf"}]}}}
Zastąp wszystkie przykładowe adresy URL rzeczywistymi publicznymi materiałami. W przypadku danych wejściowych z sieci zastąp element pliku przez {"type":"link","url":"https://example.com/product"}. Przykład z pierwszą klatką działa również bez elementu ostatniej klatki.
Odpowiedzi, odpytywanie, pobieranie i logi
Utworzenie zwraca identyfikator zadania APIMaster, a nie identyfikator upstream:
{"id":"task_example","task_id":"task_example","object":"video","model":"wan3.0-video","status":"queued"}
| Pole odpowiedzi | Znaczenie |
|---|---|
id / task_id |
Identyfikator zadania platformy używany przez zapytanie i pobieranie |
status |
queued, in_progress, completed, failed |
progress |
Wskaźnik postępu; należy czekać na status końcowy |
error.code, error.message |
Informacje o błędzie, jeśli mają zastosowanie |
metadata.url |
Lokalizacja treści zwracana po ukończeniu |
Odpytywaj mniej więcej co 15 sekund, używając tego samego klucza API. Nie twórz kolejnego zadania, aby sprawdzić postęp. Identyfikatory zadań i adresy URL wyników natywnego dostawcy wygasają po 24 godzinach; pobieraj i przechowuj udane wyniki niezwłocznie. Uwierzytelniony punkt końcowy treści APIMaster jest preferowany zamiast przechowywania tymczasowych adresów URL upstream.
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 wan3.mp4
Dziennik użycia zawiera zadanie i pomyślny wynik wideo. Sprawdź ostateczne obciążenie po ukończeniu; akceptacja nie jest dowodem pomyślnego wygenerowania. Wielokrotne odpytywanie nie powoduje naliczenia kolejnej opłaty za generowanie.
Rozliczenia
Stawki sekundowe znajdziesz na karcie modelu.
APIMaster sumuje czas wszystkich filmów wejściowych i filmu wyjściowego, raz zaokrągla sumę w górę do pełnej sekundy i mnoży ją przez stawkę sekundową wybranej rozdzielczości wyjściowej. Za 2,3 s wejścia i 5 s wyjścia naliczana jest opłata za 8 s. Bez filmu wejściowego rozliczany jest tylko czas wyjścia. Wycena i podawanie długości wejścia są zbędne. W razie niepowodzenia rezerwacja środków zostaje zwolniona. Końcowa kwota jest w dzienniku użycia.
Błędy i poprawki
| Objaw | Poprawka |
|---|---|
| Nieprawidłowy czas trwania/rozdzielczość/proporcje | Użyj powyższego wyliczenia (enum) i zakresów; inteligentny czas trwania wynosi dokładnie -1 |
| Konflikt klatki/referencji, ostatnia klatka bez pierwszej | Postępuj zgodnie z regułami kombinacji |
| Plik/link oraz wyłączone przepisywanie | Ustaw prompt_extend:true |
| Błąd pobierania/formatowania/czasu trwania multimediów | Użyj publicznych plików, które spełniają wszystkie ograniczenia dotyczące rozmiaru, formatu i czasu trwania |
Brakujący prompt |
Zachowaj niepusty prompt najwyższego poziomu dla APIMaster API |
| Zadanie nie powiodło się lub zostało poddane moderacji | Sprawdź error, następnie popraw żądanie; nie traktuj przyjęcia jako sukcesu |
