gpt-image-2.5-flare API

Utilice el ID de modelo exacto gpt-image-2.5-flare. El campo del modelo debe coincidir exactamente con esta página.

Salida de muestragpt-image-2.5-flarePOST /v1/images/generations

Parámetros: size=1536x1024quality=mediumn=1

Prompt: Children's picture-book illustration: a small fox carrying a paper lantern through a snowy birch forest at dusk, soft gouache textures, gentle blues and warm orange glow, friendly and calm, no text.

Solicitud que produjo esta muestra

{
  "model": "gpt-image-2.5-flare",
  "prompt": "Children's picture-book illustration: a small fox carrying a paper lantern through a snowy birch forest at dusk, soft gouache textures, gentle blues and warm orange glow, friendly and calm, no text.",
  "n": 1,
  "size": "1536x1024",
  "quality": "medium"
}

Autenticación y punto final

Utilice una clave API de Modelflare con https://modelflare.dev/v1. El punto de entrada de la puerta de enlace es POST /v1/images/generations.

HTTP

Authorization: Bearer YOUR_MODELFLARE_API_KEY

Generar una imagen

bash

curl https://modelflare.dev/v1/images/generations \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2.5-flare",
    "prompt": "A white cat runs through a neon-lit street in the rain",
    "size": "1536x1024", "quality": "high", "background": "opaque", "output_format": "jpeg",
    "output_compression": 85, "moderation": "auto", "n": 1
  }'

Solicitar notas

GPT Image 2.5 Flare es el valor predeterminado rápido y de alta calidad para la generación y edición diaria; conservar images[], image[], mask y los controles de salida completos.

Solicitar parámetros

GPT Image 2.5 utiliza la API de imágenes compatible con OpenAI. La generación utiliza JSON; la edición acepta referencias de imágenes JSON o archivos de varias partes; las respuestas devuelven datos de imagen Base64 en data[].b64_json.

Campo	Requerido	Notas
model	Sí	gpt-image-2.5-flare
prompt	Sí	Instrucción de generación o edición, 1–32.000 caracteres
images[]	Condicional	Para ediciones JSON, hasta 16 objetos file_id o image_url
images[].file_id	Condicional	ID de API del archivo cargado
images[].image_url	Condicional	URL de imagen o URL de datos Base64; Las URL de datos están limitadas a 20.971.520 caracteres.
image	Condicional	Un archivo fuente de varias partes; use image[] para múltiples archivos
image[]	Condicional	Para ediciones de varias partes, hasta 16 archivos fuente
mask	No	Máscara alfa que coincide con el formato/tamaño del primer origen y tiene menos de 50 MB
size	No	auto o personalizado WIDTHxHEIGHT; Múltiplos de 16 píxeles, relación de aspecto 1:3–3:1, borde máximo de 3840 px y 655 360–8 294 400 píxeles totales
quality	No	low / medium / high / xhigh / max / auto; predeterminado auto
background	No	auto / opaque / transparent; Los fondos transparentes requieren salida PNG o WebP.
output_format	No	png / jpeg / webp; predeterminado png
output_compression	No	0–100 para JPEG/WebP, valor predeterminado 100; ignorado para PNG
moderation	No	auto / low; predeterminado auto
n	No	1–10 salidas; predeterminado 1

Límites de respuesta y entrada

GPT Image 2.5 Flare y Sunburst admiten hasta 16 entradas de edición. Las ediciones JSON utilizan images[] con file_id o image_url; Las ediciones de varias partes utilizan image/image[], con cada imagen de origen y máscara de menos de 50 MB. Las indicaciones tienen entre 1 y 32 000 caracteres; soportes de calidad low/medium/high/xhigh/max/auto; Las reglas de tamaño son múltiplos de 16 píxeles, relación de aspecto de 1:3 a 3:1, borde máximo de 3840 px y 655 360 a 8 294 400 píxeles totales. Los fondos transparentes requieren PNG o WebP; la compresión se aplica sólo a JPEG/WebP y se ignora para PNG. Las resoluciones superiores a 2560x1440 son experimentales. Leer data[].b64_json; no envíe solo DALL·E response_format. Flare es el valor predeterminado rápido y de alta calidad para la generación y edición diaria; Sunburst es para trabajos de mayor fidelidad y mayor control.

Editar imágenes

GPT Image 2.5 admite referencias de imágenes JSON y cargas de archivos de varias partes a través de /v1/images/edits. JSON acepta hasta 16 objetos usando file_id o image_url; multipart acepta hasta 16 archivos fuente. No mezcle images con image/image[] en una sola solicitud.

bash

curl https://modelflare.dev/v1/images/edits \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2.5-flare",
    "images": [{"file_id": "file-example123"}, {"image_url": "https://example.com/reference.png"}],
    "prompt": "Keep the product unchanged and replace the background with a warm studio gradient",
    "size": "1536x1024", "quality": "high", "background": "opaque", "output_format": "png", "n": 1
  }'

bash

curl https://modelflare.dev/v1/images/edits \
  -H "Authorization: Bearer YOUR_MODELFLARE_API_KEY" \
  -F "model=gpt-image-2.5-flare" \
  -F "image[]=@/path/to/product.png" \
  -F "mask=@/path/to/mask.png" \
  -F "prompt=Keep the product unchanged and replace the background with a warm studio gradient" \
  -F "size=1536x1024" \
  -F "quality=high" \
  -F "background=opaque" \
  -F "output_format=png" \
  -F "n=1"

Forma de respuesta

Leer resultados generados y editados desde data[]. GPT Image 2.5 devuelve datos de imagen Base64; no trate la respuesta como salida de URL.

Campo	Notas
created	Tiempo de creación como marca de tiempo Unix en segundos
data	Resultados de imágenes generadas o editadas
data[].b64_json	Datos de imagen codificados en Base64
background	Modo de fondo final: opaque o transparent
output_format	Formato de imagen devuelta: png, jpeg o webp
quality	Nivel de calidad utilizado
size	Dimensiones finales como ANCHOxALTO

Errores y tareas fallidas

Los parámetros del modelo no válidos devuelven un 4xx con un ID de solicitud; utilice los campos de respuesta y el mensaje de error definidos por el modelo de contrato seleccionado.

Alcance soportado

Esta página cubre las llamadas de generación y edición de modelos de Modelflare. El enriquecimiento de mapas o búsquedas, la administración de voz y la administración de bibliotecas de elementos son API de recursos fuera de esta superficie pública de llamada de modelo y no son campos de solicitud obligatorios.

Precios y facturación

Este modelo utiliza facturación basada en tokens. Consulte la página de precios de modelos para conocer el precio actual para el cliente, el precio de lista de referencia y las especificaciones completas.

Nota

Esta página documenta la interfaz pública de Modelflare; Los campos y límites que se muestran aquí son el contrato actual.