Pular para o conteúdo

API do Mage · Modelos

37 modelos de geração, uma única API

Todos os modelos de imagem, vídeo e áudio que a API do Mage executa, com o melhor uso de cada um, seus valores de model_id e o preço nas configurações padrão.

POST https://api.mage.space/v1/{model}/generate

Resumo rápido

A API do Mage executa 18 modelos de imagem, 15 de vídeo e 4 de áudio em https://api.mage.space/v1/{model}/generate. Todos os modelos usam a mesma chave, o mesmo ciclo de solicitação e os mesmos nomes de campos, e são pagos por geração em Gems.

  • 18Modelos de imagem
  • 15Modelos de vídeo
  • 4Modelos de áudio
  • 1Uma 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 é.

ModeloIdeal paraValores de model_idPreço padrão
AnimaFeito sob medida para animeanima-v120 Gems ($0.02)
ChromaPesos abertos, baseado no Fluxchroma-v1-hd35 Gems ($0.035)
Flux 2Prompts longos e edições com várias referênciasflux2-dev40 Gems ($0.04)
GPT Image 2Prompts precisos e texto legívelgpt-image-2, gpt-image-2.5-flare, gpt-image-2.5-sunburst, gpt-image-2.6-flare, gpt-image-2.6-sunburst9 Gems ($0.009)
Grok ImageGrok Imagine, em dois níveisgrok-imagine-image, grok-imagine-image-2.090 Gems ($0.09)
GuavaFotorrealismo que passa por fotografiaguava, guava-pro, guava-pro-v1-5, guava-2, guava-2-pro37 Gems ($0.037)
HiDreamRápido e versátil, com prompts negativoshidream-fast20 Gems ($0.02)
Krea 2Estética deslumbrante em segundoskrea-2-turbo20 Gems ($0.02)
MangoNossa família principal de imagensmango, mango-v2, mango-v3s, mango-v3, mango-v3-turbo, mango-v442 Gems ($0.042)
MiniMax H3 ImageImagens nativas de 16 megapixels, pesos abertosminimax-h3-image15 Gems ($0.015)
MOSS-ImagePrompts longos e texto bilíngue, pesos abertosmoss-image25 Gems ($0.025)
Nano Banana 2Texto nítido e legível, até 4Knano-banana-v2, nano-banana-v2.151 Gems ($0.051)
SDXL PlusSDXL com rostos e mãos corrigidos6A35A7855770AE9820A3C931D4964C3817B6D9E3C6F9C4DABB5B3A94E5643B8015 Gems ($0.015)
SeedreamSeedream, com filtro rigorososeedream-4.0, seedream-4.5, seedream-5.0-lite, seedream-5.0-pro, seedream-5.0-flash, seedream-5.542 Gems ($0.042)
Stable Diffusion v1.5O clássico, com ótimo custo-benefício15012C538F503CE2EBFC2C8547B268C75CCDAFF7A281DB55399940FF1D70E21D10 Gems ($0.01)
Stable Diffusion v3.5 LargeO Stable Diffusion que melhor segue o que você pedesd-3-5-large10 Gems ($0.01)
Stable Diffusion XLSDXL ajustado para fotorrealismo6A35A7855770AE9820A3C931D4964C3817B6D9E3C6F9C4DABB5B3A94E5643B8010 Gems ($0.01)
Z-ImageO modelo de imagem mais rápido do Magez-image-turbo10 Gems ($0.01)

Modelos de vídeo

Modelos de geração de vídeos

ModeloIdeal paraValores de model_idPreço padrão
BerryVídeo fiel às suas referênciasberry, berry-2189 Gems ($0.189)
BlueberryFixe o primeiro e o último quadroblueberry, blueberry-v2360 Gems ($0.36)
CherryNossa família de vídeo principalcherry-mini, cherry, cherry-pro, cherry-2, cherry-2-pro618 Gems ($0.618)
Grok VideoGrok Imagine, em movimentogrok-imagine-video375 Gems ($0.375)
KiwiVídeo do dia a dia, sem configuraçãokiwi270 Gems ($0.27)
LemonTodos os recursos de vídeo, por um preço mais amigávellemon245 Gems ($0.245)
LTX VideoVídeo rápido de pesos abertos para iterarltx-video-096-distilled, ltx-video-096-dev20 Gems ($0.02)
MagejutsuRefaça qualquer vídeo mantendo o movimentomagejutsu, magejutsu-lite, magejutsu-feather1,856 Gems ($1.856)
MelonAnime em movimento, com áudio opcionalmelon, melon-pro147 Gems ($0.147)
MiniMax-H3Vídeo aberto e rápido com som estéreominimax-h3-turbo, pika-h3-flex, minimax-h345 Gems ($0.045)
PlumSom em todos os clipes, até 2Kplum, plum-max, plum-fast173 Gems ($0.173)
RaspberryPersonagens ganham vida a partir de um primeiro quadroraspberry360 Gems ($0.36)
SeedanceSeedance, com filtro rigorososeedance-2.0-mini, seedance-2.0-fast, seedance-2.0, seedance-2.5-flash, seedance-2.5618 Gems ($0.618)
Wan 3.0Wan 3.0, com filtro rigorosowan-3.0245 Gems ($0.245)
Wan Video v2.2Vídeo de pesos abertos com uma variante Lightningwan22-video, wan22-video-lightning40 Gems ($0.04)

Modelos de áudio

Modelos de geração de áudio

ModeloIdeal paraValores de model_idPreço padrão
Eleven MusicMúsicas da ElevenLabs, com ou sem vocaiseleven-music-v2.5113 Gems ($0.113)
Eleven SpeechElevenLabs v4: fala realista que você pode dirigireleven-v430 Gems ($0.03)
MiniMax Music 3Músicas completas a partir da sua letra, com pesos abertosminimax-music-3125 Gems ($0.125)
Seed AudioVozes, música e efeitos sonoros a partir de um único promptseed-audio-1.019 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 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