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ídeo
Saída
1
Variante
245
Gems por clipe, padrão
$0.245
Aproximadamente, 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_id | Nome | Padrão |
|---|---|---|
| lemon | Lemon | Sim |
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.
| Campo | Valores |
|---|---|
| aspect_ratio | 16:9, 4:3, 1:1, 3:4, 9:16 |
| resolution | 480p, 720p, 1080p |
| duration | 2, 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.
| 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. |
| videos | Os 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 147 Gems
API do Melon
Anime em movimento, com áudio opcional
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
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.