Resumo rápido
A API do Mage executa 15 modelos de imagem, 12 modelos de vídeo e 1 modelo de áudio em https://api.mage.space/v1/{model}/generate. Todos os modelos usam a mesma chave, o mesmo ciclo de requisição e os mesmos nomes de campos, e são pagos por geração em Gems.
15
Modelos de imagem
12
Modelos de vídeo
1
Modelos de áudio
1
Uma chave de API para todos
Modelos de imagem
Modelos de geração de imagens
Os preços são por geração, em Gems. 1.000 Gems custam US$ 1 no pacote padrão, e pacotes maiores dão Gems de bônus. O preço depende do modelo, da resolução e da duração; é mostrado o preço com as configurações padrão, e cada resposta informa o valor exato cobrado em billing.gems_charged. Uma geração que falha é reembolsada; uma bloqueada pela política de conteúdo do Mage não é.
| Modelo | Ideal para | Valores de model_id | Preço padrão |
|---|---|---|---|
| Anima | Feito sob medida para anime | anima-v1 | 20 Gems ($0.02) |
| Chroma | Pesos abertos, baseado no Flux | chroma-v1-hd | 35 Gems ($0.035) |
| Flux 2 | Prompts longos e edições com várias referências | flux2-dev | 40 Gems ($0.04) |
| GPT Image 2 | Prompts precisos e texto legível | gpt-image-2, gpt-image-2.5-flare, gpt-image-2.5-sunburst | 9 Gems ($0.009) |
| Grok Image | Grok Imagine, em três níveis de qualidade | grok-imagine-image, grok-imagine-image-quality, grok-imagine-image-2.0 | 75 Gems ($0.075) |
| Guava | Fotorrealismo que passa por fotografia | guava, guava-pro, guava-pro-v1-5, guava-2, guava-2-pro | 37 Gems ($0.037) |
| HiDream | Rápido e versátil, com prompts negativos | hidream-fast | 20 Gems ($0.02) |
| Krea 2 | Estética deslumbrante em segundos | krea-2-turbo | 20 Gems ($0.02) |
| Mango | Nossa família principal de imagens | mango, mango-v2, mango-v3s, mango-v3, mango-v3-turbo | 135 Gems ($0.135) |
| Nano Banana 2 | Texto nítido e legível, até 4K | nano-banana-v2 | 68 Gems ($0.068) |
| SDXL Plus | SDXL com rostos e mãos corrigidos | 6A35A7855770AE9820A3C931D4964C3817B6D9E3C6F9C4DABB5B3A94E5643B80 | 15 Gems ($0.015) |
| Stable Diffusion v1.5 | O clássico, com ótimo custo-benefício | 15012C538F503CE2EBFC2C8547B268C75CCDAFF7A281DB55399940FF1D70E21D | 10 Gems ($0.01) |
| Stable Diffusion v3.5 Large | O Stable Diffusion que melhor segue o que você pede | sd-3-5-large | 10 Gems ($0.01) |
| Stable Diffusion XL | SDXL ajustado para fotorrealismo | 6A35A7855770AE9820A3C931D4964C3817B6D9E3C6F9C4DABB5B3A94E5643B80 | 10 Gems ($0.01) |
| Z-Image | O modelo de imagem mais rápido do Mage | z-image-turbo | 10 Gems ($0.01) |
Modelos de vídeo
Modelos de geração de vídeos
| Modelo | Ideal para | Valores de model_id | Preço padrão |
|---|---|---|---|
| Berry | Vídeo fiel às suas referências | berry, berry-2 | 189 Gems ($0.189) |
| Blueberry | Fixe o primeiro e o último quadro | blueberry, blueberry-v2 | 360 Gems ($0.36) |
| Cherry | Nossa família de vídeo principal | cherry-mini, cherry, cherry-pro, cherry-2-pro | 618 Gems ($0.618) |
| Grok Video | Grok Imagine, em movimento | grok-imagine-video | 375 Gems ($0.375) |
| Kiwi | Vídeo do dia a dia, sem configuração | kiwi | 270 Gems ($0.27) |
| Lemon | Todos os recursos de vídeo, por um preço mais amigável | lemon | 245 Gems ($0.245) |
| LTX Video | Vídeo rápido de pesos abertos para iterar | ltx-video-096-distilled, ltx-video-096-dev | 20 Gems ($0.02) |
| Melon | Anime em movimento, com áudio opcional | melon, melon-pro | 147 Gems ($0.147) |
| MiniMax-H3 | Vídeo aberto e rápido com som estéreo | minimax-h3-turbo, minimax-h3 | 30 Gems ($0.03) |
| Plum | Som em todos os clipes, até 2K | plum, plum-max | 338 Gems ($0.338) |
| Raspberry | Personagens ganham vida a partir de um primeiro quadro | raspberry | 360 Gems ($0.36) |
| Wan Video v2.2 | Vídeo de pesos abertos com uma variante Lightning | wan22-video, wan22-video-lightning | 40 Gems ($0.04) |
Modelos de áudio
Modelos de geração de áudio
| Modelo | Ideal para | Valores de model_id | Preço padrão |
|---|---|---|---|
| Seed Audio | Vozes, música e efeitos sonoros a partir de um único prompt | seed-audio-1.0 | 19 Gems ($0.019) |
Perguntas frequentes
Perguntas frequentes
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.