GPT Image 2.5 API
La API de GPT Image 2.5 en APIMart da acceso a GPT Image 2.5 de OpenAI, la versión API de ChatGPT Images 2.5 lanzada el 8 de septiembre de 2026. Elige gpt-image-2.5-flare, el modelo por defecto con un 50 % menos de latencia que GPT Image 2, o gpt-image-2.5-sunburst para un control más preciso en ediciones finas de varias rondas. Ambos generan y editan imágenes hasta 4K, aceptan hasta 16 imágenes de referencia y tienen el mismo precio por token.
Aspectos destacados del servicio
- Descuentos Oficiales
- Pago por uso
- Rápido y baja latencia
Añade al menos una imagen de referencia al utilizar una máscara.
Image link valid for 72 hours
Precios de GPT Image 2.5 API
Precios transparentes sin costos ocultos. Paga solo por lo que usas.
gpt-image-2.5-flarePrecio (por imagen)
Ahorra 20%Mostrando: precio de miembro Oro
El precio se calcula según el uso de tokens: esta configuración consume aproximadamente 196 tokens.
* Coste estimado de salida de una imagen, sin incluir la entrada del prompt ni las imágenes de referencia. El importe final depende de los tokens utilizados.
API de GPT Image 2.5 - modelos de imagen OpenAI Flare y Sunburst
Genera y edita imágenes con GPT Image 2.5 en APIMart. Elige Flare para generación rápida del día a día o Sunburst para ediciones precisas en varias rondas, con hasta 4K, fondo transparente y edición con máscara. Ambos modelos tienen el mismo precio por token.
50K+
Usuarios Activos
99.9%
Tiempo Activo
2x
Más Rápido
70%
Ahorro de Costos
Ejemplo de API de GPT Image 2.5: texto a imagen y edición con máscara
Llama a gpt-image-2.5-flare o gpt-image-2.5-sunburst con una sola solicitud POST. La generación es asíncrona: envía la tarea y consulta el endpoint de tareas hasta obtener la URL de la imagen.
- 1
Autenticar la API de GPT Image 2.5
Guarda tu clave de APIMart en la variable de entorno APIMART_API_KEY y envíala en cada solicitud como Authorization: Bearer <key>.
- 2
Enviar una tarea de GPT Image 2.5
POST /v1/images/generations con model (gpt-image-2.5-flare o gpt-image-2.5-sunburst), el prompt, size, resolution y quality. Para editar, añade image_urls y mask_url. El ID de tarea está en data[0].task_id.
- 3
Obtener el resultado de GPT Image 2.5
Consulta GET /v1/tasks/{task_id} cada 2–5 segundos hasta que status sea completed y lee la URL de la imagen en data.result.images[0].url[0]. APIMart guarda los resultados 72 horas: descarga a tiempo los archivos que quieras conservar.
Consulta todos los parámetros, reglas de tamaño y campos de respuesta en la referencia de la API de GPT Image 2.5.
curl -X POST https://api.apimart.ai/v1/images/generations \
-H "Authorization: Bearer $APIMART_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-image-2.5-flare",
"prompt": "Póster minimalista de una noche de jazz en Lisboa, texto LISBON JAZZ en una tipografía serif gruesa, luz cálida del atardecer, grano de película",
"n": 1,
"size": "16:9",
"resolution": "2k",
"quality": "high"
}'import os
import time
import requests
API_BASE = "https://api.apimart.ai"
headers = {"Authorization": f"Bearer {os.environ['APIMART_API_KEY']}"}
# 1. Submit the generation task
payload = {
"model": "gpt-image-2.5-flare",
"prompt": "Póster minimalista de una noche de jazz en Lisboa, texto LISBON JAZZ en una tipografía serif gruesa, luz cálida del atardecer, grano de película",
"n": 1,
"size": "16:9",
"resolution": "2k",
"quality": "high"
}
resp = requests.post(f"{API_BASE}/v1/images/generations", headers=headers, json=payload, timeout=60)
resp.raise_for_status()
task_id = resp.json()["data"][0]["task_id"]
# 2. Poll the task until it finishes
for _ in range(200):
task_resp = requests.get(f"{API_BASE}/v1/tasks/{task_id}", headers=headers, timeout=30)
task_resp.raise_for_status()
task = task_resp.json()["data"]
if task["status"] == "completed":
print(task["result"]["images"][0]["url"][0])
break
if task["status"] == "failed":
raise RuntimeError(task.get("error", {}).get("message", "generation failed"))
time.sleep(3)
else:
raise TimeoutError(f"task {task_id} did not finish in time; continue GET polling with this task ID")curl -X POST https://api.apimart.ai/v1/images/generations \
-H "Authorization: Bearer $APIMART_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-image-2.5-sunburst",
"prompt": "Sustituir solo el fondo enmascarado por un estudio de tonos pastel suaves, manteniendo intactos el producto y la etiqueta",
"image_urls": [
"https://example.com/product.png"
],
"mask_url": "https://example.com/product-mask.png",
"resolution": "2k",
"quality": "high"
}'TASK_ID="task_xxx" # replace with the task_id returned by the POST request
curl "https://api.apimart.ai/v1/tasks/$TASK_ID" \
-H "Authorization: Bearer $APIMART_API_KEY"Parámetros de la API de GPT Image 2.5
| Parámetro | Tipo | Obligatorio | Por defecto | Descripción |
|---|---|---|---|---|
model | string | Sí | Por defecto: gpt-image-2.5-flare | gpt-image-2.5-flare o gpt-image-2.5-sunburst. Ambos usan los mismos parámetros. |
prompt | string | Sí | Por defecto: — | Qué generar o cambiar. Describe el sujeto, la escena, la composición, el estilo, la luz y lo que no debe cambiar. |
size | string | Opcional | Por defecto: auto | auto, una de 15 relaciones de aspecto (1:1, 3:2, 2:3, 4:3, 3:4, 5:4, 4:5, 16:9, 9:16, 2:1, 1:2, 21:9, 9:21, 3:1, 1:3) o dimensiones en píxeles como 1600x1200. Al editar, si se omite, sigue a la imagen de entrada. |
resolution | string | Opcional | Por defecto: 1k | 1k, 2k o 4k. Se usa con una relación de aspecto en size y se ignora con dimensiones en píxeles. |
quality | string | Opcional | Por defecto: auto | low, medium, high, xhigh, max o auto. auto reserva a la tarifa de max y liquida según el uso real. |
n | integer | Opcional | Por defecto: 1 | Número de imágenes, 1–4. |
output_format | string | Opcional | Por defecto: png | png, jpeg o webp. |
output_compression | integer | Opcional | Por defecto: — | 0–100, solo para jpeg y webp. |
background | string | Opcional | Por defecto: — | transparent, opaque o auto. transparent requiere png o webp. |
moderation | string | Opcional | Por defecto: low | auto o low. |
image_urls | array | Opcional | Por defecto: — | Hasta 16 URL HTTP(S) públicas de imágenes de referencia. Su presencia activa el modo edición. |
mask_url | string | Opcional | Por defecto: — | Máscara PNG con canal alfa (URL o data URL PNG), del mismo tamaño que la primera imagen de entrada; las zonas transparentes se editan. |
Familia de modelos GPT Image API
Explora las versiones de GPT Image en APIMart y elige el modelo y los parámetros para generar y editar imágenes.
| Modelo | Ideal para | Resolución / formato |
|---|---|---|
| GPT Image 2.6 API | Flare y Sunburst: salida de imágenes, GIF y SVG con complexity y anotaciones | 1K / 2K / 4K |
| GPT Image 2.6 Flare API | Modelo 2.6 más rápido para borradores, pósteres, imágenes de producto y lotes, con salida GIF y SVG | 1K / 2K / 4K |
| GPT Image 2.6 Sunburst API | Modelo 2.6 de mayor calidad para trabajos 4K detallados y ediciones coherentes con máscaras o anotaciones | 1K / 2K / 4K |
| GPT Image 2.5 APIEsta página | Flare y Sunburst en una sola página, con hasta 16 imágenes de referencia, máscaras y fondo transparente | 1K / 2K / 4K |
| GPT Image 2.5 Flare API | Imágenes rápidas del día a día, generación por lotes y prototipado rápido | 1K / 2K / 4K |
| GPT Image 2.5 Sunburst API | Edición precisa para assets de producción, creatividades publicitarias y edición en varios pasos | 1K / 2K / 4K |
| GPT Image 2 API | Texto a imagen y edición con hasta 16 imágenes de referencia y 15 relaciones de aspecto | 1K / 2K / 4K |
| GPT Image 1.5 API | Texto a imagen y edición con hasta 15 imágenes de referencia y máscaras; OpenAI lo retira el 1 de diciembre de 2026 | 1:1 / 3:2 / 2:3 |
| GPT Image 1 API | Generación anterior, retirada por OpenAI el 23 de octubre de 2026; usa GPT Image 2.6 en proyectos nuevos | 1:1 / 3:2 / 2:3 |
