본문으로 건너뛰기
Cheapest Imagen
가이드

텍스트로 이미지 생성

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_compressionjpeg와 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를 직접 만듭니다.

모델PNGJPEGWebPGIFSVG
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로 응답하며, 다시 생성하거나 과금하지 않습니다. 요청이 실패한 뒤에는 같은 키를 다시 사용할 수 있습니다.

이 페이지의 내용