빠른 시작
Cheapest Imagen API로 AI 이미지 생성을 세 단계로 시작합니다. 키를 만들고, 요청을 한 번 보내고, 응답에서 이미지를 읽으면 됩니다.
API는 OpenAI Images API와 같은 요청과 응답을 사용합니다. 이미 OpenAI를 호출하고 있다면 기본 URL과 키만 바꾸고 나머지 코드는 그대로 두면 됩니다.
1. API 키 받기
로그인한 뒤 API 키 페이지에서 키를 만듭니다. 새 계정에는 무료 이미지 5장이 있으며 API에서도 사용할 수 있습니다. 대상은 GPT Image 2, 2.5, 2.6의 1K 이미지이고, 요청당 1장입니다. 그 외에는 먼저 충전해야 합니다. 키는 sk-cheap-로 시작하며 한 번만 표시되므로 만들 때 바로 복사해 두세요.
2. 요청 보내기
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 red fox in the snow",
"size": "1536x1024"
}'from openai import OpenAI
client = OpenAI(
base_url="https://api.cheapestimagen.com/v1",
api_key="YOUR_KEY",
)
result = client.images.generate(
model="gpt-image-2",
prompt="a red fox in the snow",
size="1536x1024",
)import OpenAI from 'openai';
const client = new OpenAI({
baseURL: 'https://api.cheapestimagen.com/v1',
apiKey: process.env.YOUR_KEY,
});
const result = await client.images.generate({
model: 'gpt-image-2',
prompt: 'a red fox in the snow',
size: '1536x1024',
});3. 이미지 읽기
응답에는 이미지마다 항목이 하나씩 들어 있습니다. 기본적으로 각 항목은 이미지를 base64로 b64_json에 담아 반환합니다.
{
"created": 1794660236,
"data": [{ "b64_json": "iVBORw0KGgo..." }]
}링크로 받으려면 "response_format": "url"을 보내세요. 링크로 제공된 이미지는 72시간 동안 보관됩니다.
동기 방식과 비동기 방식
위 요청은 동기 방식입니다. 이미지가 준비되면 응답합니다. 요청이 오래 걸리거나 한꺼번에 많이 보낼 때는 비동기 방식을 사용합니다. "async": true를 추가하면 작업 ID를 바로 받고, 이후 작업을 폴링하거나 webhook_url을 함께 보내면 완료 시 저희가 호출합니다. 두 방식의 요금은 같습니다. 폴링, 여러 작업 일괄 조회, 웹훅은 동기 요청과 비동기 요청에서 설명합니다.
요금
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 안정 채널(-1k, -2k, -4k)은 60~180크레딧입니다. 크기와 품질은 가격에 영향을 주지 않습니다(1크레딧은 $0.001에서 약 $0.0018이며, /pricing을 참고하세요). 실패한 요청은 비용이 들지 않습니다. 요청이 시작될 때 크레딧을 보류하고, 전달되지 않은 이미지만큼 돌려드립니다. 한 가지 예외가 있습니다. Nano Banana 안정 채널(-1k, -2k, -4k)은 콘텐츠 사유로 거부된 이미지에도 요금이 부과됩니다.