La API de generación de imágenes con IA para todos los modelos

De un vistazo

La API de generación de imágenes de Mage es una API REST en https://api.mage.space/v1 que ejecuta 15 modelos de texto a imagen y edición de imágenes, entre ellos Mango 3, Guava 2 Pro, GPT Image 2.5, Nano Banana 2, Flux 2 y Krea 2. Envías un prompt con POST a /{model}/generate, consultas el estado de la solicitud y descargas la imagen. Cada imagen se paga con Gems, sin suscripción.

• 15

  modelos de imágenes

• $0.009

  Opción predeterminada más barata, por imagen

• 20

  Generaciones simultáneas

• $0

  Cuota mensual

Modelos

Todos los modelos de imágenes de la API de Mage

Los precios son por generación, en Gems. 1.000 Gems cuestan 1 USD en el paquete estándar, y los paquetes más grandes incluyen Gems extra. El precio depende del modelo, la resolución y la duración; se muestra el precio con los ajustes predeterminados, y cada respuesta indica el cargo exacto en billing.gems_charged. Si una generación falla, se reembolsa; si la bloquea la política de contenido de Mage, no.

Inicio rápido

Genera una imagen con Anima v1

Define MAGE_API_KEY, envía la solicitud y consulta el estado hasta que termine. Cambia anima en la URL por cualquier modelo de los de arriba.

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"])

Cómo funciona

De la clave de API al contenido final en tres llamadas

Todos los modelos comparten un único esquema de autenticación, un mismo ciclo de solicitudes asíncronas y los mismos nombres de campo.

1. 01

   Crea una clave de API

   Inicia sesión en Mage, abre API → API Keys y crea una clave. Empieza por mage_sk_ y se muestra una sola vez. Una cuenta puede tener 10 claves activas.

2. 02

   Envía una generación

   Haz un POST con un cuerpo JSON a https://api.mage.space/v1/{model}/generate con una cabecera Authorization: Bearer. La respuesta llega al instante con un request_id, un status y una status_url. Envía una cabecera Idempotency-Key para que un reintento nunca se cobre dos veces.

3. 03

   Consulta y descarga

   Consulta status_url hasta que el estado sea completed, failed o cancelled. Una solicitud completada incluye result.url con el archivo de imagen, vídeo o audio, que se conserva 30 días.

Pensada para producción

Lo que obtiene cada solicitud a la API de Mage

Casos de uso

Qué crean los desarrolladores con la API de imágenes

Preguntas frecuentes

Preguntas frecuentes

Empieza a crear con Mage

Una cuenta, un saldo de Gems, todos los modelos. Paga solo por lo que generes.

Relacionado

• API de generación de video con IA
• API de generación de audio con IA
• Servidor MCP de Mage
• SDK de Mage
• Mage para ComfyUI
• Todos los modelos de la API
• Playground de la API
• Documentación de la API