Pular para o conteúdo

API do Mage · Modelo de vídeo

API do Wan 3.0

Wan 3.0, com filtro rigoroso

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

Resumo rápido

A API do Wan 3.0 executa o Wan 3.0 pelo Mage em POST https://api.mage.space/v1/wan_3/generate. Uma requisição com as configurações padrão custa 245 Gems (cerca de US$ 0,245), sem assinatura. O Wan 3.0 aceita personagens salvos, referências e referências de áudio pelo @handle no prompt.

  • VídeoSaída
  • 1Variante
  • 245Gems por clipe, padrão
  • $0.245Aproximadamente, em USD

Visão geral

O que a API do Wan 3.0 faz

O Wan 3.0 completo da Alibaba. Frames inicial e final, até 10 referências ou Characters, Voices e áudio, e clipes de 2 a 30 segundos em até 1080p. Filtro rigoroso: vale o filtro de conteúdo do provedor.

O Wan 3.0, da Alibaba, um único modelo de vídeo para texto, frames, imagens de referência, vídeos de referência e Voices, em clipes de 2 a 30 segundos com áudio gerado. Filtro rigoroso: o filtro de conteúdo do provedor analisa o prompt, as mídias de entrada e o vídeo finalizado; uma solicitação recusada por ele falha com `content_blocked` e um motivo, e o valor é reembolsado.

Aceita first_image, last_image, image, additional_images, videos como entrada.

Início rápido

Como chamar a API do Wan 3.0

Defina MAGE_API_KEY, envie para /wan_3/generate e consulte status_url até a requisição ser concluída.

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

Modelos

Valores de model_id do Wan 3.0

Envie model_id para escolher uma variante. Uma solicitação sem ele usa a padrão.

model_idNomePadrão
wan-3.0Wan 3.0Sim

Opções

Parâmetros do Wan 3.0

Valores permitidos em todas as variantes; uma variante pode oferecer menos. A documentação lista as opções de cada variante.

CampoValores
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

Entradas

Mídias aceitas pelo Wan 3.0

Envie cada uma como URL https, data URL ou upload de até 100 MB.

CampoFunção
first_imageA imagem do primeiro frame.
last_imageA imagem do último frame.
imageA imagem de referência.
additional_imagesImagens de referência adicionais.
videosOs vídeos de origem.

Regras

O que a API do Wan 3.0 impõe

  • Primeiro e último quadros não podem ser combinados com imagens ou vídeos de referência: envie apenas um tipo ou o outro.
  • Até 10 imagens de referência e 5 vídeos de referência.
  • Cada vídeo de referência tem de 1 a 15 segundos, no máximo 15 segundos no total, e a duração combinada somada a `duration` deve ser de no máximo 30 segundos. Os segundos dos vídeos de referência são cobrados como os segundos de saída.

Mais modelos de vídeo

Outras APIs de geração de vídeo no Mage

  • Vídeo · a partir de 40 Gems

    API do Wan Video v2.2

    Vídeo com pesos abertos e uma variante Lightning

  • Vídeo · a partir de 189 Gems

    API do Berry

    Vídeo fiel às suas referências

  • Vídeo · a partir de 360 Gems

    API do Blueberry

    Fixe o primeiro e o último frame

  • Vídeo · a partir de 618 Gems

    API do Cherry

    Nossa família de vídeos principal

  • Vídeo · a partir de 375 Gems

    API do Grok Video

    Grok Imagine em movimento

  • Vídeo · a partir de 270 Gems

    API do Kiwi

    Vídeo do dia a dia, sem configuração

Perguntas frequentes

Perguntas frequentes

Quanto custa a API do Wan 3.0?
Uma requisição do Wan 3.0 com as configurações padrão (Wan 3.0) custa 245 Gems, cerca de US$ 0,245. Outras resoluções, durações e variantes mudam o preço; a resposta informa o valor exato cobrado. Uma geração que falha é reembolsada; uma bloqueada pela política de conteúdo do Mage não é.
Qual é o endpoint da API do Wan 3.0?
POST https://api.mage.space/v1/wan_3/generate com um cabeçalho Authorization: Bearer contendo sua chave de API do Mage. A resposta inclui um status_url para consultar o resultado.
Quais modelos do Wan 3.0 posso chamar?
wan-3.0 (Wan 3.0). O padrão é o Wan 3.0.
O Wan 3.0 aceita imagens de referência ou personagens?
O Wan 3.0 aceita first_image, last_image, image, additional_images, videos. O Wan 3.0 aceita personagens salvos, referências e referências de áudio pelo @handle no prompt.
Posso usar o Wan 3.0 no Claude ou no ChatGPT?
Sim. Conecte o servidor MCP do Mage ao Claude, ChatGPT, Claude Code, Grok ou Cursor e peça o Wan 3.0 pelo nome. Seu assistente lê as opções com get_model e informa o preço antes de gerar.
Por quanto tempo os resultados do Wan 3.0 ficam salvos?
Resultados e entradas ficam salvos por 30 dias. Baixe o que quiser guardar para o seu próprio armazenamento.

Comece a criar com o Mage

Uma conta, um saldo de Gems, todos os modelos. Pague apenas pelo que você gerar.