# ChatGPT Images 2.6 API ChatGPT Images 2.6 Flare 및 Sunburst 모델의 전체 API 참조 문서입니다. ## 모델 종류 이 API는 네 가지 모델을 지원합니다: | 모델 | ID | 설명 | |-------|-----|-------------| | **ChatGPT Images 2.6 Flare** | `gpt-image-2.6-flare` | 해상도와 품질을 조절할 수 있는 텍스트 기반 이미지 생성 | | **ChatGPT Images 2.6 Flare Edit** | `gpt-image-2.6-flare-edit` | 이미지 편집 및 여러 이미지 합성 | | **ChatGPT Images 2.6 Sunburst** | `gpt-image-2.6-sunburst` | 해상도와 품질을 조절할 수 있는 텍스트 기반 이미지 생성 | | **ChatGPT Images 2.6 Sunburst Edit** | `gpt-image-2.6-sunburst-edit` | 이미지 편집 및 여러 이미지 합성 | ## 간단 비교 Flare와 Sunburst는 다음 요청 옵션을 공통으로 사용합니다. | 기능 | Flare / Sunburst | Flare Edit / Sunburst Edit | |---------|-----------------|---------------------------| | 입력 | 텍스트 프롬프트 | 이미지 + 텍스트 프롬프트 | | 해상도 옵션 | `1k`, `2k`, `4k` | `1k`, `2k`, `4k` | | 품질 옵션 | `low`, `medium`, `high`, `xhigh`, `max` | `low`, `medium`, `high`, `xhigh`, `max` | | 기본 품질 | `medium` | `medium` | | 화면 비율 | 10가지 옵션 | 10가지 옵션 | | 이미지 입력 | 없음 | 필수(이미지 1~16개) | | 출력 형식 | `png`, `jpeg`, `webp`, `gif`, `svg` | `png`, `jpeg`, `webp` | | 기본 출력 형식 | `png` | `png` | ### 지원하는 화면 비율 `16:9`, `9:16`, `1:1`, `3:2`, `2:3`, `3:4`, `4:3`, `5:4`, `4:5`, `21:9` ## ChatGPT Images 2.6 Flare (텍스트 기반 이미지 생성) ### 엔드포인트 ``` POST /api/v1/image/task ``` ### 인증 ``` Authorization: Bearer YOUR_API_KEY ``` ### 요청 매개변수 #### 필수 | 매개변수 | 유형 | 설명 | |-----------|------|-------------| | `model_name` | string | 지정해야 하는 값: `"gpt-image-2.6-flare"` | | `prompt` | string | 이미지 생성 프롬프트 | | `width` | integer | 너비 비율 값(예: `16:9`의 `16`)이며 픽셀 크기가 아님 | | `height` | integer | 높이 비율 값(예: `16:9`의 `9`)이며 픽셀 크기가 아님 | | `resolution` | string | `"1k"`, `"2k"` 또는 `"4k"` | width:height 비율은 위에 나열된 지원 화면 비율 중 하나와 일치해야 합니다. #### 선택 | 매개변수 | 유형 | 기본값 | 설명 | |-----------|------|---------|-------------| | `quality` | string | `"medium"` | `"low"`, `"medium"`, `"high"`, `"xhigh"` 또는 `"max"` | | `output_format` | string | `"png"` | 출력 형식: `"png"`, `"jpeg"`, `"webp"`, `"gif"` 또는 `"svg"`. GIF 애니메이션에는 `"gif"`, SVG 벡터 출력에는 `"svg"` 사용 | | `frame_count` | integer | `9` | GIF 프레임 수(`2`~`16`). `output_format`이 `"gif"`인 경우에만 적용 | | `frame_duration_ms` | integer | `200` | 밀리초 단위의 GIF 프레임 표시 시간(`20`~`2000`). `output_format`이 `"gif"`인 경우에만 적용 | ### 요청 예시 ```javascript const response = await fetch('https://api.flaq.ai/api/v1/image/task', { method: 'POST', headers: { 'Authorization': 'Bearer YOUR_API_KEY', 'Content-Type': 'application/json' }, body: JSON.stringify({ model_name: 'gpt-image-2.6-flare', prompt: 'A looping animation of steam rising from a ceramic mug on a pale stone table, warm studio lighting', width: 1, height: 1, resolution: '1k', quality: 'medium', output_format: 'gif', frame_count: 9, frame_duration_ms: 200 }) }); const { data } = await response.json(); const taskId = data.task_id; ``` ## ChatGPT Images 2.6 Flare Edit (이미지 편집) ### 엔드포인트 ``` POST /api/v1/image/task ``` ### 요청 매개변수 #### 필수 | 매개변수 | 유형 | 설명 | |-----------|------|-------------| | `model_name` | string | 지정해야 하는 값: `"gpt-image-2.6-flare-edit"` | | `prompt` | string | 원하는 편집 내용에 대한 설명 | | `image_url_list` | string[] | 입력 이미지 URL. 최소 1개, 최대 16개이며 각 이미지 크기는 50 MB 미만 | | `width` | integer | 너비 비율 값(예: `16:9`의 `16`)이며 픽셀 크기가 아님 | | `height` | integer | 높이 비율 값(예: `16:9`의 `9`)이며 픽셀 크기가 아님 | | `resolution` | string | `"1k"`, `"2k"` 또는 `"4k"` | width:height 비율은 위에 나열된 지원 화면 비율 중 하나와 일치해야 합니다. #### 선택 | 매개변수 | 유형 | 기본값 | 설명 | |-----------|------|---------|-------------| | `quality` | string | `"medium"` | `"low"`, `"medium"`, `"high"`, `"xhigh"` 또는 `"max"` | | `output_format` | string | `"png"` | 출력 형식: `"png"`, `"jpeg"` 또는 `"webp"` | ### 요청 예시 ```javascript const response = await fetch('https://api.flaq.ai/api/v1/image/task', { method: 'POST', headers: { 'Authorization': 'Bearer YOUR_API_KEY', 'Content-Type': 'application/json' }, body: JSON.stringify({ model_name: 'gpt-image-2.6-flare-edit', prompt: 'Replace the background with a warm studio setting while keeping the product unchanged', image_url_list: ['https://example.com/product-photo.jpg'], width: 1, height: 1, resolution: '1k', quality: 'medium', output_format: 'png' }) }); const { data } = await response.json(); const taskId = data.task_id; ``` ## ChatGPT Images 2.6 Sunburst (텍스트 기반 이미지 생성) ### 엔드포인트 ``` POST /api/v1/image/task ``` ### 요청 매개변수 #### 필수 | 매개변수 | 유형 | 설명 | |-----------|------|-------------| | `model_name` | string | 지정해야 하는 값: `"gpt-image-2.6-sunburst"` | | `prompt` | string | 이미지 생성 프롬프트 | | `width` | integer | 너비 비율 값(예: `16:9`의 `16`)이며 픽셀 크기가 아님 | | `height` | integer | 높이 비율 값(예: `16:9`의 `9`)이며 픽셀 크기가 아님 | | `resolution` | string | `"1k"`, `"2k"` 또는 `"4k"` | width:height 비율은 위에 나열된 지원 화면 비율 중 하나와 일치해야 합니다. #### 선택 | 매개변수 | 유형 | 기본값 | 설명 | |-----------|------|---------|-------------| | `quality` | string | `"medium"` | `"low"`, `"medium"`, `"high"`, `"xhigh"` 또는 `"max"` | | `output_format` | string | `"png"` | 출력 형식: `"png"`, `"jpeg"`, `"webp"`, `"gif"` 또는 `"svg"`. GIF 애니메이션에는 `"gif"`, SVG 벡터 출력에는 `"svg"` 사용 | | `frame_count` | integer | `9` | GIF 프레임 수(`2`~`16`). `output_format`이 `"gif"`인 경우에만 적용 | | `frame_duration_ms` | integer | `200` | 밀리초 단위의 GIF 프레임 표시 시간(`20`~`2000`). `output_format`이 `"gif"`인 경우에만 적용 | ### 요청 예시 ```javascript const response = await fetch('https://api.flaq.ai/api/v1/image/task', { method: 'POST', headers: { 'Authorization': 'Bearer YOUR_API_KEY', 'Content-Type': 'application/json' }, body: JSON.stringify({ model_name: 'gpt-image-2.6-sunburst', prompt: 'A looping animation of steam rising from a ceramic mug on a pale stone table, warm studio lighting', width: 1, height: 1, resolution: '1k', quality: 'medium', output_format: 'gif', frame_count: 9, frame_duration_ms: 200 }) }); const { data } = await response.json(); const taskId = data.task_id; ``` ## ChatGPT Images 2.6 Sunburst Edit (이미지 편집) ### 엔드포인트 ``` POST /api/v1/image/task ``` ### 요청 매개변수 #### 필수 | 매개변수 | 유형 | 설명 | |-----------|------|-------------| | `model_name` | string | 지정해야 하는 값: `"gpt-image-2.6-sunburst-edit"` | | `prompt` | string | 원하는 편집 내용에 대한 설명 | | `image_url_list` | string[] | 입력 이미지 URL. 최소 1개, 최대 16개이며 각 이미지 크기는 50 MB 미만 | | `width` | integer | 너비 비율 값(예: `16:9`의 `16`)이며 픽셀 크기가 아님 | | `height` | integer | 높이 비율 값(예: `16:9`의 `9`)이며 픽셀 크기가 아님 | | `resolution` | string | `"1k"`, `"2k"` 또는 `"4k"` | width:height 비율은 위에 나열된 지원 화면 비율 중 하나와 일치해야 합니다. #### 선택 | 매개변수 | 유형 | 기본값 | 설명 | |-----------|------|---------|-------------| | `quality` | string | `"medium"` | `"low"`, `"medium"`, `"high"`, `"xhigh"` 또는 `"max"` | | `output_format` | string | `"png"` | 출력 형식: `"png"`, `"jpeg"` 또는 `"webp"` | ### 요청 예시 ```javascript const response = await fetch('https://api.flaq.ai/api/v1/image/task', { method: 'POST', headers: { 'Authorization': 'Bearer YOUR_API_KEY', 'Content-Type': 'application/json' }, body: JSON.stringify({ model_name: 'gpt-image-2.6-sunburst-edit', prompt: 'Replace the background with a warm studio setting while keeping the product unchanged', image_url_list: ['https://example.com/product-photo.jpg'], width: 1, height: 1, resolution: '1k', quality: 'medium', output_format: 'png' }) }); const { data } = await response.json(); const taskId = data.task_id; ``` ## 응답 형식 ### 최초 응답 네 가지 ChatGPT Images 2.6 모델 모두 폴링에 사용할 `task_id`를 반환합니다: ```json { "code": 0, "data": { "task_id": "{task_id}", "task_status": "submitted", "response_url": "https://api.flaq.ai/api/v1/image/{task_id}" }, "message": "success" } ``` ### 폴링 응답 `GET /api/v1/image/{task_id}`를 폴링하여 상태를 확인합니다: ```json { "code": 0, "data": { "task_id": "{task_id}", "task_status": "succeed", "task_status_msg": null, "response_url": "https://api.flaq.ai/api/v1/image/{task_id}", "task_result": { "credit": 0.0997, "images": [ { "url": "https://example.com/generated-image.jpeg" } ] } }, "message": "success" } ``` ### 상태 값 - `submitted`: 작업 접수 완료 - `processing`: 이미지 생성 또는 편집 진행 중 - `succeed`: 작업 성공적으로 완료 - `failed`: 작업 실패 ## 처리 시간 처리 시간은 모델, 출력 설정, 프롬프트의 복잡성, 참조 이미지 수에 따라 달라집니다. 작업 상태가 `succeed` 또는 `failed`가 될 때까지 폴링하세요. 제출되었거나 처리 중인 작업에는 아직 이미지 결과가 없을 수 있습니다. ## 권장 사항 1. **구도를 명확하게 설명하세요**: 프롬프트에 피사체, 프레이밍, 조명, 원하는 스타일을 명확히 설명하면 ChatGPT Images 2.6에서 최상의 결과를 얻을 수 있습니다. 2. **게시 용도에 맞는 화면 비율을 선택하세요**: 소셜 게시물, 배너, 제품 페이지 또는 편집 레이아웃에 맞게 비율을 미리 설정하세요. 3. **편집에는 선명한 원본 이미지를 사용하세요**: 선명하고 조명이 좋은 입력 이미지는 피사체의 고유한 특징을 유지하고 부분 편집 품질을 높이는 데 도움이 됩니다. 4. **여러 이미지 요청에는 유효한 참조 이미지만 포함하세요**: 편집 요청 시 시각적 지침이 충돌하지 않도록 필요한 이미지만 제공하세요.