عقد تكامل GPT Image 2.6 | وثائق 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.

تم إعداد التكامل لـ gpt-image-2.6-flare / gpt-image-2.6-sunburst. لا تزال وثائق APIMart تصف هذه الواجهة بأنها معاينة تكامل. تعتمد الإتاحة على مفتاح API الحالي وتفعيل البوابة؛ تحقق من GET https://api.apihop.ai/v1/models.

الطلب

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
}

المعلمات

المعلمة	القيم
`model`	`gpt-image-2.6-flare`, `gpt-image-2.6-sunburst`
`prompt`	نص مطلوب
`n`	1–4
`size`	`auto`, نسبة الأبعاد, `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`	سلسلة، بحد أقصى 128 حرفاً
`stream`	`false` (JSON), `true` (SSE)

يجب أن تكون الأبعاد من مضاعفات 16، وألا يزيد أي ضلع عن 3840 أو النسبة عن 3:1، بإجمالي 655,360–8,294,400 بكسل. تستخدم المراجع روابط عامة في image_urls على نقطة النهاية نفسها. لا يشمل التكامل الأولي مراجع base64 أو رفع multipart أو الأقنعة أو markup أو GIF أو SVG أو الرسوم المتحركة أو /images/edits.

الاستجابة

ينتظر الاتصال الاكتمال. يعيد JSON الروابط النهائية في data[].url ورموز usage المتاحة. ينتهي SSE عبر image_generation.completed و[DONE]؛ المعاينات الجزئية غير مضمونة. لا يستعلم العميل دورياً عن مهمة المنبع. لا تُعد إرسال طلب مجهول حالة الاكتمال.

التسعير

تُحسب رموز إدخال النص والنص المخزن مؤقتاً وإدخال الصور والصور المخزنة مؤقتاً وإخراج الصور بشكل منفصل. راجع سعر الكتالوج الحالي؛ تُسوّى الحجوزات بعد الاكتمال. الأسعار المرجعية لـ APIMart لا تثبت تكلفة الحساب أو الإتاحة الفعلية.