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

요청 제한과 대량 생성

Cheapest Imagen API의 요청 제한(분당 300건, 동시 50건), 429의 의미, 이중 과금 없이 재시도하며 수천 장의 이미지를 생성하는 방법을 안내합니다.

제한

제한값초과 시 오류
계정당 분당 요청 수300429 rate_limit_exceeded
계정당 진행 중인 요청 수50429 concurrency_limit_exceeded
요청당 이미지 수(n)1K에서 10, 2K에서 4, 4K에서 2400 invalid_value
시간당 거부된 프롬프트 수10429 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)은 예외로, 콘텐츠 사유로 거부된 이미지에는 요금이 부과됩니다. 모든 코드는 오류에서 확인할 수 있습니다.

이 페이지의 내용