Uma chave, todos os modelos
28 modelos de imagem, vídeo e áudio em uma única API REST e um único saldo de Gems. Troque de modelo mudando o caminho da URL.
Resumo rápido
O Mage oferece aos desenvolvedores uma API REST em https://api.mage.space/v1 e um servidor MCP remoto em https://mcp.mage.space/mcp. Ambos usam os mesmos 28 modelos de imagem, vídeo e áudio, incluindo os exclusivos do Mage, Mango 3 e Cherry 2 Pro, em uma única conta, e cada geração é paga em Gems, sem assinatura.
28
Modelos
3
Tipos de mídia
16
Ferramentas MCP
$0
Mensalidade
Formas de usar
Use pelo código, pelo seu assistente ou pelo ComfyUI
API REST
A API do Mage
Envie gerações do seu próprio código com uma chave. Requisições assíncronas, novas tentativas idempotentes, uploads de até 100 MB e 20 gerações em andamento.
SDKs
SDKs para TypeScript e Python
Clientes oficiais e tipados que enviam, aguardam o resultado, tentam de novo com segurança e fazem upload de arquivos em poucas linhas.
Servidor MCP
O servidor MCP do Mage
Conecte Claude, ChatGPT, Claude Code, Grok ou Cursor com um login e peça imagens, vídeos e áudios em linguagem simples.
ComfyUI
Mage para ComfyUI
Mango, Cherry, Seed Audio e todos os outros modelos do Mage como nós do ComfyUI. Sem GPU, sem baixar modelos.
Por tipo de mídia
APIs de geração
15 modelos
API de geração de imagens com IA
Texto para imagem, edição e personagens consistentes em até 4K.
12 modelos
API de geração de vídeos com IA
Texto para vídeo, imagem para vídeo, quadros, referências e som.
1 modelo
API de geração de áudio com IA
Vozes, narração, música e efeitos sonoros a partir de um prompt.
Início rápido
Sua primeira geração
Crie uma chave em API → Chaves de API, exporte-a como MAGE_API_KEY e execute um destes exemplos.
cURL
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/mango/generate' \
--header "Authorization: Bearer $MAGE_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"prompt": "Editorial portrait in soft daylight, 35mm film look",
"aspect_ratio": "4:5",
"model_id": "mango-v3"
}' | 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('mango', {
prompt: 'Editorial portrait in soft daylight, 35mm film look',
aspect_ratio: '4:5',
model_id: 'mango-v3',
});
console.log(request.result.url);Python
# pip install mage-space
from mage_space import Mage
mage = Mage() # reads MAGE_API_KEY
request = mage.run("mango", {
"prompt": "Editorial portrait in soft daylight, 35mm film look",
"aspect_ratio": "4:5",
"model_id": "mango-v3",
})
print(request["result"]["url"])Como funciona
Da chave de API à mídia pronta em três chamadas
Todos os modelos compartilham um único esquema de autenticação, um único ciclo de requisição assíncrona e os mesmos nomes de campos.
Crie uma chave de API
Entre no Mage, abra API → Chaves de API e crie uma chave. Ela começa com mage_sk_ e é exibida uma única vez. Uma conta pode ter até 10 chaves ativas.
Envie uma geração
Faça um POST com um corpo JSON para https://api.mage.space/v1/{model}/generate com um cabeçalho Authorization: Bearer. A resposta volta na hora com um request_id, um status e uma status_url. Envie um cabeçalho Idempotency-Key para que uma nova tentativa nunca cobre duas vezes.
Consulte e baixe
Consulte a status_url até o status ser completed, failed ou cancelled. Uma requisição concluída traz result.url com o arquivo de imagem, vídeo ou áudio, mantido por 30 dias.
MCP
O Mage no seu assistente de IA
Mage no Claude
Gere imagens, vídeos e áudios no Claude na web, no app para computador, nos apps para celular e no Cowork.
Mage no ChatGPT
Gere imagens, vídeos e áudios no ChatGPT como um app MCP pessoal.
Mage no Claude Code
Gere imagens, vídeos e áudios no Claude Code, no terminal e no editor.
Mage no Grok
Gere imagens, vídeos e áudios no Grok como um conector personalizado.
Mage no Cursor
Gere imagens, vídeos e áudios no modo Agent do Cursor.
Modelos
Modelos em destaque
Imagem · a partir de 40 Gems
API do Flux 2
Prompts longos e edições com várias referências
Imagem · a partir de 9 Gems
API do GPT Image 2
Prompts precisos e texto legível
Imagem · a partir de 37 Gems
API do Guava
Fotorrealismo que parece uma fotografia de verdade
Imagem · a partir de 135 Gems
API do Mango
Nossa família de imagens principal
Imagem · a partir de 68 Gems
API do Nano Banana 2
Texto nítido e legível, até 4K
Vídeo · a partir de 618 Gems
API do Cherry
Nossa família de vídeos principal
Vídeo · a partir de 245 Gems
API do Lemon
Todos os recursos de vídeo, por um preço mais amigável
Vídeo · a partir de 338 Gems
API do Plum
Som em todos os clipes, até 2K
Áudio · a partir de 19 Gems
API do Seed Audio
Vozes, música e efeitos sonoros a partir de um único prompt
Feito para produção
O que cada requisição da API do Mage inclui
Pague por geração
Sem assinatura e sem gasto mínimo. Você compra Gems e cada requisição é cobrada pelo preço listado. Uma geração que falha é reembolsada, a menos que tenha sido bloqueada pela política de conteúdo do Mage.
Novas tentativas seguras
As chaves de idempotência fazem com que o reenvio de uma requisição retorne a requisição original, sem cobrar de novo.
Personagens consistentes
Salve um personagem ou uma referência uma vez e escreva @handle em qualquer prompt para usá-lo com todos os modelos compatíveis.
Entradas grandes
Envie entradas de imagem, vídeo e áudio como URLs ou data URLs, ou faça upload de arquivos de até 100 MB por meio de um upload assinado.
20 gerações simultâneas
Cada conta pode executar 20 gerações ao mesmo tempo, e o limite pode ser ampliado para o seu caso de uso. Requisições recusadas nunca são cobradas.
Perguntas frequentes
Perguntas frequentes
O que é a API do Mage?
A API do Mage é uma API REST em https://api.mage.space/v1 para gerar imagens, vídeos e áudios com 28 modelos direto do seu código. As requisições são assíncronas e pagas por geração em Gems.
O que é o servidor MCP do Mage?
Um servidor remoto do Model Context Protocol em https://mcp.mage.space/mcp que permite que assistentes de IA gerem imagens, vídeos e áudios na sua conta do Mage. Ele dá ao assistente 16 ferramentas para escolher um modelo, cotar o preço, gerar, aguardar o resultado e usar seus personagens, referências e histórico salvos.
Preciso de uma chave de API para usar o servidor MCP?
Não. Claude, ChatGPT, Grok, Cursor e Claude Code se conectam fazendo login no Mage via OAuth. A chave de API é opcional, para configurações sem interface, como CI.
Quanto custa a API do Mage?
Não há assinatura nem mensalidade. Cada geração é paga em Gems, pelo preço listado do modelo, e 1.000 Gems custam US$ 1 no pacote padrão. A página de cada modelo mostra o preço com as configurações padrão, e cada resposta informa o valor exato cobrado. Uma geração que falha é reembolsada; uma bloqueada pela política de conteúdo do Mage, não. Uma requisição que o seu saldo não cobre é recusada antes de qualquer cobrança.
Preciso ser membro do Mage para usar a API?
Não. A API funciona apenas com Gems. Os planos de assinatura e a geração ilimitada no app não valem para requisições de API, então qualquer conta do Mage com Gems pode usá-la.
Posso usar os resultados da API para fins comerciais?
Sim. O conteúdo que você cria com o Mage, inclusive pela API e pelo servidor MCP, pode ser usado comercialmente. Os créditos são bem-vindos, mas não obrigatórios.
Quais são os limites de uso?
Uma conta pode ter até 20 gerações na fila ou em andamento ao mesmo tempo. Um envio além disso é recusado com o erro 429 e não custa nada. Escreva para [email protected] para aumentar o limite para o seu caso de uso.
Meu agente de IA pode usar a API do Mage?
Sim. Agentes podem chamar a API REST com uma chave ou se conectar ao servidor MCP do Mage, que oferece ao Claude, ChatGPT, Claude Code, Grok e Cursor dezesseis ferramentas prontas para escolher um modelo, consultar o preço, gerar e buscar o resultado. Veja o servidor MCP.
Existe um SDK para a API do Mage?
Sim. O pacote oficial @mage-space/sdk no npm e o mage-space no PyPI são de código aberto e tipados para todos os modelos. Eles enviam a solicitação, aguardam o resultado, repetem com segurança e fazem upload de arquivos para você. Quem usa ComfyUI pode instalar o pacote de nós comfyui-mage. Veja os SDKs do Mage.
Já uso outra API de geração. O que preciso mudar?
Aponte seu cliente para https://api.mage.space/v1, envie sua chave do Mage como token Bearer e mapeie seus campos para a página do modelo: prompt, aspect_ratio, resolution, duration e model_id funcionam da mesma forma em todos os modelos do Mage. As solicitações são assíncronas: envie e depois consulte status_url periodicamente.
Comece a criar com o Mage
Uma conta, um saldo de Gems, todos os modelos. Pague apenas pelo que você gerar.