A API de geração de imagens com IA para todos os modelos

Resumo rápido

A API de geração de imagens do Mage é uma API REST em https://api.mage.space/v1 que executa 15 modelos de texto para imagem e edição de imagens, incluindo Mango 3, Guava 2 Pro, GPT Image 2.5, Nano Banana 2, Flux 2 e Krea 2. Você envia um prompt com POST para /{model}/generate, consulta a solicitação e baixa a imagem. Cada imagem é paga em Gems, sem assinatura.

• 15

  modelos de imagem

• $0.009

  Padrão mais barato, por imagem

• 20

  Gerações simultâneas

• $0

  Mensalidade

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

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.

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"

// 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);

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

1. 01

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

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

   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

Casos de uso

O que desenvolvedores criam com a API de imagens

Perguntas frequentes

Perguntas frequentes

Comece a criar com o Mage

Uma conta, um saldo de Gems, todos os modelos. Pague apenas pelo que você gerar.

Relacionados

• API de geração de vídeos com IA
• API de geração de áudio com IA
• Servidor MCP do Mage
• SDKs do Mage
• Mage para ComfyUI
• Todos os modelos da API
• Playground da API
• Documentação da API