Pular para o conteúdo

API do Mage · Modelo de vídeo

API do Melon

Anime em movimento, com áudio opcional

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

Resumo rápido

A API do Melon executa o Melon e mais 1 variante pelo Mage em POST https://api.mage.space/v1/melon/generate. Uma requisição com as configurações padrão custa 147 Gems (cerca de US$ 0,147), sem assinatura. O Melon usa personagens salvos e referências por @handle no prompt.

  • VídeoSaída
  • 2Variantes
  • 147Gems por clipe, padrão
  • $0.147Aproximadamente, em USD

Visão geral

O que a API do Melon faz

Nosso modelo de vídeo de anime, disponível como Melon e Melon Pro. Quadros inicial e final ou até 7 referências ou Characters, áudio opcional, de 3 a 16 segundos em até 1080p.

O modelo de vídeo de anime da Mage, disponível como Melon e Melon Pro, com áudio opcional.

Aceita first_image, last_image, image e additional_images como entradas.

Início rápido

Chame a API do Melon

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

cURL
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/melon/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": "4",
  "model_id": "melon"
}' | 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('melon', {
  prompt: 'A slow push-in on a lighthouse at dusk, waves breaking below',
  aspect_ratio: '16:9',
  duration: '4',
  model_id: 'melon',
});

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

mage = Mage()  # reads MAGE_API_KEY

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

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

Modelos

Valores de model_id do Melon

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

model_idNomePadrão
melonMelonSim
melon-proMelon Pro

Opções

Parâmetros do Melon

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, 9:16, 1:1, 3:4, 4:3
resolution540p, 720p, 1080p
duration3, 4, 5, 6, 8, 10, 16

Entradas

Entradas de mídia aceitas pelo Melon

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.

Regras

O que a API do Melon exige

  • Primeiro e último quadro não podem ser combinados com imagens de referência: envie um tipo ou o outro.
  • O prompt pode ter no máximo 5.000 caracteres.

Mais modelos de vídeo

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

  • Vídeo · a partir de 45 Gems

    API do MiniMax-H3

    Vídeo aberto e rápido com som estéreo

  • Vídeo · a partir de 173 Gems

    API do Plum

    Som em todos os clipes, até 2K

  • Vídeo · a partir de 360 Gems

    API do Raspberry

    Personagens ganham vida a partir de um primeiro frame

  • Vídeo · a partir de 618 Gems

    API do Seedance

    Seedance, com filtro rigoroso

  • Vídeo · a partir de 245 Gems

    API do Wan 3.0

    Wan 3.0, com filtro rigoroso

  • Vídeo · a partir de 40 Gems

    API do Wan Video v2.2

    Vídeo com pesos abertos e uma variante Lightning

Perguntas frequentes

Perguntas frequentes

Quanto custa a API do Melon?
Uma solicitação do Melon com as configurações padrão (Melon) custa 147 Gems, cerca de US$ 0,147. Outras resoluções, durações e variantes alteram o preço; a resposta informa o valor exato cobrado. Uma geração que falha é reembolsada; uma bloqueada pela política de conteúdo da Mage não é.
Qual é o endpoint da API do Melon?
POST https://api.mage.space/v1/melon/generate com um cabeçalho Authorization: Bearer contendo sua chave de API da Mage. A resposta inclui um status_url para consultar o resultado.
Quais modelos do Melon posso chamar?
melon (Melon), melon-pro (Melon Pro). O padrão é o Melon.
O Melon aceita imagens de referência ou personagens?
O Melon aceita first_image, last_image, image, additional_images. O Melon usa personagens e referências salvos por meio do @handle no prompt.
Posso usar o Melon no Claude ou no ChatGPT?
Sim. Conecte o servidor MCP da Mage ao Claude, ChatGPT, Claude Code, Grok ou Cursor e peça o Melon 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 Melon são mantidos?
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.

CharactersComunidade