가이드
요청 제한과 대량 생성
Cheapest Imagen API의 요청 제한(분당 300건, 동시 50건), 429의 의미, 이중 과금 없이 재시도하며 수천 장의 이미지를 생성하는 방법을 안내합니다.
제한
| 제한 | 값 | 초과 시 오류 |
|---|---|---|
| 계정당 분당 요청 수 | 300 | 429 rate_limit_exceeded |
| 계정당 진행 중인 요청 수 | 50 | 429 concurrency_limit_exceeded |
요청당 이미지 수(n) | 1K에서 10, 2K에서 4, 4K에서 2 | 400 invalid_value |
| 시간당 거부된 프롬프트 수 | 10 | 429 moderation_paused, 1시간 동안 |
| 요청 한 건의 처리 시간 | 420초 | 504 upstream_timeout, 과금되지 않음 |
제한은 계정 단위이며, 계정의 모든 API 키와 사이트가 함께 사용합니다. 사용량 등급은 없습니다.
요청이 그렇게 오래 연결을 붙잡고 있을 필요는 없습니다. async: true로 보내면 바로 작업을 응답하고, 결과는 나중에 읽으면 됩니다. 동기 요청과 비동기 요청을 참고하세요.
이미지로 환산하면
진행 중인 요청 50건에 각각 10장씩이라면, 1K 이미지를 최대 500장까지 동시에 만들 수 있습니다. 1K 이미지 한 장은 보통 20~40초가 걸리므로, 이 제한이면 계정 하나로 시간당 수만 장을 생성할 여유가 있습니다. 더 필요하시면 사용량과 함께 support@cheapestimagen.com으로 문의해 주세요.
이중 과금 없이 재시도하기
429가 나오면 기다렸다가 요청을 다시 보내세요. 기다리는 시간은 매번 두 배로 늘립니다.502와504에서는 과금되지 않으므로 다시 보내세요.- 각 작업에
Idempotency-Key헤더를 추가하세요. 같은 키의 요청이 아직 진행 중이거나 이미 성공했다면, 다시 보낸 요청은409 idempotency_key_in_use로 응답하며 다시 생성하거나 과금하지 않습니다. 실패한 뒤에는 같은 키를 다시 사용할 수 있습니다.
import asyncio
from openai import AsyncOpenAI, RateLimitError, APIStatusError
client = AsyncOpenAI(base_url="https://api.cheapestimagen.com/v1", api_key="YOUR_KEY")
gate = asyncio.Semaphore(50) # requests in progress: the account limit
async def make(prompt: str, key: str):
async with gate:
for attempt in range(6):
try:
r = await client.images.generate(
model="nano-banana-2.1",
prompt=prompt,
size="1024x1024",
response_format="url",
extra_headers={"Idempotency-Key": key},
)
return r.data[0].url
except RateLimitError:
await asyncio.sleep(2 ** attempt)
except APIStatusError as e:
if e.status_code not in (502, 504):
raise
await asyncio.sleep(2 ** attempt)
async def main(prompts):
return await asyncio.gather(*(make(p, f"job-{i}") for i, p in enumerate(prompts)))결과 보관
response_format: "url"로 받은 링크는 72시간 동안 유효합니다. 파일은 도착하는 대로 직접 운영하는 저장소에 복사해 두세요.
실패하면 얼마나 드는가
비용은 없습니다. 받은 이미지에 대해서만 지불하며, 여러 장을 요청했는데 더 적게 반환되면 그만큼만 과금됩니다. 안정 채널(-1k, -2k, -4k로 끝나는 ID)은 예외로, 콘텐츠 사유로 거부된 이미지에는 요금이 부과됩니다. 모든 코드는 오류에서 확인할 수 있습니다.