본문으로 건너뛰기
Cheapest Imagen
API 레퍼런스

이미지 생성

텍스트 프롬프트로 이미지를 하나 이상 만듭니다. 요청이 시작되면 크레딧을 먼저 잡아 두고, 전달되지 않은 이미지의 크레딧은 돌려드립니다.

POST
/images/generations

텍스트 프롬프트로 이미지를 하나 이상 만듭니다. 요청이 시작되면 크레딧을 먼저 잡아 두고, 전달되지 않은 이미지의 크레딧은 돌려드립니다.

Authorization

apiKey
headerAuthorizationBearer <token>

API 키이며, Authorization: Bearer <key>로 보냅니다.

Header Parameters

Idempotency-Key?string

직접 정한 값으로, 최대 255자입니다. 같은 값을 다시 보내면 두 번째 요청을 만들거나 청구하지 않고 409를 반환합니다.

Lengthlength <= 255

Request Body

application/json
  1. body
model*string

사용할 모델입니다.

Value in"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자입니다.

Lengthlength <= 32000
n?integer

만들 이미지 수입니다. 요청 하나에 모델 크레딧의 n배가 듭니다. 1K는 최대 10장, 2K는 4장, 4K는 2장입니다.

Range1 <= value <= 10
Default1
size?string

auto는 모델이 정하게 합니다(해상도가 하나뿐인 모델은 그 해상도). 나머지 값은 1K, 2K, 4K 크기이며, 각 모델은 /ko/models의 카드에 적힌 해상도를 같은 가격으로 지원합니다. 비율은 크기 가이드를 참고하세요. gpt-image-2-adobe와 gpt-image-2.5-flare는 가로·세로 크기를 직접 지정할 수도 있습니다. 16의 배수, 한 변 최대 3840px, 비율 3:1 이하, 655,360~8,294,400 픽셀입니다.

Default"auto"
Value in"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에서만 동작합니다. 품질에 따른 가격 차이는 없습니다.

Default"auto"
Value in"auto""low""medium""high""xhigh""max"
background?string

현재 투명 배경을 만드는 모델은 없으므로 transparent는 400을 반환합니다. auto와 opaque는 모든 모델에서 동작합니다.

Default"auto"
Value in"auto""opaque"
output_format?string

반환되는 이미지의 파일 형식입니다. gif는 gpt-image-2.6과 그 flare, sunburst 버전에서, svg는 gpt-image-2.6에서만 동작합니다. png, jpeg, webp는 모든 모델에서 동작합니다.

Default"png"
Value in"png""jpeg""webp""gif""svg"
output_compression?integer

jpeg와 webp의 품질로, 0~100입니다. 기본값은 100입니다.

Range0 <= value <= 100
moderation?string

프롬프트와 결과를 얼마나 엄격하게 검사할지 정합니다. low가 더 느슨합니다.

Default"auto"
Value in"auto""low"
response_format?string

b64_json은 응답에 이미지 데이터를 담아 반환합니다. url은 72시간 동안 유지되는 이미지 링크를 반환합니다.

Default"b64_json"
Value in"b64_json""url"
async?boolean

true로 설정하면 요청을 백그라운드에서 실행합니다. 바로 작업 정보와 함께 202가 반환되며, 결과는 나중에 GET /images/tasks/{id}로 읽습니다. 이미지는 링크로 반환되므로 response_format은 url이거나 생략해야 합니다. Prefer: respond-async 헤더도 같은 역할을 합니다.

Defaultfalse
webhook_url?string

async와 함께 쓰는 https:// 주소로, 완료된 작업(GET /images/tasks/{id}와 같은 JSON)을 POST로 한 번 보냅니다. 최대 3번 시도합니다. webhook_secret을 보내면 호출에 서명이 붙습니다. 보내지 않으면 받은 내용은 API 키로 작업을 조회해 확인하세요.

Formaturi
webhook_secret?string

webhook_url과 함께 쓰는 직접 정한 비밀 값으로, 16~128자입니다. 그러면 주소로 가는 호출에 x-webhook-signature: t=<unix seconds>,v1=<hex>가 붙으며, hex는 이 비밀 값으로 만든 <t>.<body>의 HMAC-SHA256입니다.

Length16 <= length <= 128

Response Body

생성된 이미지입니다.

application/json
  1. response
created*integer

이미지가 만들어진 시각으로, 초 단위 Unix 타임스탬프입니다.

data*array<>
Example Request
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"}'
Example Response
{  "created": 0,  "data": [    {      "b64_json": "string",      "url": "http://example.com"    }  ]}