APIMaster.ai

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