API do Mage · Geração de imagens
A API de geração de imagens com IA para todos os modelos
Texto para imagem, edição de imagem e personagens consistentes com 18 modelos, incluindo o Mango 4, o modelo principal da Mage, com uma só chave e um só saldo.
POST https://api.mage.space/v1/{model}/generateResumo rápido
A API de geração de imagens da Mage é uma API REST em https://api.mage.space/v1 que executa 18 modelos de texto para imagem e edição de imagem, incluindo Mango 4, Guava 2 Pro, GPT Image 2.6, Nano Banana 2, Flux 2 e Krea 2. Você envia um prompt com POST para /{model}/generate, consulta a requisição e baixa a imagem. Cada imagem é paga em Gems, sem assinatura.
- 18modelos de imagem
- $0.009Padrão mais barato, por imagem
- 20Gerações simultâneas
- $0Mensalidade
Modelos
Todos os modelos de imagem da API do Mage
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, gpt-image-2.6-flare, gpt-image-2.6-sunburst | 9 Gems ($0.009) |
| Grok Image | Grok Imagine, em dois níveis | grok-imagine-image, grok-imagine-image-2.0 | 90 Gems ($0.09) |
| 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, mango-v4 | 42 Gems ($0.042) |
| MiniMax H3 Image | Imagens nativas de 16 megapixels, pesos abertos | minimax-h3-image | 15 Gems ($0.015) |
| MOSS-Image | Prompts longos e texto bilíngue, pesos abertos | moss-image | 25 Gems ($0.025) |
| Nano Banana 2 | Texto nítido e legível, até 4K | nano-banana-v2, nano-banana-v2.1 | 51 Gems ($0.051) |
| SDXL Plus | SDXL com rostos e mãos corrigidos | 6A35A7855770AE9820A3C931D4964C3817B6D9E3C6F9C4DABB5B3A94E5643B80 | 15 Gems ($0.015) |
| Seedream | Seedream, com filtro rigoroso | seedream-4.0, seedream-4.5, seedream-5.0-lite, seedream-5.0-pro, seedream-5.0-flash, seedream-5.5 | 42 Gems ($0.042) |
| 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) |
Início rápido
Gere uma imagem com o Anima v1
Defina MAGE_API_KEY, envie a solicitação e consulte até ela ser concluída. Troque anima na URL por qualquer modelo acima.
cURL
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/anima/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": "anima-v1"
}' | 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('anima', {
prompt: 'Editorial portrait in soft daylight, 35mm film look',
aspect_ratio: '4:5',
model_id: 'anima-v1',
});
console.log(request.result.url);Python
# pip install mage-space
from mage_space import Mage
mage = Mage() # reads MAGE_API_KEY
request = mage.run("anima", {
"prompt": "Editorial portrait in soft daylight, 35mm film look",
"aspect_ratio": "4:5",
"model_id": "anima-v1",
})
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.
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.
Casos de uso
O que desenvolvedores criam com a API de imagens
Imagens de produto e de marketing
Crie fotos de produto, variações de anúncios e posts para redes sociais sob demanda, com texto legível usando GPT Image 2.6 ou Nano Banana 2.
Personagens consistentes
Salve um personagem uma vez e mantenha o mesmo rosto em todo um conjunto com o Mango 4, o Guava 2 Pro e outros modelos que aceitam menções com @handle.
Pipelines de edição de imagem
Envie uma imagem de origem com uma instrução para mudar exatamente o que você pedir e manter o resto no lugar.
Apps e jogos
Gere avatares, stickers, cartas e cenários dentro do seu produto sem hospedar nenhuma GPU.
Retratos fotorrealistas
O Guava 2 Pro renderiza retratos, moda e fotos de estilo de vida com pele, tecido e luz fiéis à realidade.
Rascunhos rápidos em escala
Z-Image Turbo e Krea 2 mantêm os preços baixos para miniaturas em grande volume e primeiras versões.
Perguntas frequentes
Perguntas frequentes
Qual é a melhor API de geração de imagens com IA?
A API de imagens oferece suporte a edição de imagem e imagens de referência?
Quais resoluções a API de imagens oferece?
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.