소개
GPT Image 2.5 Sunburst 이미지 편집은 OpenAI의 gpt-image-2.5-sunburst를 가지고 있는 이미지에 적용합니다. 원본 1~16장, 선택적 PNG 마스크, 투명 배경 옵션을 받으며, 편집 정확도가 가장 중요할 때 OpenAI가 권하는 모델입니다.
가진 소재에 맞춰 모드 고르기
| 가진 것 | 모드 |
|---|---|
| 글로 쓴 브리프 | GPT Image 2.5 Sunburst 텍스트→이미지 |
| 바꾸고 싶은 이미지 | GPT Image 2.5 Sunburst 이미지 편집 |
핵심 기능 및 하이라이트
마스크, 충실도, 투명
마스크는 다시 그리는 범위를 투명한 픽셀로 제한하고, input_fidelity high는 얼굴과 원단을 원본에 더 가깝게 유지하며, background transparent는 PNG나 WebP로 실제 알파 채널을 돌려줍니다.
최대 16장의 원본
최대 16장의 이미지에서 인물, 장소, 제품을 한 번의 요청으로 합치고, 각각을 프롬프트 안의 순서로 가리킵니다. 원본 한 장마다 출력 한 장당 고정 입력 요금이 붙으므로 중요한 참고 이미지만 넣으십시오.
목적은 정밀함
저희 크림슨 드레스 편집에서는 원단만 바뀌었고 레이스 소매, 얼굴, 의자, 하나뿐인 키 라이트는 제자리에 남았습니다.
요청 파라미터
| 파라미터 | 필수 | 설명 |
|---|---|---|
prompt | 예 | 최대 5,000자입니다. 이미지에 넣을 단어는 모두 큰따옴표로 감싸고 위치를 적어 주십시오. 1자 이상 · 5000자 이하 |
image_urls | 예 | 원본 이미지는 1~16장입니다. 프롬프트에서는 순서로 가리키십시오(첫 번째 이미지, 두 번째 이미지). 1개 이상 · 16개 이하 |
mask_url | 아니요 | 첫 번째 원본 이미지와 같은 크기의 PNG로, 선택 사항입니다. 투명한 픽셀이 다시 그릴 영역을 표시하고 불투명한 부분은 그대로 남습니다. |
aspect_ratio | 아니요 | 1:3부터 3:1까지 15가지이며 기본값은 1:1입니다. 결과물은 원본이 아니라 선택한 비율을 따르며, 비율에 따라 요금이 달라집니다. |
resolution | 아니요 | 1k(기본값), 2k, 4k 중 하나입니다. 정사각형 이미지는 한 변이 1024, 2048, 2880픽셀이며 단계가 높을수록 장당 요금도 올라갑니다. |
quality | 아니요 | low, medium, high(기본값), xhigh, max 중 하나입니다. 단계가 올라갈수록 디테일이 늘고 시간과 요금도 늘어납니다. |
num_outputs | 아니요 | 요청당 1~10장이며 기본값은 1장입니다. 이미지마다 따로 과금됩니다. |
input_fidelity | 아니요 | low(기본값) 또는 high입니다. high는 원본의 얼굴, 원단, 인쇄된 디테일을 더 충실하게 유지합니다. |
background | 아니요 | auto(기본값), transparent, opaque 중 하나입니다. transparent는 png나 webp 출력이 필요하며 실제 알파 채널을 돌려줍니다. |
output_format | 아니요 | png(기본값), jpeg, webp 중 하나입니다. 요금은 바뀌지 않습니다. |
output_quality | 아니요 | jpeg와 webp의 압축 품질로 0~100 범위입니다. 값이 높을수록 디테일이 더 남고 파일도 커집니다. |
official_fallback | 아니요 | 기본값은 켜짐입니다. 1:1, 3:2, 2:3, 4:3, 3:4, 16:9, 9:16 중 한 비율로, 마스크 없이 input fidelity low, background auto 그대로 high 품질, 1k 크기의 PNG 1장을 받는 편집 요청은 먼저 이코노미 경로에서 실행됩니다. 기본값: |
요금
출력 이미지 장당 품질, 크기 단계, 비율에 따라 과금합니다. 공식 경로에서는 원본 이미지 한 장마다 출력 장당 고정 요금도 붙습니다. 합계는 제출 전에 견적에 표시됩니다. 1:1, 3:2, 2:3, 4:3, 3:4, 16:9, 9:16 중 한 비율로, 마스크 없이 input fidelity low, background auto 그대로 high 품질, 1k 크기의 PNG 1장을 받는 편집 요청은 이코노미 경로에서 이코노미 가격으로 시작합니다. Official fallback(기본값은 켜짐)이 켜져 있으면 그 경로가 거부했거나 완료하지 못한 요청은 공식 경로(공식 가격)에서 다시 실행되므로, 견적에는 시작 가격과 최대 금액이 함께 표시됩니다. 거부된 요청은 과금되지 않습니다. 공식 경로에서는 처음 100개를 넘는 긴 프롬프트에 입력 토큰 요금이 요청당 한 번 소액 붙습니다. 중국어·일본어·한국어 글자는 대략 한 글자에 1토큰입니다.
| 사양 | 요금 |
|---|---|
| $0.001816 / 장 |
| $0.001816 / 장 |
| $0.00244 / 장 |
| $0.00244 / 장 |
| $0.002752 / 장 |
| $0.002752 / 장 |
| $0.00304 / 장 |
| $0.00304 / 장 |
| $0.003568 / 장 |
| $0.003568 / 장 |
| $0.003808 / 장 |
| $0.003808 / 장 |
| $0.003856 / 장 |
| $0.003856 / 장 |
| $0.004192 / 장 |
| $0.004192 / 장 |
| $0.004744 / 장 |
| $0.004744 / 장 |
| $0.005104 / 장 |
| $0.00568 / 장 |
| $0.00568 / 장 |
| $0.00652 / 장 |
| $0.00652 / 장 |
| $0.007312 / 장 |
| $0.007312 / 장 |
| $0.008176 / 장 |
| $0.008176 / 장 |
| $0.008728 / 장 |
| $0.008728 / 장 |
| $0.010936 / 장 |
| $0.01396 / 장 |
| $0.01396 / 장 |
| $0.018592 / 장 |
| $0.018592 / 장 |
| $0.020998 / 장 (Official fallback 사용 시: 최대 $0.023992) |
| $0.020998 / 장 (Official fallback 사용 시: 최대 $0.023992) |
| $0.021472 / 장 |
| $0.021472 / 장 |
| $0.022 / 장 (Official fallback 사용 시: 최대 $0.028) |
| $0.022 / 장 (Official fallback 사용 시: 최대 $0.028) |
| $0.022864 / 장 (Official fallback 사용 시: 최대 $0.031456) |
| $0.022864 / 장 (Official fallback 사용 시: 최대 $0.031456) |
| $0.024136 / 장 |
| $0.024136 / 장 |
| $0.025636 / 장 (Official fallback 사용 시: 최대 $0.042544) |
| $0.0316 / 장 |
| $0.0316 / 장 |
| $0.034504 / 장 |
| $0.034504 / 장 |
| $0.037864 / 장 |
| $0.037864 / 장 |
| $0.043504 / 장 |
| $0.043504 / 장 |
| $0.049816 / 장 |
| $0.049816 / 장 |
| $0.054616 / 장 |
| $0.054616 / 장 |
| $0.055624 / 장 |
| $0.055624 / 장 |
| $0.059872 / 장 |
| $0.059872 / 장 |
| $0.07144 / 장 |
| $0.07144 / 장 |
| $0.075328 / 장 |
| $0.082936 / 장 |
| $0.082936 / 장 |
| $0.096472 / 장 |
| $0.096472 / 장 |
| $0.110728 / 장 |
| $0.110728 / 장 |
| $0.124624 / 장 |
| $0.124624 / 장 |
| $0.135064 / 장 |
| $0.135064 / 장 |
| $0.168976 / 장 |
| $0.002872 / 장 |
| $0.002872 / 장 |
| $0.004456 / 장 |
| $0.004456 / 장 |
| $0.005152 / 장 |
| $0.005152 / 장 |
| $0.005704 / 장 |
| $0.005704 / 장 |
| $0.006328 / 장 |
| $0.006328 / 장 |
| $0.006712 / 장 |
| $0.006712 / 장 |
| $0.007312 / 장 |
| $0.007312 / 장 |
| $0.008128 / 장 |
| $0.008128 / 장 |
| $0.009088 / 장 |
| $0.009088 / 장 |
| $0.009928 / 장 |
| $0.01108 / 장 |
| $0.01108 / 장 |
| $0.01276 / 장 |
| $0.01276 / 장 |
| $0.014176 / 장 |
| $0.014176 / 장 |
| $0.015904 / 장 |
| $0.015904 / 장 |
| $0.017296 / 장 |
| $0.017296 / 장 |
| $0.021808 / 장 |
| $0.024112 / 장 |
| $0.024112 / 장 |
| $0.03688 / 장 |
| $0.03688 / 장 |
| $0.041896 / 장 |
| $0.041896 / 장 |
| $0.043072 / 장 |
| $0.043072 / 장 |
| $0.048064 / 장 |
| $0.048064 / 장 |
| $0.055432 / 장 |
| $0.055432 / 장 |
| $0.062416 / 장 |
| $0.062416 / 장 |
| $0.062944 / 장 |
| $0.062944 / 장 |
| $0.067984 / 장 |
| $0.067984 / 장 |
| $0.07624 / 장 |
| $0.07624 / 장 |
| $0.086032 / 장 |
| $0.087496 / 장 |
| $0.087496 / 장 |
| $0.095248 / 장 |
| $0.095248 / 장 |
| $0.098968 / 장 |
| $0.098968 / 장 |
| $0.110656 / 장 |
| $0.110656 / 장 |
| $0.121312 / 장 |
| $0.121312 / 장 |
| $0.142816 / 장 |
| $0.142816 / 장 |
| $0.152632 / 장 |
| $0.171016 / 장 |
| $0.171016 / 장 |
| $0.19456 / 장 |
| $0.19456 / 장 |
| $0.220456 / 장 |
| $0.220456 / 장 |
| $0.248464 / 장 |
| $0.248464 / 장 |
| $0.274216 / 장 |
| $0.274216 / 장 |
| $0.342928 / 장 |
| $0.003736 / 장 |
| $0.003736 / 장 |
| $0.006016 / 장 |
| $0.006016 / 장 |
| $0.0076 / 장 |
| $0.0076 / 장 |
| $0.008368 / 장 |
| $0.008368 / 장 |
| $0.009304 / 장 |
| $0.009304 / 장 |
| $0.011176 / 장 |
| $0.011176 / 장 |
| $0.01192 / 장 |
| $0.01192 / 장 |
| $0.0124 / 장 |
| $0.0124 / 장 |
| $0.01324 / 장 |
| $0.01324 / 장 |
| $0.016216 / 장 |
| $0.0166 / 장 |
| $0.0166 / 장 |
| $0.02116 / 장 |
| $0.02116 / 장 |
| $0.023872 / 장 |
| $0.023872 / 장 |
| $0.026296 / 장 |
| $0.026296 / 장 |
| $0.028552 / 장 |
| $0.028552 / 장 |
| $0.032272 / 장 |
| $0.032272 / 장 |
| $0.035992 / 장 |
| $0.050776 / 장 |
| $0.050776 / 장 |
| $0.056176 / 장 |
| $0.056176 / 장 |
| $0.0652 / 장 |
| $0.0652 / 장 |
| $0.080464 / 장 |
| $0.080464 / 장 |
| $0.086752 / 장 |
| $0.086752 / 장 |
| $0.094288 / 장 |
| $0.094288 / 장 |
| $0.103984 / 장 |
| $0.103984 / 장 |
| $0.11296 / 장 |
| $0.11296 / 장 |
| $0.115576 / 장 |
| $0.115576 / 장 |
| $0.127864 / 장 |
| $0.127864 / 장 |
| $0.14272 / 장 |
| $0.14272 / 장 |
| $0.14272 / 장 |
| $0.168592 / 장 |
| $0.168592 / 장 |
| $0.184552 / 장 |
| $0.184552 / 장 |
| $0.197104 / 장 |
| $0.197104 / 장 |
| $0.201832 / 장 |
| $0.201832 / 장 |
| $0.253408 / 장 |
| $0.259552 / 장 |
| $0.259552 / 장 |
| $0.320608 / 장 |
| $0.320608 / 장 |
| $0.37588 / 장 |
| $0.37588 / 장 |
| $0.414736 / 장 |
| $0.414736 / 장 |
| $0.456544 / 장 |
| $0.456544 / 장 |
| $0.569656 / 장 |
활용 사례
승인된 사진 리터칭
승인된 사진의 옷, 색, 빛을 나머지 부분을 건드리지 않고 바꿉니다. 마스크가 있어도 없어도 됩니다.
레이아웃용 누끼
투명 배경의 인물과 제품을 배경 제거 단계 없이 레이아웃, 슬라이드, 제품 페이지에 바로 씁니다.
제품 색상 변형
제품 사진 한 장을 여러 마감이나 색으로 만들고, 제품에 마스크를 씌워 세트와 빛은 똑같이 유지합니다.
프롬프트 가이드 및 실전 팁
마스크는 원본에 맞춰 만들기
첫 번째 원본과 같은 픽셀 크기의 PNG로, 다시 그릴 곳만 투명하게 만드십시오. 불투명한 부분은 모두 보호됩니다.
보호 목록을 글로 적기
변경 사항 뒤에 남아야 할 것(얼굴, 머리카락, 포즈, 의자, 빛)을 적으십시오. 모델은 암묵적인 기대보다 글로 쓴 목록을 더 확실하게 따릅니다.
누끼에서는 남길 것을 적기
남길 피사체와 배경을 완전히 투명하게 할 것을 적고 output_format을 png나 webp로 두십시오.
레이아웃 전에 알파 채널 확인하기
돌려받은 PNG나 WebP를 레이아웃 도구에서 여십시오. 빈 영역은 실제 알파 채널이므로 키잉이나 마스킹 단계를 추가할 필요가 없습니다.
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.5-sunburst/edit",
"input": {
"aspect_ratio": "1:1",
"background": "auto",
"image_urls": [
"https://example.com/reference.png"
],
"input_fidelity": "low",
"num_outputs": 1,
"output_format": "png",
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette"
}
}'
# 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 레퍼런스에서 확인하세요.





