API do Mage · Feita para a sua próxima ideia
Uma API. Possibilidades infinitas.
Leve o melhor do Mage para o seu produto e para o seu assistente de IA. Gere imagens, vídeos e áudios com uma única chave de API ou uma única conexão MCP.
https://api.mage.space/v1Resumo rápido
O Mage oferece para desenvolvedores uma API REST em https://api.mage.space/v1 e um servidor MCP remoto em https://mcp.mage.space/mcp. Ambos executam os mesmos 37 modelos de imagem, vídeo e áudio, incluindo os exclusivos do Mage, Mango 4 e Cherry 2 Pro, em uma única conta, e cada geração é paga em Gems, sem assinatura.
- 37Modelos
- 3Tipos de mídia
- 16Ferramentas MCP
- $0Mensalidade
Formas de usar
Use pelo código, pelo seu assistente ou pelo ComfyUI
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 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.
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.
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
API de geração de imagens com IA
Texto para imagem, edição e personagens consistentes em até 4K.
API de geração de vídeos com IA
Texto para vídeo, imagem para vídeo, quadros, referências e som.
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-v4"
}' | 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-v4',
});
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-v4",
})
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
API do Flux 2
Prompts longos e edições com várias referências
API do GPT Image 2
Prompts precisos e texto legível
API do Guava
Fotorrealismo que parece uma fotografia de verdade
API do Mango
Nossa família de imagens principal
API do Nano Banana 2
Texto nítido e legível, até 4K
API do Cherry
Nossa família de vídeos principal
API do Lemon
Todos os recursos de vídeo, por um preço mais amigável
API do Plum
Som em todos os clipes, até 2K
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
Uma chave, todos os modelos
37 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.
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?
O que é o servidor MCP do Mage?
Preciso de uma chave de API para usar o servidor MCP?
Quanto custa a API do Mage?
Preciso ser membro do Mage para usar a API?
Posso usar os resultados da API para fins comerciais?
Quais são os limites de uso?
Meu agente de IA pode usar a API do Mage?
Existe um SDK para a API do Mage?
Já uso outra API de geração. O que preciso mudar?
Comece a criar com o Mage
Uma conta, um saldo de Gems, todos os modelos. Pague apenas pelo que você gerar.