Pular para o conteúdo

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/v1

Resumo 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

  • 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

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.

  1. 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.

  2. 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.

  3. 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 42 Gems

    API do Mango

    Nossa família de imagens principal

  • Imagem · a partir de 51 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 173 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

  • 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?
A API do Mage é uma API REST em https://api.mage.space/v1 para gerar imagens, vídeos e áudio com 37 modelos direto do seu código. As solicitaçõ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 somente com Gems. Os planos de assinatura e a geração ilimitada no app não valem para requisições da API. Antes de tudo, a conta precisa ter um pagamento aprovado, seja de um pacote de Gems ou de um plano. Os Gems de bônus de cadastro funcionam apenas no app do Mage.
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.

CharactersComunidade