Contrato de integración de GPT Image 2.6 | Documentación de API

# GPT Image 2.6

GPT Image 2.6 Flare and Sunburst integration contract.

POST https://api.apihop.ai/openai/v1/images/generations

Integration is prepared for `gpt-image-2.6-flare` and `gpt-image-2.6-sunburst`. APIMart documentation still labels this upstream API an integration preview. Availability depends on your current API key and gateway activation; check `GET https://api.apihop.ai/v1/models`.

## Request

```http
POST https://api.apihop.ai/openai/v1/images/generations
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
```

```json
{
  "model": "gpt-image-2.6-flare",
  "prompt": "A red ceramic cup on a white table.",
  "size": "1:1",
  "resolution": "1k",
  "quality": "low",
  "output_format": "png",
  "n": 1
}
```

## Parameters

| Parameter | Values |
| --- | --- |
| `model` | `gpt-image-2.6-flare`, `gpt-image-2.6-sunburst` |
| `prompt` | Required text |
| `n` | 1–4 |
| `size` | `auto`, aspect ratio, `WIDTHxHEIGHT` |
| `resolution` | `1k`, `2k`, `4k` |
| `quality` | `auto`, `low`, `medium`, `high`, `xhigh`, `max` |
| `image_urls` | 0–16 HTTP(S) URLs |
| `output_format` | `png`, `jpeg`, `webp` |
| `output_compression` | 0–100; JPEG/WebP |
| `background` | `auto`, `opaque`, `transparent`; PNG/WebP |
| `complexity` | `low`, `medium`, `high` |
| `safety_identifier` | String, maximum 128 characters |
| `stream` | `false` (JSON), `true` (SSE) |

Pixel dimensions must be multiples of 16, with each side at most 3840, an aspect ratio at most 3:1, and 655,360–8,294,400 total pixels. Reference editing uses `image_urls` with public URLs on the same endpoint. This initial integration excludes base64 references, multipart uploads, masks, markup, GIF, SVG, animation, and `/images/edits`.

## Response

The connection waits for completion. JSON returns final URLs in `data[].url` and available token `usage`. SSE completes with `image_generation.completed` and `[DONE]`; partial image previews are not guaranteed. Clients do not poll the upstream task. Do not resubmit requests whose completion status is unknown.

## Pricing

Billing separates text input, cached text input, image input, cached image input, and image output tokens. Check the current catalog price; temporary reservations are reconciled after completion. Published APIMart reference prices do not prove account costs or live availability.

La integración está preparada para gpt-image-2.6-flare / gpt-image-2.6-sunburst. La documentación de APIMart aún describe esta API como una vista previa de integración. La disponibilidad depende de su clave API actual y de la activación de la pasarela; consulte GET https://api.apihop.ai/v1/models.

Solicitud

http

POST https://api.apihop.ai/openai/v1/images/generations
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

json

{
  "model": "gpt-image-2.6-flare",
  "prompt": "A red ceramic cup on a white table.",
  "size": "1:1",
  "resolution": "1k",
  "quality": "low",
  "output_format": "png",
  "n": 1
}

Parámetros

Parámetro	Valores
`model`	`gpt-image-2.6-flare`, `gpt-image-2.6-sunburst`
`prompt`	Texto obligatorio
`n`	1–4
`size`	`auto`, relación de aspecto, `WIDTHxHEIGHT`
`resolution`	`1k`, `2k`, `4k`
`quality`	`auto`, `low`, `medium`, `high`, `xhigh`, `max`
`image_urls`	0–16 HTTP(S) URLs
`output_format`	`png`, `jpeg`, `webp`
`output_compression`	0–100; JPEG/WebP
`background`	`auto`, `opaque`, `transparent`; PNG/WebP
`complexity`	`low`, `medium`, `high`
`safety_identifier`	Cadena, máximo 128 caracteres
`stream`	`false` (JSON), `true` (SSE)

Las dimensiones deben ser múltiplos de 16, cada lado como máximo 3840, la proporción como máximo 3:1 y el total 655,360–8,294,400 píxeles. Las referencias usan image_urls con URL públicas en el mismo endpoint. Esta integración excluye referencias base64, cargas multipart, máscaras, markup, GIF, SVG, animación y /images/edits.

Respuesta

La conexión espera a que termine. JSON devuelve las URL finales en data[].url y los tokens usage disponibles. SSE termina con image_generation.completed y [DONE]; no se garantizan vistas previas parciales. Los clientes no consultan la tarea de origen. No repita solicitudes cuyo estado final sea desconocido.

Precios

Se facturan por separado los tokens de texto de entrada, texto en caché, imagen de entrada, imagen en caché e imagen de salida. Consulte el precio actual del catálogo; las reservas se concilian al finalizar. Los precios de referencia de APIMart no prueban el coste de la cuenta ni la disponibilidad.