Перейти к содержимому

Mage API · Модель для видео

Wan 3.0 API

Wan 3.0 со строгим фильтром

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

Главное

Wan 3.0 API запускает Wan 3.0 через Mage по адресу POST https://api.mage.space/v1/wan_3/generate. Запрос с настройками по умолчанию стоит 245 Gems (около $0.245), без подписки. Wan 3.0 принимает сохранённых персонажей, референсы и аудиореференсы по @handle в промпте.

  • ВидеоРезультат
  • 1Вариант
  • 245Gems за клип, по умолчанию
  • $0.245Примерно, в USD

Обзор

Что умеет Wan 3.0 API

Универсальная модель Wan 3.0 от Alibaba. Начальный и конечный кадры, до 10 референсов или Characters, Voices и аудио, ролики от 2 до 30 секунд в разрешении до 1080p. Строгий фильтр: действует фильтр контента провайдера.

Wan 3.0 от Alibaba — одна видеомодель для текста, кадров, референсных изображений, референсных видео и Voices. Создаёт клипы длиной от 2 до 30 секунд со сгенерированным звуком. Строгий фильтр: фильтр контента провайдера проверяет промпт, исходные медиафайлы и готовое видео; если запрос отклонён, он завершается ошибкой `content_blocked` с указанием причины, а потраченное возвращается.

На вход принимает first_image, last_image, image, additional_images, videos.

Быстрый старт

Как вызвать Wan 3.0 API

Задайте MAGE_API_KEY, отправьте запрос на /wan_3/generate и опрашивайте status_url, пока запрос не завершится.

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"])

Модели

Значения model_id для Wan 3.0

Передайте model_id, чтобы выбрать вариант. Запрос без него использует вариант по умолчанию.

model_idНазваниеПо умолчанию
wan-3.0Wan 3.0Да

Параметры

Параметры Wan 3.0

Допустимые значения для всех вариантов; у отдельного варианта их может быть меньше. Параметры каждого варианта перечислены в документации.

ПолеЗначения
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

Входные данные

Какие медиафайлы принимает Wan 3.0

Передавайте каждый файл как https-ссылку, data URL или загрузку размером до 100 МБ.

ПолеРоль
first_imageИзображение первого кадра.
last_imageИзображение последнего кадра.
imageРеференсное изображение.
additional_imagesДополнительные референсные изображения.
videosИсходные видео.

Правила

Какие ограничения действуют в Wan 3.0 API

  • Первый и последний кадры нельзя сочетать с референсными изображениями или видео: отправляйте что-то одно.
  • До 10 референсных изображений и 5 референсных видео.
  • Каждое референсное видео длится от 1 до 15 секунд, в сумме не более 15 секунд, а суммарная длина вместе с `duration` не превышает 30 секунд. Секунды референсных видео тарифицируются так же, как секунды результата.

Другие видеомодели

Другие API для генерации видео в Mage

  • Видео · от 40 Gems

    Wan Video v2.2 API

    Видеомодель с открытыми весами и вариантом Lightning

  • Видео · от 189 Gems

    Berry API

    Видео, которое остаётся верным вашим референсам

  • Видео · от 360 Gems

    Blueberry API

    Закрепите первый и последний кадр

  • Видео · от 618 Gems

    Cherry API

    Наше флагманское семейство моделей для видео

  • Видео · от 375 Gems

    Grok Video API

    Grok Imagine в движении

  • Видео · от 270 Gems

    Kiwi API

    Повседневное видео без настройки

FAQ

Частые вопросы

Сколько стоит Wan 3.0 API?
Запрос к Wan 3.0 с настройками по умолчанию (Wan 3.0) стоит 245 Gems, около $0.245. Другие разрешения, длительности и варианты меняют цену; точная сумма списания указана в ответе. Если генерация завершилась ошибкой, Gems возвращаются; если её заблокировала политика контента Mage — нет.
Какой эндпоинт у Wan 3.0 API?
POST https://api.mage.space/v1/wan_3/generate с заголовком Authorization: Bearer, содержащим ваш API-ключ Mage. В ответе приходит status_url, по которому нужно опрашивать результат.
Какие модели Wan 3.0 можно вызвать?
wan-3.0 (Wan 3.0). По умолчанию используется Wan 3.0.
Поддерживает ли Wan 3.0 референсные изображения и персонажей?
Wan 3.0 принимает first_image, last_image, image, additional_images, videos. Также Wan 3.0 принимает сохранённых персонажей, референсы и аудиореференсы по @handle в промпте.
Можно ли использовать Wan 3.0 из Claude или ChatGPT?
Да. Подключите MCP-сервер Mage к Claude, ChatGPT, Claude Code, Grok или Cursor и просто назовите Wan 3.0. Ваш ассистент прочитает доступные параметры через get_model и назовёт цену до генерации.
Как долго хранятся результаты Wan 3.0?
Результаты и входные файлы хранятся 30 дней. Всё, что нужно сохранить, скачайте в своё хранилище.

Начните создавать с Mage

Один аккаунт, один баланс Gems, все модели. Платите только за то, что генерируете.