이미지 생성
텍스트 프롬프트로 이미지를 하나 이상 만듭니다. 요청이 시작되면 크레딧을 먼저 잡아 두고, 전달되지 않은 이미지의 크레딧은 돌려드립니다.
텍스트 프롬프트로 이미지를 하나 이상 만듭니다. 요청이 시작되면 크레딧을 먼저 잡아 두고, 전달되지 않은 이미지의 크레딧은 돌려드립니다.
apiKeyAuthorizationBearer <token>API 키이며, Authorization: Bearer <key>로 보냅니다.
Idempotency-Key?string직접 정한 값으로, 최대 255자입니다. 같은 값을 다시 보내면 두 번째 요청을 만들거나 청구하지 않고 409를 반환합니다.
length <= 255application/json- body
model*string사용할 모델입니다.
"gpt-image-2""gpt-image-2-adobe""gpt-image-2.5""gpt-image-2.5-flare""gpt-image-2.5-sunburst""gpt-image-2.6""gpt-image-2.6-flare""gpt-image-2.6-sunburst""nano-banana-2""nano-banana-2.1""nano-banana-pro""nano-banana-2-1k""nano-banana-2-2k""nano-banana-2-4k""nano-banana-pro-1k""nano-banana-pro-2k""nano-banana-pro-4k"prompt*string이미지에 담을 내용입니다. 최대 32,000자입니다.
length <= 32000n?integer만들 이미지 수입니다. 요청 하나에 모델 크레딧의 n배가 듭니다. 1K는 최대 10장, 2K는 4장, 4K는 2장입니다.
1 <= value <= 101size?stringauto는 모델이 정하게 합니다(해상도가 하나뿐인 모델은 그 해상도). 나머지 값은 1K, 2K, 4K 크기이며, 각 모델은 /ko/models의 카드에 적힌 해상도를 같은 가격으로 지원합니다. 비율은 크기 가이드를 참고하세요. gpt-image-2-adobe와 gpt-image-2.5-flare는 가로·세로 크기를 직접 지정할 수도 있습니다. 16의 배수, 한 변 최대 3840px, 비율 3:1 이하, 655,360~8,294,400 픽셀입니다.
"auto""auto""1024x1024""1536x1024""1024x1536""1443x1090""1090x1443""1672x941""941x1672""1408x1120""1120x1408""1920x832""832x1920""1792x896""896x1792""1152x864""864x1152""1280x720""720x1280""1120x896""896x1120""1456x624""624x1456""1536x768""768x1536""2048x2048""2048x1360""1360x2048""2304x1728""1728x2304""2048x1152""1152x2048""2240x1792""1792x2240""2912x1248""1248x2912""3072x1536""1536x3072""2048x688""688x2048""2880x2880""3504x2336""2336x3504""3264x2448""2448x3264""3840x2160""2160x3840""3200x2560""2560x3200""3840x1648""1648x3840""3840x1920""1920x3840""3840x1280""1280x3840""2048x512""512x2048""3072x384""384x3072""4096x1024""1024x4096""6144x768""768x6144""8192x2048""2048x8192""12288x1536""1536x12288"quality?string렌더링 품질입니다. gpt-image-2-adobe와 flare, sunburst 버전에서 적용되고, 다른 GPT 모델은 품질을 스스로 정하며 Nano Banana는 무시합니다. xhigh와 max는 gpt-image-2.5-sunburst에서만 동작합니다. 품질에 따른 가격 차이는 없습니다.
"auto""auto""low""medium""high""xhigh""max"background?string현재 투명 배경을 만드는 모델은 없으므로 transparent는 400을 반환합니다. auto와 opaque는 모든 모델에서 동작합니다.
"auto""auto""opaque"output_format?string반환되는 이미지의 파일 형식입니다. gif는 gpt-image-2.6과 그 flare, sunburst 버전에서, svg는 gpt-image-2.6에서만 동작합니다. png, jpeg, webp는 모든 모델에서 동작합니다.
"png""png""jpeg""webp""gif""svg"output_compression?integerjpeg와 webp의 품질로, 0~100입니다. 기본값은 100입니다.
0 <= value <= 100moderation?string프롬프트와 결과를 얼마나 엄격하게 검사할지 정합니다. low가 더 느슨합니다.
"auto""auto""low"response_format?stringb64_json은 응답에 이미지 데이터를 담아 반환합니다. url은 72시간 동안 유지되는 이미지 링크를 반환합니다.
"b64_json""b64_json""url"async?booleantrue로 설정하면 요청을 백그라운드에서 실행합니다. 바로 작업 정보와 함께 202가 반환되며, 결과는 나중에 GET /images/tasks/{id}로 읽습니다. 이미지는 링크로 반환되므로 response_format은 url이거나 생략해야 합니다. Prefer: respond-async 헤더도 같은 역할을 합니다.
falsewebhook_url?stringasync와 함께 쓰는 https:// 주소로, 완료된 작업(GET /images/tasks/{id}와 같은 JSON)을 POST로 한 번 보냅니다. 최대 3번 시도합니다. webhook_secret을 보내면 호출에 서명이 붙습니다. 보내지 않으면 받은 내용은 API 키로 작업을 조회해 확인하세요.
uriwebhook_secret?stringwebhook_url과 함께 쓰는 직접 정한 비밀 값으로, 16~128자입니다. 그러면 주소로 가는 호출에 x-webhook-signature: t=<unix seconds>,v1=<hex>가 붙으며, hex는 이 비밀 값으로 만든 <t>.<body>의 HMAC-SHA256입니다.
16 <= length <= 128생성된 이미지입니다.
application/json- response
created*integer이미지가 만들어진 시각으로, 초 단위 Unix 타임스탬프입니다.
data*array<>curl -X POST 'https://api.cheapestimagen.com/v1/images/generations' \ -H 'Content-Type: application/json' \ -d '{ "model": "gpt-image-2", "prompt": "a red fox in the snow", "size": "1536x1024"}'{ "created": 0, "data": [ { "b64_json": "string", "url": "http://example.com" } ]}