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ídeo
Saída
2
Variantes
147
Gems por clipe, padrão
$0.147
Aproximadamente, 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_id | Nome | Padrão |
|---|---|---|
| melon | Melon | Sim |
| melon-pro | Melon 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.
| Campo | Valores |
|---|---|
| aspect_ratio | 16:9, 9:16, 1:1, 3:4, 4:3 |
| resolution | 540p, 720p, 1080p |
| duration | 3, 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.
| Campo | Função |
|---|---|
| first_image | A imagem do primeiro frame. |
| last_image | A imagem do último frame. |
| image | A imagem de referência. |
| additional_images | Imagens 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.
Mais modelos de vídeo
Outras APIs de geração de vídeo no Mage
Vídeo · a partir de 30 Gems
API do MiniMax-H3
Vídeo aberto e rápido com som estéreo
Vídeo · a partir de 338 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 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
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.