GPT Image 2.5 | Documentation des API

# GPT Image 2.5

Generate images with Flare or edit reference images with Sunburst.

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

Use `gpt-image-2.5-flare` for fast image generation or `gpt-image-2.5-sunburst` for precise editing. Check `GET https://api.apihop.ai/v1/models` for availability with your API key.

## 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.5-flare",
  "prompt": "A red ceramic cup on a white table.",
  "size": "1:1",
  "resolution": "1k",
  "quality": "low",
  "n": 1
}
```

| Parameter | Values |
| --- | --- |
| `model` | Required: `gpt-image-2.5-flare` or `gpt-image-2.5-sunburst` |
| `prompt` | Required text describing the image or edit |
| `n` | Integer from 1 to 4; default 1 |
| `size` | `auto`, aspect ratio, or pixel dimensions such as `1600x1200` |
| `resolution` | `1k` (default), `2k`, `4k`; ignored for exact pixel sizes |
| `quality` | `low`, `medium`, `high`, `xhigh`, `max`, `auto` (default) |
| `image_urls` | Up to 16 publicly accessible HTTP(S) image URLs |
| `output_format` | `png` (default), `jpeg`, `webp` |
| `output_compression` | Integer from 0 to 100 for JPEG or WebP |
| `background` | `auto`, `opaque`, `transparent`; transparent requires PNG or WebP |
| `moderation` | `low` (default), `auto` |
| `stream` | `false` (default) for JSON, `true` for SSE completion events |

Supported aspect ratios: `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`. Exact pixel dimensions must be multiples of 16, have no side above 3840 pixels, an aspect ratio at most 3:1, and 655,360 to 8,294,400 total pixels. For example, square `4k` output is 2880x2880, not 4096x4096.

## Reference Images

```json
{
  "model": "gpt-image-2.5-sunburst",
  "prompt": "Keep the product and its lettering. Replace the background with a white studio.",
  "image_urls": ["https://example.com/product.png"],
  "resolution": "2k",
  "quality": "xhigh"
}
```

References use this JSON generation endpoint. Upload local images to your own storage first. Base64 data URIs, multipart uploads, masks, and a separate `/images/edits` endpoint are outside this model's public contract.

## Response

The HTTP connection waits for completion; clients do not poll an upstream task. JSON responses include final image URLs and available token usage:

```json
{
  "created": 1789035000,
  "data": [{"url": "https://example.com/generated-image.png"}],
  "usage": {"input_tokens": 15, "output_tokens": 196, "total_tokens": 211}
}
```

With `stream: true`, wait for `image_generation.completed` and `[DONE]` on the same connection. Partial image previews are not guaranteed.

## Pricing

Billing uses actual text input, cached text input, image input, cached image input, and image output tokens. Both variants have the same token prices. The model catalog shows your current price and the separate OpenAI reference price. An image is not a fixed-price unit: prompt length, references, size, quality, and count affect the total. A temporary reservation is reconciled after completion. Choosing an explicit quality makes expected usage clearer.

Invalid parameters return 400; authentication failures return 401; insufficient balance returns 402. An unavailable model returns 404, rate limits return 429, and generation failures return 5xx. Do not automatically resubmit a request whose completion status is unknown.

See [Error Codes and Troubleshooting](https://apihop.ai/en/docs/api-reference/errors) for error codes, streaming failures, and retry boundaries.

Utilisez gpt-image-2.5-flare pour générer rapidement des images ou gpt-image-2.5-sunburst pour des retouches précises. Consultez GET https://api.apihop.ai/v1/models pour vérifier la disponibilité avec votre clé API.

Requête

http

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

json

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

Paramètre	Valeurs
`model`	Obligatoire : `gpt-image-2.5-flare` ou `gpt-image-2.5-sunburst`
`prompt`	Texte obligatoire décrivant l’image ou la retouche
`n`	Entier de 1 à 4 ; valeur par défaut 1
`size`	`auto`, rapport d’aspect ou dimensions en pixels comme `1600x1200`
`resolution`	`1k` (par défaut), `2k`, `4k` ; ignoré avec des dimensions exactes en pixels
`quality`	`low`, `medium`, `high`, `xhigh`, `max`, `auto` (par défaut)
`image_urls`	Jusqu’à 16 URL HTTP(S) d’images accessibles publiquement
`output_format`	`png` (par défaut), `jpeg`, `webp`
`output_compression`	Entier de 0 à 100 pour JPEG ou WebP
`background`	`auto`, `opaque`, `transparent` ; la transparence nécessite PNG ou WebP
`moderation`	`low` (par défaut), `auto`
`stream`	`false` (par défaut) pour JSON, `true` pour les événements de fin SSE

Rapports d’aspect pris en charge : 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. Les dimensions exactes doivent être des multiples de 16, sans côté supérieur à 3840 pixels, avec un rapport d’aspect maximal de 3:1 et un total de 655,360 à 8,294,400 pixels. Par exemple, une sortie carrée 4k mesure 2880x2880, pas 4096x4096.

Images de référence

json

{
  "model": "gpt-image-2.5-sunburst",
  "prompt": "Keep the product and its lettering. Replace the background with a white studio.",
  "image_urls": ["https://example.com/product.png"],
  "resolution": "2k",
  "quality": "xhigh"
}

Les références utilisent cet endpoint JSON de génération. Chargez d’abord les images locales dans votre propre stockage. Les URI de données Base64, envois multipart, masques et endpoint distinct /images/edits ne font pas partie du contrat public de ce modèle.

Réponse

La connexion HTTP attend la fin ; les clients n’interrogent pas de tâche du fournisseur. Les réponses JSON contiennent les URL finales d’images et l’utilisation de tokens disponible :

json

{
  "created": 1789035000,
  "data": [{"url": "https://example.com/generated-image.png"}],
  "usage": {"input_tokens": 15, "output_tokens": 196, "total_tokens": 211}
}

Avec stream: true, attendez image_generation.completed et [DONE] sur la même connexion. Les aperçus partiels d’images ne sont pas garantis.

Tarifs

La facturation utilise les tokens réels de texte en entrée, de texte en cache, d’image en entrée, d’image en cache et d’image en sortie. Les deux variantes ont les mêmes tarifs par token. Le catalogue affiche votre prix actuel et, séparément, le prix de référence OpenAI. Une image n’est pas une unité à prix fixe : longueur de consigne, références, taille, qualité et quantité influencent le total. Une réservation temporaire est régularisée après la fin. Choisir explicitement la qualité rend l’utilisation attendue plus claire.

Les paramètres invalides renvoient 400 ; les échecs d’authentification, 401 ; un solde insuffisant, 402. Un modèle indisponible renvoie 404, les limites de débit renvoient 429 et les échecs de génération, 5xx. Ne renvoyez pas automatiquement une requête dont l’état de fin est inconnu.

Consultez Codes d’erreur et dépannage pour les codes d’erreur, échecs de streaming et limites des nouvelles tentatives.