요청 파라미터
| 파라미터 | 필수 | 설명 |
|---|---|---|
prompt | 예 | Describe the image you want. |
quality | 아니요 | 시간과 비용을 더 들여 디테일을 높입니다. low · medium · high · xhigh · max · 기본값: high |
resolution | 아니요 | 출력 크기. 클수록 선명하고 가격도 올라갑니다. 1k · 2k · 4k · 기본값: 1k |
num_outputs | 아니요 | 한 번에 만들 결과 수. ≥ 1 · ≤ 10 · 기본값: 1 |
aspect_ratio | 아니요 | 화면 모양: 가로, 정사각형, 세로. 1:1 · 1:2 · 1:3 · 2:1 · 2:3 · 3:1 · 3:2 · 3:4 · 4:3 · 4:5 · 5:4 · 9:16 · 9:21 · 16:9 · 21:9 · 기본값: 1:1 |
output_format | 아니요 | 결과 파일 형식. png · jpeg · webp · 기본값: png |
output_quality | 아니요 | Compression quality for JPEG and WebP, from 0 to 100. ≥ 0 · ≤ 100 |
가격
가격은 웹사이트에서 쓰는 것과 같은 크레딧으로 표시됩니다(1크레딧 = $0.01). 작업이 접수될 때 먼저 보류되고, 끝나면 실제 요금으로 정산되며, 실패한 작업은 환불됩니다.
| 옵션 | 크레딧 /장 | ≈ USD |
|---|---|---|
| aspect_ratio 1:3 · quality low · resolution 1K | 0.27 | US$0.0027 |
| aspect_ratio 3:1 · quality low · resolution 1K | 0.27 | US$0.0027 |
| aspect_ratio 21:9 · quality low · resolution 1K | 0.37 | US$0.0037 |
| aspect_ratio 9:21 · quality low · resolution 1K | 0.37 | US$0.0037 |
| aspect_ratio 1:2 · quality low · resolution 1K | 0.41 | US$0.0041 |
| aspect_ratio 2:1 · quality low · resolution 1K | 0.41 | US$0.0041 |
| aspect_ratio 1:3 · quality low · resolution 2K | 0.43 | US$0.0043 |
| aspect_ratio 3:1 · quality low · resolution 2K | 0.43 | US$0.0043 |
| aspect_ratio 16:9 · quality low · resolution 1K | 0.46 | US$0.0046 |
| aspect_ratio 9:16 · quality low · resolution 1K | 0.46 | US$0.0046 |
| aspect_ratio 2:3 · quality low · resolution 1K | 0.54 | US$0.0054 |
| aspect_ratio 3:2 · quality low · resolution 1K | 0.54 | US$0.0054 |
작업마다 크레딧은 정수로 올림 처리되므로, 가장 낮은 옵션으로 한 번 실행하면 1크레딧/장(US$0.01)입니다.
실행 전에 정확한 금액을 알고 싶다면 같은 본문을 POST /jobs/quote로 보내세요.
API 빠른 시작
GPT Image 2.5 Sunburst API를 3단계로 호출하기
- API 키 만들기. PopNow에 로그인해 API 콘솔에서 키를 만드세요. 키는 sk-popnow-(으)로 시작하며 웹사이트와 같은 크레딧을 씁니다.
- 요청 보내기. POST /jobs/createTask에 model은 openai/gpt-image-2.5-sunburst/text-to-image, input은 파라미터 표에 맞춰 보내세요. 응답으로 작업 ID가 바로 돌아옵니다.
- 결과 받기. 작업 ID로 GET /jobs/recordInfo를 폴링하거나 callBackUrl을 넘기면 결과를 그 주소로 보내 드립니다. 작업이 성공하면 출력 링크에서 내려받으세요.
# 1. Create the task. Keep the Idempotency-Key if you retry after a network error.
export IDEMPOTENCY_KEY="$(uuidgen)"
curl -X POST https://api.popnow.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $POPNOW_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $IDEMPOTENCY_KEY" \
-d '{
"model": "openai/gpt-image-2.5-sunburst/text-to-image",
"input": {
"prompt": "A ceramic teapot on a linen cloth, soft window light, muted palette",
"aspect_ratio": "1:1",
"resolution": "1k",
"quality": "high",
"num_outputs": 1,
"output_format": "png"
}
}'
# 2. Copy data.taskId from the response, then poll until state is succeeded, failed, canceled or expired.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $POPNOW_API_KEY"프롬프트와 링크는 직접 쓰는 것으로 바꾸세요. 응답, 폴링, 콜백 참고 자료는 API 탭에 있어요.
GPT Image 2.5 Sunburst API 질문
GPT Image 2.5 Sunburst API 요금은 얼마인가요?
GPT Image 2.5 Sunburst 가격은 가장 저렴한 이미지 만들기 기준 1크레딧(US$0.01) /장부터입니다. 옵션별 가격: 1:3 · low · 1K 0.27크레딧/장, 3:1 · low · 1K 0.27크레딧/장, 21:9 · low · 1K 0.37크레딧/장, 9:21 · low · 1K 0.37크레딧/장. 크레딧은 웹사이트와 같으며(1크레딧 = $0.01), 새 계정에는 30크레딧이 무료로 제공되고, 실패한 작업은 환불됩니다.
API에서 GPT Image 2.5 Sunburst의 모델 이름은 무엇인가요?
POST /jobs/createTask의 model 필드에 이미지 만들기: openai/gpt-image-2.5-sunburst/text-to-image; 이미지 편집: openai/gpt-image-2.5-sunburst/edit을(를) 넣으세요.
투명 배경이 정말 되나요?
네. background를 transparent로 두고 PNG나 WebP로 출력하면 저희 누끼 테스트에서 실제 알파 채널이 있는 결과가 돌아왔습니다. 이 옵션은 이미지 편집 엔드포인트에서 사용할 수 있습니다. 텍스트로 이미지를 생성하는 엔드포인트에는 배경 설정이 없습니다.
GPT Image 2.5 Sunburst API의 제한은 무엇인가요?
해상도: 1K · 2K · 4K; 화면 비율: 1:1 · 1:2 · 1:3 · 2:1 · 2:3 · 3:1 +9; 호출당 출력 수: 1–10; 프롬프트 길이(글자): 5,000. 이 범위를 벗어난 요청은 청구되기 전에 거부됩니다.
코드 없이 GPT Image 2.5 Sunburst을(를) 써 볼 수 있나요?
네. Playground에서는 API 키 없이 PopNow 크레딧으로 GPT Image 2.5 Sunburst을(를) 실행할 수 있고, 실행할 때마다 해당 코드를 보여 줍니다.
모든 GPT Image 모델
GPT Image 2.5 Flare는 옵션과 한 장당 가격이 같고 속도에 맞춰 조정되어 보통 더 빨리 끝나요. 최종 이미지와 정밀한 편집은 Sunburst가 맞아요.

