소개
Sunburst 편집은 원본 1~16장과 보존하거나 바꿀 내용을 설명한 지시문을 받습니다. 크기가 같은 PNG 마스크로 첫 이미지에서 다시 그릴 영역을 지정할 수 있습니다.
| 항목 | 값 |
|---|---|
| 입력 | 이미지 |
| 출력 | 이미지 |
| 제공사 | OpenAI |
| 출시일 | 2026-11-05 |
| API 모델 | gpt-image-2.6-sunburst |
| 공개 엔드포인트 | openai/gpt-image-2.6-sunburst/text-to-image; openai/gpt-image-2.6-sunburst/edit |
| 품질 | low, medium (기본값), high, xhigh, max |
| 해상도 | 1k: 약 1MP; 2k: 약 3.7MP; 4k: 약 8.3MP |
| 16:9 크기 | 2k: 2560 x 1440; 4k: 3840 x 2160 |
| 화면 비율 | 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3, 21:9, 9:21, 2:1, 1:2, 3:1, 1:3, 5:4, 4:5 |
| 출력 수 | 요청당 이미지 1~10장 |
| 편집 원본 | 입력 이미지 1~16장 |
| 마스크 | 선택 사항인 PNG로, 첫 이미지와 크기가 같아야 합니다. 투명 픽셀은 다시 그릴 영역을 표시합니다. |
| 배경 | auto, opaque, transparent; 투명 배경에는 PNG 또는 WebP가 필요합니다. |
| 파일 형식 | PNG (기본값), JPEG, WebP · GIF(텍스트 기반 생성 전용) |
핵심 기능 및 하이라이트
야경을 향한 회전
명확한 회전 동작과 야간 조명을 지정해 연속성을 살필 기준을 만듭니다.
재즈 바의 건배
건배 다음에 윙크를 배치해 반복 장면의 순서를 정합니다.
파리 코트 수정
Sunburst 편집은 코트와 비 내리는 배경을 요청하기 전에 유지할 인물을 설명합니다.
요청 파라미터
| 파라미터 | 필수 | 설명 |
|---|---|---|
prompt | 예 | 필수 항목인 Sunburst 수정 지시문은 최대 5,000자이며 기본 텍스트는 없습니다. 매우 긴 프롬프트에는 토큰당 소액의 요금이 추가됩니다. 1자 이상 · 5000자 이하 |
image_urls | 예 | Sunburst 입력 이미지 URL을 1~16개 제공합니다. 기본 원본은 없으며 Image 1, Image 2와 같이 지칭합니다. 1개 이상 · 16개 이하 |
mask_url | 아니요 | Sunburst의 선택적 PNG 마스크는 첫 이미지와 크기를 맞추며 투명 픽셀로 다시 그릴 영역을 표시합니다. 마스크 자체의 추가 요금은 없고 markup_url과 병용할 수 없습니다. |
markup_url | 아니요 | markup_url에는 첫 이미지와 같은 크기의 투명 PNG를 전달하고 원, 스케치 또는 메모로 변경할 곳을 표시합니다. 입력 이미지 1장으로 추가 과금되며 mask_url과 함께 사용할 수 없습니다. |
aspect_ratio | 아니요 | 1:3부터 3:1까지 15가지 비율 중에서 고릅니다. 지정하지 않으면 첫 번째 이미지의 형태를 유지하며, 이 경우 가장 작은 크기 단계에서만 쓸 수 있습니다. |
resolution | 아니요 | Sunburst 크기는 1k (약 1MP), 2k (약 3.7MP), 4k (약 8.3MP)에서 고릅니다. 여기에 기본값은 명시되어 있지 않으며 선택한 단계에 따라 가격이 달라집니다. |
quality | 아니요 | Sunburst의 세부 표현은 low, medium (기본값), high, xhigh, max로 설정합니다. 단계를 높이면 디테일, 렌더링 시간, 가격이 함께 늘어납니다. |
reasoning_effort | 아니요 | Sunburst의 reasoning_effort는 그리기 전 계획 수준으로 low, medium, high를 지원하며 생략 시 high입니다. 높은 설정은 많은 글자와 복잡한 배치에 도움이 되지만 시간이 더 걸리며 요금은 달라지지 않습니다. |
num_outputs | 아니요 | 요청당 Sunburst 이미지 1~10장을 지정합니다. 여기에 기본 수량은 명시되어 있지 않으며 출력되는 모든 이미지에 요금이 부과됩니다. |
background | 아니요 | Sunburst 배경은 auto, opaque, transparent 중 선택하며 여기에 기본값은 명시되어 있지 않습니다. 투명 배경에는 PNG 또는 WebP를 사용하며 배경 추가 요금은 없습니다. |
output_format | 아니요 | Sunburst의 기본 파일 인코딩은 png이며 jpeg와 webp도 선택할 수 있습니다. 형식 선택은 가격에 영향을 주지 않습니다. |
output_quality | 아니요 | Sunburst 편집 결과를 JPEG나 WebP로 저장할 때 압축 품질을 0~100으로 고릅니다. PNG에서는 쓰이지 않으며 Sunburst의 가격도 그대로입니다. |
요금
Sunburst는 품질과 해상도 단계에 따라 이미지별로 과금하며, 요청 이미지 수만큼 해당 요금이 늘어납니다. 편집에서는 입력 이미지마다 소액의 요금이 추가되고, 매우 긴 프롬프트에는 토큰당 소액의 요금이 붙습니다. 거부된 Sunburst 요청은 과금 대상에서 제외됩니다.
| 해상도 | 품질: low | 품질: medium | 품질: high | 품질: xhigh | 품질: max |
|---|---|---|---|---|---|
| $0.02232 / 장 | $0.03915 / 장 | $0.04743 / 장 | $0.08433 / 장 | $0.18972 / 장 |
| $0.04131 / 장 | $0.07299 / 장 | $0.08847 / 장 | $0.15723 / 장 | $0.35379 / 장 |
| $0.07479 / 장 | $0.13221 / 장 | $0.16011 / 장 | $0.28512 / 장 | $0.64044 / 장 |
활용 사례
여행 캠페인 이미지
여행지 이름, 짧은 제목, 정해진 색상 팔레트로 해변 포스터를 제작합니다.
카페 메뉴 이미지
인용 부호로 감싼 메뉴 항목과 선명한 아침 분위기를 담아 칠판 구성을 설명합니다.
인물 사진 수정
원본과의 연속성을 요청하면서 제공한 인물 사진의 배경을 비 내리는 거리로 바꿉니다.
프롬프트 가이드 및 실전 팁
제작 방향 설정
피사체, 소재, 빛을 묘사하고 필요한 짧은 문구는 인용 부호로 감싸서 적습니다.
세부 표현과 크기 선택
medium 품질로 시작하고 이미지가 들어갈 위치에 맞춰 1k, 2k, 4k를 고릅니다.
수정 내용 지정
편집할 때는 원본을 맨 앞에 넣고, 바꿀 내용에 앞서 유지할 요소를 설명합니다.
수정 영역 선택
특정 부분만 바꾸려면 첫 이미지와 크기가 같은 PNG 마스크를 제공합니다.
소개
GPT Image 2.6 Sunburst 이미지 편집은 글로 쓴 지시에 따라 제공된 사진을 바꿉니다. 이 정밀 모델은 반복 수정에서도 묘사의 충실도와 세부 요소의 일관성에 중점을 두며 입력 이미지 1~16장을 받습니다.
수정할 사진을 맨 앞에 넣고 추가 참조의 역할을 각각 설명합니다. 선택 사항인 PNG 마스크로 다시 그릴 영역을 표시할 수 있습니다. 자체 테스트에서는 의상과 장소를 바꾸면서 인물의 외형을 유지했습니다.
주요 기능과 특징
- 시각적 수정 지시: 첫 이미지와 같은 크기의 투명 PNG에 원이나 메모를 넣어 markup_url로 전달합니다. 입력 1장으로 추가 과금되며 mask_url과 병용하지 않습니다.
- 번호가 있는 참조: 원본을 Image 1, Image 2와 같은 번호로 부르며 각 이미지에서 무엇을 가져올지 설명합니다.
- 영역 재그리기: 원본과 같은 크기의 PNG 마스크에서 투명 픽셀이 첫 원본의 수정 영역을 나타냅니다.
- 형태 보존: 1k에서 aspect_ratio를 생략하면 첫 이미지의 형태를 유지합니다. 2k와 4k는 비율을 지정해야 합니다.
- 세부 표현 조절: 다섯 가지 품질 설정으로 렌더링 시간 및 비용과 세부 표현 수준을 조절합니다.
- 다양한 출력: 수정 결과를 PNG, JPEG 또는 WebP로 저장하며 PNG와 WebP는 투명 배경도 지원합니다.
활용 사례
- 의상 수정: 제공한 인물 사진을 캠페인 콘셉트용 카멜색 트렌치코트 장면으로 바꿉니다.
- 장소 변경: 유지해야 할 요소를 설명하면서 기존 인물의 배경을 비 내리는 파리 거리로 옮깁니다.
- 이미지 일부 보정: 포스터의 특정 부분을 마스크로 표시하고 배경의 세부 요소를 바꿔 달라고 요청합니다.
프롬프트 작성 가이드와 팁
- 원본 지정: ‘Image 1은 수정할 인물 사진입니다’로 시작해 편집 기준을 분명히 합니다.
- 연속성 설명: 새로운 의상이나 배경을 묘사하기 전에 ‘인물의 외형을 유지합니다’를 덧붙입니다.
- 참조 역할 배정: 입력을 추가할 때 ‘Image 2의 색상 팔레트를 사용합니다’라고 적습니다.
- 마스크 내 변경 설명: 크기를 맞춘 PNG 마스크와 함께 ‘표시한 벽을 청록색 페인트로 바꿉니다’처럼 요청합니다.
- 새 배경의 정확한 지정: ‘블루 아워의 비 내리는 파리 거리’로 장소와 빛의 시간대를 함께 정합니다.
- reasoning_effort는 low, medium, high(기본값)로 조정합니다. 높은 설정은 많은 글자와 복잡한 배치를 위한 계획 시간을 늘리지만 가격은 유지합니다.
API 빠른 시작
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "openai/gpt-image-2.6-sunburst/edit",
"input": {
"background": "auto",
"image_urls": [
"https://example.com/reference.png"
],
"num_outputs": 1,
"output_format": "png",
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"quality": "medium",
"resolution": "1k"
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
인증, 전체 스키마, 폴링과 오류 처리는 API 레퍼런스에서 확인하세요.
