> ## Documentation Index
> Fetch the complete documentation index at: https://docs.laozhang.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 이미지 API 과금과 실패 처리: 모더레이션, 타임아웃

> Nano Banana, GPT Image, Grok Imagine 요청이 어떤 경우에 과금되는지 오류, 모더레이션, 이미지 없는 HTTP 200, 타임아웃, 재시도, 동시 요청별로 정리합니다.

LaoZhang API는 이미지 모델을 호출당 또는 반환된 이미지당 과금합니다. 요청이 과금되는지는 HTTP 상태 코드만이 아니라 요청이 생성 단계까지 갔는지, 업스트림이 무엇을 반환했는지에 따라 정해집니다. 이 페이지는 세 계열의 규칙을 한 표에 모았으며 마지막 확인일은 **2026년 10월 10일**입니다.

| 항목 | 내용 |
| - | - |
| 과금 단위 | Nano Banana는 호출당, GPT Image 공식 포워딩은 토큰, `-vip`와 웹 모델은 호출당, Grok Imagine은 성공적으로 반환된 이미지당 |
| 플랫폼 동시 요청 제한 | 계정이나 토큰 단위 제한 없음. `429`는 업스트림 용량이나 잔액 때문에 발생하며 [동시 요청과 429](https://docs.laozhang.ai/ko/faq/api-concurrency.md) 참고 |
| 요청별 청구액 | 콘솔 [호출 로그](https://docs.laozhang.ai/en/faq/call-logs.md)에 모든 요청의 모델, 상태, 사용량, 금액이 기록됨 |
| 계열별 규칙 | [Nano Banana](https://docs.laozhang.ai/ko/api-capabilities/nano-banana-image.md), [GPT Image 2.5](https://docs.laozhang.ai/ko/api-capabilities/gpt-image-2-5.md), [Grok Imagine](https://docs.laozhang.ai/ko/api-capabilities/grok-imagine-image.md) |

## 요청 결과별 과금

| 요청 결과 | Nano Banana | GPT Image 공식 포워딩 | GPT Image VIP / 웹 | Grok Imagine |
| - | - | - | - | - |
| 잘못된 파라미터(400) | 생성 단계에 도달하지 않아 과금 안 함 | 과금 안 함 | 과금 안 함 | 이미지 과금 없음 |
| 인증 실패(401) | 과금 안 함 | 과금 안 함 | 과금 안 함 | 이미지 과금 없음 |
| 속도 제한 또는 업스트림 용량(429, 503) | 과금 안 함 | 과금 안 함 | 과금 안 함 | 이미지 과금 없음 |
| 업스트림 5xx 오류 | 과금 안 함 | 과금 안 함 | 과금 안 함 | 이미지 과금 없음 |
| 모더레이션 차단 | Google이 이미지 없이 텍스트 거절만 담아 HTTP 200으로 응답하며 **1회 과금** | 오류가 반환되고 과금 안 함 | 오류가 반환되고 과금 안 함 | 오류가 반환되고 이미지 과금 없음 |
| 이미지 없는 HTTP 200 | **1회 과금** | 이미지가 반환된 뒤에만 토큰 과금 | 이미지가 반환된 뒤에만 호출당 과금 | 반환된 이미지당 과금이므로 0장이면 0 |
| 클라이언트 타임아웃 또는 연결 끊김 | 서버가 작업을 끝내고 과금할 수 있음 | 동일 | 동일 | 동일 |
| 이미지는 반환됐지만 저장하지 못함 | 과금됨 | 과금됨 | 과금됨 | 과금됨. 반환된 URL은 임시 링크 |
| 요청 하나에 이미지 여러 장 | 개수 지정 불가. 호출당 이미지 한 장 | 실제 토큰 | 호출당 | `n` 1\~10, 반환된 이미지당 과금 |

세 계열 모두 업스트림이 200이 아닌 응답을 반환하면 과금하지 않습니다. 기준은 호출 로그이며, 호출 로그에 기록이 없는 요청은 과금되지 않았습니다.

세 계열 중 과금되는 '이미지 없음' 사례는 Nano Banana의 이미지 없는 HTTP 200뿐입니다. Google은 모더레이션 차단을 오류 코드 대신 짧은 거절 응답으로 돌려주고, LaoZhang API는 업스트림 HTTP 200을 한 번의 호출로 계산합니다. 흔한 원인과 피하는 방법은 [Nano Banana API 개요](https://docs.laozhang.ai/ko/api-capabilities/nano-banana-image.md)의 빈 응답 과금 방지 절을 참고하세요.

## 타임아웃과 재시도

클라이언트 타임아웃은 실패가 아닙니다. 서버에서는 이미 이미지가 생성되어 과금되었을 수 있습니다. 대량 작업은 다음 순서로 처리하세요.

1. 모든 요청의 제출 시각, 모델 ID, 파라미터, 응답을 기록합니다.
2. 타임아웃이나 연결 끊김 뒤에는 [호출 로그](https://api.laozhang.ai/log)에서 시각과 모델로 해당 요청을 찾아 상태와 청구액을 확인합니다.
3. 호출 로그에 성공으로 나오면 다시 제출하지 말고 반환된 이미지를 쓰거나 고객 지원에 가져와 달라고 요청합니다.
4. `429`와 `5xx`는 지수 백오프로 재시도합니다. 재시도는 새 요청이며 성공하면 따로 과금됩니다.
5. 이미지 없는 Nano Banana HTTP 200은 그대로 다시 보내지 마세요. 프롬프트나 참조 이미지를 먼저 바꾸세요. 같은 내용은 대개 다시 차단되고 매번 과금됩니다.
6. 클라이언트 타임아웃은 [요청 타임아웃](https://docs.laozhang.ai/ko/faq/request-timeout.md)의 권장값대로 설정합니다. 이미지 요청은 360초, 4K나 참조 이미지가 많은 요청은 600초입니다. 모델 가이드에 별도 타임아웃 권장값이 있으면 그것이 우선합니다.

## 동시 요청과 속도 제한

LaoZhang API는 계정이나 토큰 단위로 동시 요청을 제한하지 않으며, 트래픽을 여러 토큰으로 나눠도 제한이 올라가지 않습니다. 부하 중에 `429`가 오면 다음과 같이 대응하세요.

* 오류 본문에 `insufficient_user_quota`가 있으면 잔액이 부족한 것이므로 먼저 충전합니다.
* 그 밖의 `429`는 업스트림 모델의 속도 또는 용량 제한에서 오므로, 로컬 큐에서 동시 요청 수를 절반으로 줄인 뒤 천천히 늘립니다.
* `503`이 계속되면 파라미터 문제가 아니라 업스트림 용량 부족이므로 기다렸다가 재시도합니다.

큐와 세마포어 예제는 [동시 요청과 429](https://docs.laozhang.ai/ko/faq/api-concurrency.md)에 있습니다.

## 청구액에 이의가 있을 때

고객 지원에는 다음 정보를 보내 주세요. API 키 전체는 절대 보내지 마세요.

* 계정 이메일
* 요청 시각, 모델 ID, 호출 로그의 요청 식별자
* 응답 상태와 민감 정보를 가린 오류 내용
* 원하는 처리 방식

[hi@laozhang.ai](mailto:hi@laozhang.ai) 또는 Telegram [@laozhang\_cn](https://t.me/laozhang_cn)으로 문의하세요. 환불과 잔액 조정은 [이용약관](https://www.laozhang.ai/terms) 6항을 따릅니다.

## 자주 묻는 질문

### 실패한 요청은 항상 무료인가요?

업스트림이 200이 아닌 응답을 반환하면 과금하지 않습니다. 잘못된 파라미터, 인증 실패, 속도 제한, 업스트림 5xx 오류가 해당합니다. 예외는 Nano Banana 모더레이션 차단으로, Google이 오류 코드 대신 HTTP 200을 반환하므로 해당 요청은 1회 과금됩니다.

### 대량 작업에서 이중 과금을 피하려면 어떻게 하나요?

대상 이미지마다 작업 ID를 붙이고, 타임아웃 뒤에는 호출 로그를 확인하며, 원래 요청이 성공하지 않았을 때만 재시도하세요. 클라이언트 타임아웃이 자동 재제출을 일으키지 않게 해야 합니다. Grok Imagine은 한 요청에 최대 10장을 반환할 수 있으며 반환된 이미지마다 과금합니다.

### 요청 하나의 비용은 어디서 보나요?

호출 로그에 요청별 모델, 그룹, 상태, 사용량, 금액이 기록됩니다. 건당 과금 모델은 고정 금액이, GPT Image 공식 포워딩은 입력·출력 토큰과 환산 금액이, Google 검색 그라운딩을 켠 Nano Banana는 검색 횟수와 요금이 표시됩니다. 필드 설명은 [호출 로그 확인과 활용](https://docs.laozhang.ai/en/faq/call-logs.md)을 참고하세요.

## 관련 문서

* [Nano Banana API 개요](https://docs.laozhang.ai/ko/api-capabilities/nano-banana-image.md): 다섯 모델의 가격과 과금 규칙
* [GPT Image 2.5 API](https://docs.laozhang.ai/ko/api-capabilities/gpt-image-2-5.md): 공식 포워딩, VIP, 웹 경로의 과금
* [Grok Imagine API](https://docs.laozhang.ai/ko/api-capabilities/grok-imagine-image.md): 이미지당 과금과 오류 처리
* [이미지 생성 API 가격 비교](https://docs.laozhang.ai/ko/api-capabilities/image-generation-guide.md): 세 계열 나란히 비교
* [요청 타임아웃](https://docs.laozhang.ai/ko/faq/request-timeout.md): 타임아웃과 속도 제한 구분하기


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.