Pular para o conteúdo

API do Mage · Modelo de vídeo

API do Lemon

Todos os recursos de vídeo por um preço mais amigável

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

Resumo rápido

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

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

Visão geral

O que a API do Lemon faz

Nosso modelo de vídeo completo. Frames inicial e final, até 10 referências ou Characters, Voices e áudio, e clipes de 2 a 30 segundos em até 1080p.

O modelo de vídeo completo do Mage por um preço mais amigável: frames, referências, Voices, áudio gerado e clipes de 2 a 30 segundos.

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

Início rápido

Chame a API do Lemon

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

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

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

mage = Mage()  # reads MAGE_API_KEY

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

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

Modelos

Valores de model_id do Lemon

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

model_idNomePadrão
lemonLemonSim

Opções

Parâmetros do Lemon

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

Entradas de mídia aceitas pelo Lemon

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 Lemon exige

  • 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 20 Gems

    API do LTX Video

    Vídeo open-weights rápido para iterar

  • Vídeo · a partir de 1.856 Gems

    API Magejutsu

    Refaça qualquer vídeo mantendo o movimento

  • Vídeo · a partir de 147 Gems

    API do Melon

    Anime em movimento, com áudio opcional

  • 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

Perguntas frequentes

Perguntas frequentes

Quanto custa a API do Lemon?
Uma requisição do Lemon com as configurações padrão (Lemon) custa 245 Gems, cerca de US$ 0,245. 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 do Mage não é.
Qual é o endpoint da API do Lemon?
POST https://api.mage.space/v1/lemon/generate com um cabeçalho Authorization: Bearer contendo sua chave de API do Mage. A resposta inclui um status_url para você consultar o resultado.
Quais modelos do Lemon posso chamar?
lemon. O padrão é Lemon.
O Lemon aceita imagens de referência ou personagens?
O Lemon aceita first_image, last_image, image, additional_images, videos. O Lemon usa personagens salvos, referências e referências de áudio por @handle no prompt.
Posso usar o Lemon pelo Claude ou pelo ChatGPT?
Sim. Conecte o servidor MCP do Mage ao Claude, ChatGPT, Claude Code, Grok ou Cursor e peça o Lemon 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 Lemon ficam guardados?
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