> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aireiter.com/llms.txt
> Use this file to discover all available pages before exploring further.

# GPT-Image-2.6 이미지 생성

> - 비동기 처리 모드, 후속 조회를 위한 작업 ID 반환
- OpenAI GPT-Image 2.6 제품군: Flare(더 빠른 생성 속도) 및 Sunburst(디테일과 편집 충실도 중시)
- 텍스트-이미지 / 이미지-이미지 / 참조 이미지 편집 지원, 참조 이미지 최대 10장
- 14가지 비율 지원(auto 포함), aspect_ratio로 전달
- resolution 단계 1K / 2K / 4K 및 API 전용 size 사용자 지정 픽셀 지원
- GIF 애니메이션 출력 지원: output_format에 gif 전달, 프레임 수(2–9) 및 프레임당 시간 설정 가능
- 매 요청마다 1장의 이미지(PNG 또는 GIF) 반환
- 제출된 prompt는 플랫폼 민감어/안전성 검토를 거치며, 규정 위반 콘텐츠는 즉시 거부됨


> [!NOTE]
>
> GPT-Image 2.6은 AIReiter에서 `gpt_image_2_6_flare`와 `gpt_image_2_6_sunburst`라는 두 가지 모델 이름을 가지며, 별도의 `gpt_image_2_6`은 없습니다. 두 모델의 파라미터는 완전히 동일합니다.
>
> `output_format`은 `png`(기본값) 또는 `gif`를 선택할 수 있습니다. 본 인터페이스에서는 `quality`, `output_n`, `background`를 제공하지 않으며, SVG 벡터 이미지 및 마스크 / 영역 선택 부분 편집도 지원하지 않습니다.

## Authorizations

**Authorization** `string` *required*

모든 API는 Bearer Token을 사용하여 인증해야 합니다

API Key 받기:

[API Key 관리 페이지](https://aireiter.com/keys)에 접속하여 API Key를 발급받으세요

사용 시 요청 헤더에 추가:

```
Authorization: Bearer YOUR_API_KEY
```

## Body

**model** `string` *required*

모델 이름, 둘 중 하나 선택:

* `"gpt_image_2_6_flare"` — Flare, 이미지 생성이 더 빠르며 초안 및 대량 생성에 적합
* `"gpt_image_2_6_sunburst"` — Sunburst, 디테일에 더 집중하며 인물, 상품 또는 레이아웃을 보존해야 하는 편집에 적합

두 모델을 비교할 때는 prompt, 참조 이미지, 비율 및 해상도를 동일하게 유지하세요.

**params** `object` *required*

모델 매개변수 객체

**params 객체 속성**

**prompt** `string` *required*

이미지 생성을 위한 텍스트 설명

* 중국어 및 영어를 지원하며, 상세한 설명을 권장합니다
* 이미지 수정 시 무엇을 변경하고 어떤 것을 반드시 유지해야 하는지 명확히 작성하세요
* 투명 배경이 필요한 경우 프롬프트에 직접 명시하세요(예: "transparent background"). 투명화 여부는 모델이 결정합니다
* 제출 전 플랫폼의 민감어 / 보안 검토를 거치며, 위반 내용 감지 시 즉시 오류가 반환됩니다

**output\_format** `string` (default: png)

출력 형식, 기본값 `png`

* `png` - 정적 이미지
* `gif` - 반복 애니메이션, `frame_count`, `frame_duration_ms`와 함께 사용

> [!WARNING]
>
> `gif`의 경우 `image_url` 참조 이미지를 지원하지 않으며(전달 시 태스크 실패), `resolution`을 사용하지 않고 `aspect_ratio`는 `auto`, `1:1`, `16:9`, `9:16`, `4:3`, `3:4`, `3:2`, `2:3`만 지원합니다. 기타 비율을 전달하면 400이 반환됩니다.

**image\_url** `string[]`

참조 이미지 배열, 전달 시 이미지 기반 생성 / 편집 모드로 진행 (`output_format`이 `png`일 때만 사용 가능)

* 최대 10장의 참조 이미지
* 전달하지 않을 경우 순수 텍스트 기반 생성으로 진행
* 다음 두 가지 형식 지원:
  1. 공개적으로 접근 가능한 URL
  2. Base64 인코딩 형식
     * 완전한 Data URI 형식을 사용해야 함: `data:image/{형식};base64,{base64데이터}`
     * 지원하는 이미지 형식: jpeg, png, webp
     * 예시: `data:image/jpeg;base64,/9j/4AAQSkZJRgABAQEAYABg...`
     * ⚠️ 주의: 반드시 `data:image/jpeg;base64,` 접두사 부분을 포함해야 함

**aspect\_ratio** `string` (default: auto)

이미지 생성 비율, 기본값 `auto`

지원하는 값은 다음과 같습니다:

* `auto` - 가장 적합한 비율 자동 선택
* `1:1` - 정사각형
* `16:9` / `9:16` - 와이드스크린 가로 / 세로
* `4:3` / `3:4` - 표준 화면 가로 / 세로
* `3:2` / `2:3` - 클래식 가로 / 세로
* `5:4` / `4:5` - 준정사각형 가로 / 세로
* `2:1` / `1:2` - 넓은 가로 / 긴 세로
* `21:9` / `9:21` - 울트라 와이드 가로 / 울트라 롱 세로

> [!WARNING]
>
> 비율 문자열 또는 `auto`만 지원합니다. 픽셀 크기(예: `1024x1024`)를 전달하면 즉시 오류가 발생합니다. 정확한 픽셀이 필요한 경우 `size`를 사용하세요.

**resolution** `string` (default: 1K)

해상도 등급, 기본값 `1K`

* `1K` - 약 1024 기준
* `2K` - 약 2048 기준
* `4K` - 약 3840 기준

> [!WARNING]
>
> `size`를 전달할 때는 `resolution` / `aspect_ratio`를 함께 전달하지 마세요. 그렇지 않으면 400이 반환됩니다.

**frame\_count** `integer` (default: 9)

GIF 프레임 수, `output_format`이 `gif`일 때만 적용, 기본값 `9`

* 설정 범위 `2` \~ `9`, 범위 초과 시 400 반환

**frame\_duration\_ms** `integer` (default: 200)

GIF 프레임당 지속 시간(밀리초), `output_format`이 `gif`일 때만 적용, 기본값 `200`

* 설정 범위 `100` \~ `500`, 10밀리초 단위로 반올림, 범위 초과 시 400 반환
* 예: 9프레임 × 200밀리초, 1회 루프에 1.8초

**size** `string`

사용자 정의 픽셀 크기(API 전용, `aspect_ratio` / `resolution`과 **상호 배타적**)

형식은 `가로x세로`, 예: `2048x1536`, `3840x2160`.

**사용 제한:**

* 형식은 반드시 `^\d+x\d+$`이어야 함
* 가로, 세로 모두 16의 배수
* 각 변은 3840을 초과할 수 없음
* 긴 변 / 짧은 변 비율은 3:1을 초과할 수 없음
* 총 픽셀(가로 × 세로)은 **655,360 \~ 8,294,400**
* `aspect_ratio`, `resolution`과 상호 배타적이며, 동시에 전달 시 400 반환
* `gif`인 경우 비율에 따라 가장 가까운 GIF 프레임 크기로 변환됨(아래 GIF 프레임 크기 표 참조)

**out\_task\_id** `string` *required*

요청자 태스크 ID

사용자 정의 태스크 식별자, 필수. 결과 조회 시 동일한 값으로 `POST /api/openapi/query`를 호출합니다.

## 尺寸 × 分辨率映射表

`aspect_ratio × resolution` → 실제 픽셀(`auto`는 모델이 자동으로 선택하며, 표에 포함되지 않음):

| aspect\_ratio | `1K` | `2K` | `4K` |
| - | - | - | - |
| `1:1` | 1024×1024 | 2048×2048 | 2880×2880 |
| `3:2` | 1536×1024 | 2048×1360 | 3520×2336 |
| `2:3` | 1024×1536 | 1360×2048 | 2336×3520 |
| `4:3` | 1024×768 | 2048×1536 | 3312×2480 |
| `3:4` | 768×1024 | 1536×2048 | 2480×3312 |
| `5:4` | 1280×1024 | 2560×2048 | 3216×2576 |
| `4:5` | 1024×1280 | 2048×2560 | 2576×3216 |
| `16:9` | 1536×864 | 2048×1152 | 3840×2160 |
| `9:16` | 864×1536 | 1152×2048 | 2160×3840 |
| `2:1` | 1760×880 | 2688×1344 | 3840×1920 |
| `1:2` | 880×1760 | 1344×2688 | 1920×3840 |
| `21:9` | 1904×816 | 2688×1152 | 3840×1648 |
| `9:21` | 816×1904 | 1152×2688 | 1648×3840 |

> `3:2` / `2:3` @ 2K는 실제로 2048×1360(근사 비율)입니다. 표 외의 비율이 필요한 경우 `size`를 사용하세요.

## GIF 帧尺寸

`output_format`이 `gif`일 때, 각 프레임의 크기는 `aspect_ratio`에 의해 결정됩니다(`auto`는 `1:1` 기준):

| aspect\_ratio | 프레임당 크기 |
| - | - |
| `1:1` | 896×896 |
| `16:9` | 1088×608 |
| `9:16` | 608×1088 |
| `4:3` | 960×720 |
| `3:4` | 720×960 |
| `3:2` | 1008×672 |
| `2:3` | 672×1008 |

## Response

**out\_task\_id** `string`

요청자 작업 ID, 결과 조회에 사용 가능

**status** `string`

초기 상태, 일반적으로 `"pending"`

**created\_at** `string`

생성 시간(ISO 형식)

## Query Task

GPT-Image 2.6은 비동기 이미지 생성 모델입니다. 작업을 제출한 후 `out_task_id`를 사용하여 작업 상태를 조회하세요. [작업 상태 조회](https://docs.aireiter.com/ko/api-reference/tasks/status.md)를 참고할 수도 있습니다.

**out\_task\_id** `string` *required*

작업 제출 시 전달한 요청자 작업 ID입니다.

```bash theme={null}
curl --request POST \
  --url https://aireiter.com/api/openapi/query \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "out_task_id": "my_task_123456"
  }'
```

조회가 성공하고 완료되면 응답의 `output` 배열에 생성된 이미지(PNG 또는 GIF)가 포함됩니다.

실측 기준 단일 1K 이미지는 약 25~~45초, GIF는 약 25~~70초 만에 완료되며, Sunburst는 일반적으로 Flare보다 약간 느립니다. 해상도가 높을수록, 참조 이미지가 많을수록 시간이 더 오래 걸리므로 중복 제출하지 말고 지속적으로 폴링해 주세요.

## 使用说明

* `prompt`만 전달하면 텍스트 투 이미지로 동작하며, `image_url`을 전달하면 참조 이미지 편집으로 처리되어 프롬프트에 언급되지 않은 부분은 최대한 그대로 유지됩니다.
* 요청당 1장의 이미지만 반환되며, 여러 장이 필요한 경우 각각 제출해 주세요.
* 기본 출력은 PNG이며, `output_format: "gif"`를 전달하면 반복 재생되는 GIF 애니메이션이 출력됩니다.
* GIF는 `prompt`만을 기반으로 생성되므로 프롬프트에 피사체, 동작 및 반복 방식을 명확히 작성해 주세요(예: "손을 흔든 후 초기 자세로 돌아가기"). 동작이 단순할수록 프레임 간 연결이 자연스럽습니다.
* 4K 옵션은 대형 결과물이 필요한 시나리오에 적합합니다. 디테일 요구도가 높은 사실적인 이미지의 경우, 먼저 1K / 2K로 구도를 확인한 후 4K로 생성하는 것을 권장합니다.

## Request Examples

```bash cURL (Flare + aspect_ratio) theme={null}
curl --request POST \
  --url https://aireiter.com/api/openapi/submit \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "gpt_image_2_6_flare",
    "params": {
      "prompt": "플랫 벡터 스타일 포스터: 초승달 아래 앉아 있는 여우, 제목 텍스트 \"NIGHT SHIFT\", 단색 블록, 흰색 배경",
      "aspect_ratio": "16:9",
      "resolution": "1K"
    },
    "out_task_id": "my_task_123456"
  }'
```

```bash cURL (Sunburst + 참조 이미지) theme={null}
curl --request POST \
  --url https://aireiter.com/api/openapi/submit \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "gpt_image_2_6_sunburst",
    "params": {
      "prompt": "주황색 사각형을 종이 상자로 변경하고, 나머지 화면은 그대로 유지",
      "image_url": ["https://example.com/product.png"],
      "aspect_ratio": "1:1",
      "resolution": "2K"
    },
    "out_task_id": "my_task_edit_001"
  }'
```

```bash cURL (size 사용자 지정 크기) theme={null}
curl --request POST \
  --url https://aireiter.com/api/openapi/submit \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "gpt_image_2_6_flare",
    "params": {
      "prompt": "플랫 벡터 스타일 포스터: 초승달 아래 앉아 있는 여우, 제목 텍스트 \"NIGHT SHIFT\", 단색 블록, 흰색 배경",
      "size": "2048x1152"
    },
    "out_task_id": "my_task_size_001"
  }'
```

```bash cURL (GIF 애니메이션) theme={null}
curl --request POST \
  --url https://aireiter.com/api/openapi/submit \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "model": "gpt_image_2_6_flare",
    "params": {
      "prompt": "빨간 발자국 스카프를 두른 새끼 고양이가 일어서서 앞발을 흔듦, 아늑한 거실, 흔든 후 원래 자세로 돌아감, 매끄러운 무한 반복",
      "output_format": "gif",
      "aspect_ratio": "1:1",
      "frame_count": 9,
      "frame_duration_ms": 200
    },
    "out_task_id": "my_task_gif_001"
  }'
```

```python Python theme={null}
import requests

url = "https://aireiter.com/api/openapi/submit"

payload = {
    "model": "gpt_image_2_6_flare",
    "params": {
        "prompt": "플랫 벡터 스타일 포스터: 초승달 아래 앉아 있는 여우, 제목 텍스트 \"NIGHT SHIFT\", 단색 블록, 흰색 배경",
        "aspect_ratio": "16:9",
        "resolution": "1K"
    },
    "out_task_id": "my_task_123456"
}

headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)
print(response.json())
```

```javascript JavaScript theme={null}
const url = "https://aireiter.com/api/openapi/submit";

const payload = {
  model: "gpt_image_2_6_flare",
  params: {
    prompt: "플랫 벡터 스타일 포스터: 초승달 아래 앉아 있는 여우, 제목 텍스트 \"NIGHT SHIFT\", 단색 블록, 흰색 배경",
    aspect_ratio: "16:9",
    resolution: "1K"
  },
  out_task_id: "my_task_123456"
};

fetch(url, {
  method: "POST",
  headers: {
    Authorization: "Bearer <token>",
    "Content-Type": "application/json"
  },
  body: JSON.stringify(payload)
})
  .then((response) => response.json())
  .then((data) => console.log(data));
```

```go Go theme={null}
package main

import (
    "bytes"
    "encoding/json"
    "fmt"
    "io"
    "net/http"
)

func main() {
    url := "https://aireiter.com/api/openapi/submit"
    payload := map[string]interface{}{
        "model": "gpt_image_2_6_flare",
        "params": map[string]interface{}{
            "prompt":       "플랫 벡터 스타일 포스터: 초승달 아래 앉아 있는 여우, 제목 텍스트 \"NIGHT SHIFT\", 단색 블록, 흰색 배경",
            "aspect_ratio": "16:9",
            "resolution":   "1K",
        },
        "out_task_id": "my_task_123456",
    }
    jsonData, _ := json.Marshal(payload)
    req, _ := http.NewRequest("POST", url, bytes.NewBuffer(jsonData))
    req.Header.Set("Authorization", "Bearer <token>")
    req.Header.Set("Content-Type", "application/json")
    resp, err := http.DefaultClient.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()
    body, _ := io.ReadAll(resp.Body)
    fmt.Println(string(body))
}
```

```json 200 theme={null}
{
    "statusCode": 200,
    "message": "",
    "data": {
        "out_task_id": "my_task_123456",
        "status": "pending",
        "created_at": "2026-11-06T06:00:00.000Z"
    }
}
```

```json 400 theme={null}
{
    "statusCode": 400,
    "message": "유효하지 않은 요청 매개변수입니다",
    "ok": false
}
```

```json 401 theme={null}
{
  "error": {
    "code": 401,
    "message": "인증에 실패했습니다. API 키를 확인해 주세요"
  }
}
```

```json 500 theme={null}
{
  "error": {
    "code": 500,
    "message": "내부 서버 오류가 발생했습니다. 잠시 후 다시 시도해 주세요"
  }
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.