Saltar al contenido

API de Mage · Modelo de imagen

GPT Image 2 API

Prompts precisos y texto legible

POST https://api.mage.space/v1/gpt_image_2/generate

De un vistazo

La API de GPT Image 2 ejecuta GPT Image 2 y otras 4 variantes a través de Mage en POST https://api.mage.space/v1/gpt_image_2/generate. Una solicitud con los ajustes predeterminados cuesta 9 Gems (unos 0,009 $), sin suscripción. GPT Image 2 admite personajes guardados y referencias mediante @handle en el prompt.

  • ImagenResultado
  • 5Variantes
  • 9Gems por imagen, por defecto
  • $0.009Aprox., en USD

Resumen

Qué hace la API de GPT Image 2

Los modelos GPT Image de OpenAI, que siguen el prompt al pie de la letra y generan texto legible. Genera o edita a partir de muchas imágenes de referencia, o crea GIF animados con GPT Image 2.6. Se aplica el filtro de seguridad de OpenAI.

Los modelos GPT Image de OpenAI para generar y editar: GPT Image 2, GPT Image 2.5 Flare y Sunburst, y GPT Image 2.6 Flare y Sunburst, que además crean GIF animados. Se aplica el filtro de seguridad de OpenAI.

Acepta image y additional_images como entradas.

Inicio rápido

Llama a la API de GPT Image 2

Define MAGE_API_KEY, envía la solicitud a /gpt_image_2/generate y consulta status_url hasta que la solicitud termine.

cURL
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/gpt_image_2/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": "gpt-image-2"
}' | 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('gpt_image_2', {
  prompt: 'Editorial portrait in soft daylight, 35mm film look',
  aspect_ratio: '4:5',
  model_id: 'gpt-image-2',
});

console.log(request.result.url);
Python
# pip install mage-space
from mage_space import Mage

mage = Mage()  # reads MAGE_API_KEY

request = mage.run("gpt_image_2", {
    "prompt": "Editorial portrait in soft daylight, 35mm film look",
    "aspect_ratio": "4:5",
    "model_id": "gpt-image-2",
})

print(request["result"]["url"])

Modelos

Valores de model_id de GPT Image 2

Envía model_id para elegir una variante. Si no lo incluyes, se usa la predeterminada.

model_idNombrePredeterminado
gpt-image-2GPT Image 2Sí
gpt-image-2.5-flareGPT Image 2.5 Flare
gpt-image-2.5-sunburstGPT Image 2.5 Sunburst
gpt-image-2.6-flareGPT Image 2.6 Flare
gpt-image-2.6-sunburstGPT Image 2.6 Sunburst

Opciones

Parámetros de GPT Image 2

Valores permitidos en todas las variantes; una variante puede ofrecer menos. La documentación indica las opciones de cada variante.

CampoValores
aspect_ratio21:9, 16:9, 3:2, 5:4, 1:1, 4:5, 2:3, 9:16, 9:21
resolution1K, 2K
output_formatjpeg, gif

Entradas

Entradas multimedia que acepta GPT Image 2

Envía cada una como una URL https, una URL de datos o un archivo subido de hasta 100 MB.

CampoRol
imageLa imagen de referencia.
additional_imagesImágenes de referencia adicionales.

Reglas

Qué exige la API de GPT Image 2

  • Cada modelo ofrece solo algunos niveles de `quality`; si el modelo elegido no ofrece el nivel indicado, se rechaza.
  • Establece `output_format` en `gif` en un modelo GPT Image 2.6 para obtener un GIF animado, con `frame_count` de 2 a 16 (9 por defecto) y `frame_duration_ms` de 20 a 2000 (200 por defecto). Los demás modelos lo rechazan. `resolution` no se aplica: cada `aspect_ratio` tiene un único tamaño de fotograma, de unos 640 píxeles. El resultado es un archivo `.gif` y su `type` sigue siendo `image`.
  • El precio de un GIF depende de `quality` y del rango de fotogramas en el que se encuentre (2 a 8, 9, 10 a 12 o 13 a 16), no de cada fotograma. La tabla de precios de abajo muestra imágenes estáticas: consulta el precio de un GIF en la estimación de costo.
  • Un GIF de Mage, como un resultado anterior, que se pase como entrada de imagen se ejecuta con su primer fotograma. Un GIF de cualquier otro origen se rechaza: las entradas de imagen son JPEG o PNG.

Más modelos de imagen

Otras API de generación de imágenes en Mage

  • Imagen · desde 90 Gems

    API de Grok Image

    Grok Imagine, en dos niveles

  • Imagen · desde 37 Gems

    API de Guava

    Fotorrealismo que parece una fotografía

  • Imagen · desde 20 Gems

    API de HiDream

    Rápido y versátil, con prompts negativos

  • Imagen · desde 20 Gems

    Krea 2 API

    Una estética espectacular en segundos

  • Imagen · desde 42 Gems

    API de Mango

    Nuestra familia de imágenes insignia

  • Imagen · desde 15 Gems

    API de MiniMax H3 Image

    Imágenes nativas de 16 megapíxeles, pesos abiertos

Preguntas frecuentes

Preguntas frecuentes

¿Cuánto cuesta la API de GPT Image 2?
Una solicitud de GPT Image 2 con los ajustes predeterminados (GPT Image 2) cuesta 9 Gems, unos $0.009. Otras resoluciones, duraciones y variantes cambian el precio; la respuesta indica el cargo exacto. Si una generación falla, se reembolsa; si la bloquea la política de contenido de Mage, no.
¿Cuál es el endpoint de la API de GPT Image 2?
POST https://api.mage.space/v1/gpt_image_2/generate con un encabezado Authorization: Bearer que lleve tu clave de API de Mage. La respuesta incluye un status_url que debes consultar para obtener el resultado.
¿Qué modelos de GPT Image 2 puedo llamar?
gpt-image-2 (GPT Image 2), gpt-image-2.5-flare (GPT Image 2.5 Flare), gpt-image-2.5-sunburst (GPT Image 2.5 Sunburst), gpt-image-2.6-flare (GPT Image 2.6 Flare), gpt-image-2.6-sunburst (GPT Image 2.6 Sunburst). El predeterminado es GPT Image 2.
¿GPT Image 2 admite imágenes de referencia o personajes?
GPT Image 2 acepta image, additional_images. También admite personajes y referencias guardados mediante @handle en el prompt.
¿Puedo usar GPT Image 2 desde Claude o ChatGPT?
Sí. Conecta el servidor MCP de Mage a Claude, ChatGPT, Claude Code, Grok o Cursor y pide GPT Image 2 por su nombre. Tu asistente consulta sus opciones con get_model y te indica el precio antes de generar.
¿Cuánto tiempo se conservan los resultados de GPT Image 2?
Los resultados y las entradas se conservan durante 30 días. Descarga lo que quieras guardar en tu propio almacenamiento.

Empieza a crear con Mage

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

CharactersComunidad