gpt-image-2.5-sunburst API

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

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

Parámetros: size=1536x1024n=1

Prompt: The open top deck of a car park at dusk, wet asphalt still throwing back the sky. A woman in a cobalt-blue structured trench coat has just thrown a stack of contact sheets and film strips out of her hands. The strips are not falling: they have started to unwind and climb around her in a slow rotating ribbon, every frame lit a different neon colour, magenta and acid green and amber running through the coil. One hard magenta light rakes across the deck from behind her, the city beyond still cold blue. Wide low camera, 35mm, real weight in the paper, film grain, slight vignette, no text.

Solicitud que produjo esta muestra

{
  "model": "gpt-image-2.5-sunburst",
  "prompt": "The open top deck of a car park at dusk, wet asphalt still throwing back the sky. A woman in a cobalt-blue structured trench coat has just thrown a stack of contact sheets and film strips out of her hands. The strips are not falling: they have started to unwind and climb around her in a slow rotating ribbon, every frame lit a different neon colour, magenta and acid green and amber running through the coil. One hard magenta light rakes across the deck from behind her, the city beyond still cold blue. Wide low camera, 35mm, real weight in the paper, film grain, slight vignette, no text.",
  "n": 1,
  "size": "1536x1024"
}

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-sunburst",
    "prompt": "A white cat runs through a neon-lit street in the rain",
    "size": "1536x1024", "quality": "xhigh", "background": "opaque", "output_format": "jpeg",
    "output_compression": 85, "moderation": "auto", "n": 1
  }'

Solicitar notas

GPT Image 2.5 Sunburst apunta a una creación y edición de mayor fidelidad y mayor control; conservar images[], image[], mask, xhigh/max y los controles de salida para ambas operaciones.

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-sunburst
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-sunburst",
    "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": "xhigh", "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-sunburst" \
  -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=xhigh" \
  -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.