소개
GPT Image 2.5 Flare 이미지 편집은 OpenAI의 gpt-image-2.5-flare를 가지고 있는 이미지에 적용합니다. 원본 1~16장, PNG 마스크, 투명 배경 옵션을 받으며, 대화형으로 쓸 수 있을 만큼 빠르게 편집 결과를 돌려줍니다.
가진 소재에 맞춰 모드 고르기
| 가진 것 | 모드 |
|---|---|
| 글로 쓴 브리프 | GPT Image 2.5 Flare 텍스트→이미지 |
| 바꾸고 싶은 이미지 | GPT Image 2.5 Flare 이미지 편집 |
핵심 기능 및 하이라이트
여러 원본의 빠른 합성
두 장 이상의 원본을 한 장면으로 합치고 얼굴은 각자의 이미지 그대로 유지합니다. 저희 원본 두 장 예시는 1분보다 훨씬 짧게 끝났습니다.
마스크와 누끼
PNG 마스크로 다시 그리는 범위를 한 곳으로 제한하고, background transparent는 PNG나 WebP로 실제 알파 채널을 돌려주므로 키잉 없이 레이아웃에 씁니다.
한 번에 여러 변경
옷, 시간대, 날씨를 한꺼번에 바꿀 수 있습니다. 다만 프롬프트에 바뀌지 않을 것도 적으십시오. 저희 테라스 예시는 요청 한 번으로 드레스와 빛을 바꿨습니다.
요청 파라미터
| 파라미터 | 필수 | 설명 |
|---|---|---|
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 / 장 |
활용 사례
착장 변경과 리스타일
룩북이나 캠페인 시안용으로 같은 인물을 새 옷이나 새 장소에서 보여 주며, 요청당 여러 선택지를 만듭니다.
따로 찍은 인물 합치기
따로 촬영한 두 사람을 한 이미지에 담아 포스터, 썸네일, 스토리 패널에 씁니다.
시즌별 업데이트
여름 캠페인 이미지를 다음 시즌용 가을이나 밤 버전으로 바꾸고 인물과 제품은 그대로 둡니다.
프롬프트 가이드 및 실전 팁
원본마다 역할 주기
남성과 문간은 첫 번째 이미지, 여성은 두 번째 이미지라고 적으십시오. 순서가 프롬프트와 원본을 잇는 유일한 연결입니다.
관련된 변경은 묶기
새 옷과 다른 시간대는 한 번의 요청으로 잘 표현됩니다. 서로 관련 없는 변경은 따로 편집하는 편이 더 잘 됩니다.
얼굴에는 충실도 높이기
편집 뒤에도 얼굴을 알아볼 수 있어야 한다면 input_fidelity를 high로 두십시오. 요금은 바뀌지 않습니다.
배경 교체에는 마스크를
배경만 바꿀 때는 첫 번째 원본과 같은 크기의 PNG 마스크에서 피사체는 불투명하게, 배경은 투명하게 두십시오.
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-flare/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 레퍼런스에서 확인하세요.





