텍스트로 이미지 생성
Cheapest Imagen API로 텍스트 프롬프트에서 이미지를 생성하고, 모델, 크기, 품질, 이미지 수, 출력 파일 형식을 선택합니다.
프롬프트를 POST /v1/images/generations로 보냅니다. 필수 항목은 model과 prompt뿐입니다.
curl https://api.cheapestimagen.com/v1/images/generations \
-H "Authorization: Bearer $YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "gpt-image-2",
"prompt": "a lighthouse at dusk, oil painting",
"n": 2,
"size": "1536x1024",
"quality": "high"
}'옵션
| 필드 | 설명 | 값 |
|---|---|---|
n | 이미지 수 | 1~10, 기본값 1 |
size | 가로와 세로 | auto 또는 1K, 2K, 4K 크기. 비율과 크기 참고 |
quality | 렌더링 품질, 모두 같은 가격 | auto, low, medium, high; gpt-image-2.5-sunburst에서는 xhigh, max |
background | 투명 또는 단색 배경 | auto, opaque, transparent |
output_format | 파일 형식 | 모든 모델에서 png(기본값), jpeg, webp; gpt-image-2.6과 그 flare, sunburst 버전에서 gif; gpt-image-2.6에서 svg |
output_compression | jpeg와 webp의 품질 | 0~100, 기본값 100 |
moderation | 콘텐츠 검사의 엄격도 | auto, low |
response_format | 이미지 데이터 또는 링크 | b64_json(기본값), url |
현재는 어떤 모델도 투명 배경을 만들지 않습니다. OpenAI가 GPT Image 모델의 투명 배경 미리보기를 철회했으며, 지금은 단색 배경이 반환됩니다. background: transparent로 요청하면 코드 unsupported_parameter와 함께 400이 반환됩니다. 누끼 이미지가 필요하면 프롬프트에서 단색 배경 하나를 요청한 뒤 나중에 배경을 제거하세요.
출력 형식
PNG, JPEG, WebP는 OpenAI API와 마찬가지로 모든 모델에서 사용할 수 있습니다. 대부분의 모델은 PNG를 만들고, 요청하신 JPEG나 WebP로는 Cloudflare 네트워크 안에서 변환합니다(약 0.1~0.4초이며, 2 MB PNG는 약 250 KB의 JPEG 또는 WebP가 됩니다). gpt-image-2.6-flare와 gpt-image-2.6-sunburst는 JPEG와 WebP를 직접 만듭니다.
| 모델 | PNG | JPEG | WebP | GIF | SVG |
|---|---|---|---|---|---|
gpt-image-2, gpt-image-2.5, gpt-image-2-adobe | 지원 | 지원 | 지원 | – | – |
gpt-image-2.6 | 지원 | 지원 | 지원 | 지원 | 지원 |
gpt-image-2.5-flare, gpt-image-2.5-sunburst | 지원 | 지원 | 지원 | – | – |
gpt-image-2.6-flare, gpt-image-2.6-sunburst | 지원 | 지원 | 지원 | 지원 | – |
| Nano Banana(모든 버전) | 지원 | 지원 | 지원 | – | – |
“–”는 400을 반환합니다. output_compression은 모든 모델에서 JPEG 또는 WebP의 품질을 정합니다(기본값 100). GIF는 3~5분이 걸릴 수 있습니다. 파일의 실제 형식은 링크의 확장자와 Content-Type에서 확인할 수 있습니다.
요청 한 번에 쓰는 크레딧
요청 한 번에는 모델 크레딧의 n배가 사용됩니다. GPT Image 2, 2.5, 2.6은 이미지당 8, Nano Banana 2와 2.1은 12, Nano Banana Pro, gpt-image-2-adobe, flare 버전은 20, sunburst 버전은 25, Nano Banana 안정 채널은 60~180입니다. 요청한 수보다 적은 이미지가 반환되면 받은 이미지에 대해서만 지불합니다.
같은 요청을 두 번 보내기
원하는 값으로 Idempotency-Key 헤더를 추가하세요. 첫 요청이 진행 중이거나 성공한 뒤에 같은 키가 다시 도착하면 API는 409로 응답하며, 다시 생성하거나 과금하지 않습니다. 요청이 실패한 뒤에는 같은 키를 다시 사용할 수 있습니다.