Przejdź do treści

Mage API · Model wideo

Wan 3.0 API

Wan 3.0, z rygorystycznym filtrem

POST https://api.mage.space/v1/wan_3/generate

W skrócie

Wan 3.0 API uruchamia Wan 3.0 przez Mage pod adresem POST https://api.mage.space/v1/wan_3/generate. Żądanie z ustawieniami domyślnymi kosztuje 245 Gems (ok. 0,245 $), bez subskrypcji. Wan 3.0 przyjmuje zapisane postacie, referencje i referencje audio podawane w prompcie przez @handle.

  • WideoWynik
  • 1Wariant
  • 245Gems za klip, domyślnie
  • $0.245Około, w USD

Przegląd

Co potrafi Wan 3.0 API

Uniwersalny Wan 3.0 od Alibaby. Klatka początkowa i końcowa, do 10 referencji lub Characters, Voices i dźwięk oraz klipy od 2 do 30 sekund w rozdzielczości do 1080p. Rygorystyczny filtr: obowiązuje filtr treści dostawcy.

Wan 3.0 od Alibaba to jeden model wideo do tekstu, klatek, obrazów referencyjnych, filmów referencyjnych i Voices, tworzący klipy od 2 do 30 sekund z generowanym dźwiękiem. Ścisły filtr: filtr treści dostawcy sprawdza prompt, wgrane materiały i gotowe wideo; zapytanie, które zostanie odrzucone, kończy się błędem `content_blocked` z podaniem powodu, a koszt jest zwracany.

Jako dane wejściowe przyjmuje first_image, last_image, image, additional_images, videos.

Szybki start

Wywołaj Wan 3.0 API

Ustaw MAGE_API_KEY, wyślij żądanie do /wan_3/generate i odpytuj status_url, aż żądanie zostanie zakończone.

cURL
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/wan_3/generate' \
  --header "Authorization: Bearer $MAGE_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "prompt": "A slow push-in on a lighthouse at dusk, waves breaking below",
  "aspect_ratio": "16:9",
  "duration": "3",
  "model_id": "wan-3.0"
}' | jq -r '.status_url')

# Repeat until status is "completed"; result.url is the file
curl "$STATUS_URL" --header "Authorization: Bearer $MAGE_API_KEY"
TypeScript
// npm install @mage-space/sdk
import Mage from '@mage-space/sdk';

const mage = new Mage(); // reads MAGE_API_KEY

const request = await mage.run('wan_3', {
  prompt: 'A slow push-in on a lighthouse at dusk, waves breaking below',
  aspect_ratio: '16:9',
  duration: '3',
  model_id: 'wan-3.0',
});

console.log(request.result.url);
Python
# pip install mage-space
from mage_space import Mage

mage = Mage()  # reads MAGE_API_KEY

request = mage.run("wan_3", {
    "prompt": "A slow push-in on a lighthouse at dusk, waves breaking below",
    "aspect_ratio": "16:9",
    "duration": "3",
    "model_id": "wan-3.0",
})

print(request["result"]["url"])

Modele

Wartości model_id dla Wan 3.0

Wyślij model_id, aby wybrać wariant. Zapytanie bez niego użyje wariantu domyślnego.

model_idNazwaDomyślny
wan-3.0Wan 3.0Tak

Opcje

Parametry Wan 3.0

Dozwolone wartości dla wszystkich wariantów; dany wariant może oferować mniej. Opcje dla poszczególnych wariantów znajdziesz w dokumentacji.

PoleWartości
aspect_ratio16:9, 4:3, 1:1, 3:4, 9:16
resolution480p, 720p, 1080p
duration2, 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

Dane wejściowe

Pliki wejściowe obsługiwane przez Wan 3.0

Każdy wyślij jako URL https, data URL lub plik o rozmiarze do 100 MB.

PoleRola
first_imageObraz pierwszej klatki.
last_imageObraz ostatniej klatki.
imageObraz referencyjny.
additional_imagesDodatkowe obrazy referencyjne.
videosWideo źródłowe.

Zasady

Co egzekwuje Wan 3.0 API

  • Pierwszej i ostatniej klatki nie można łączyć z obrazami ani filmami referencyjnymi: wyślij jedno albo drugie.
  • Do 10 obrazów referencyjnych i 5 filmów referencyjnych.
  • Każdy film referencyjny trwa od 1 do 15 sekund, łącznie maksymalnie 15 sekund, a suma ich długości i `duration` nie może przekraczać 30 sekund. Sekundy filmów referencyjnych są rozliczane tak samo jak sekundy wyniku.

Więcej modeli wideo

Inne API do generowania wideo w Mage

  • Wideo · od 40 Gems

    Wan Video v2.2 API

    Wideo z otwartymi wagami i wariantem Lightning

  • Wideo · od 189 Gems

    Berry API

    Wideo wierne Twoim referencjom

  • Wideo · od 360 Gems

    Blueberry API

    Ustaw pierwszą i ostatnią klatkę

  • Wideo · od 618 Gems

    Cherry API

    Nasza flagowa rodzina modeli wideo

  • Wideo · od 375 Gems

    Grok Video API

    Grok Imagine w ruchu

  • Wideo · od 270 Gems

    Kiwi API

    Wideo na co dzień, bez konfiguracji

FAQ

Najczęściej zadawane pytania

Ile kosztuje Wan 3.0 API?
Żądanie Wan 3.0 z ustawieniami domyślnymi (Wan 3.0) kosztuje 245 Gems, czyli ok. 0,245 $. Inne rozdzielczości, czasy trwania i warianty zmieniają cenę; dokładną opłatę podaje odpowiedź. Nieudana generacja jest zwracana; zablokowana przez zasady treści Mage nie jest.
Jaki jest endpoint Wan 3.0 API?
POST https://api.mage.space/v1/wan_3/generate z nagłówkiem Authorization: Bearer zawierającym Twój klucz API Mage. Odpowiedź zawiera status_url, który odpytujesz, aby pobrać wynik.
Które modele Wan 3.0 mogę wywołać?
wan-3.0 (Wan 3.0). Domyślny to Wan 3.0.
Czy Wan 3.0 obsługuje obrazy referencyjne lub postacie?
Wan 3.0 przyjmuje first_image, last_image, image, additional_images, videos. Wan 3.0 przyjmuje zapisane postacie, referencje i referencje audio podawane w prompcie przez @handle.
Czy mogę używać Wan 3.0 w Claude lub ChatGPT?
Tak. Połącz serwer MCP Mage z Claude, ChatGPT, Claude Code, Grok lub Cursor i poproś o Wan 3.0 po nazwie. Twój asystent odczyta jego opcje przez get_model i poda cenę przed wygenerowaniem.
Jak długo przechowywane są wyniki Wan 3.0?
Wyniki i dane wejściowe są przechowywane przez 30 dni. Wszystko, co chcesz zachować, pobierz na własny dysk.

Zacznij tworzyć z Mage

Jedno konto, jedno saldo Gems, wszystkie modele. Płacisz tylko za to, co wygenerujesz.