Skip to main content

플랜 개요

고객님을 더 잘 지원하기 위해 APIYI는 Nano Banana Pro 실패 생성 크레딧 환급 플랜을 출시합니다.
이 플랜의 적용 대상 모델은 요청당 Nano Banana Pro뿐입니다. Nano Banana 2의 경우 token 기반 token을 선택할 수 있으며, 실패한 호출은 극히 적은 금액으로 과금되므로 무시해도 됩니다.
요청이 status code 200을 반환했지만 이미지 생성이 실패한 경우, 이는 Google 측에서 발생한 피드백입니다. APIYI는 결과를 단순히 전달하는 투명한 프록시이며, 저희도 고객님만큼 이미지가 성공하기를 바랍니다. 이 플랜은 이러한 주관적이지 않은 사유로 발생한 실패에 대해 크레딧을 환급합니다.

Nano Banana Pro가 생성에 실패하는 경우는?

Google의 콘텐츠 모더레이션 정책은 계속 강화되고 있습니다. 거부를 유발하는 일반적인 상황은 다음과 같습니다.
  • 콘텐츠 안전성: NSFW 또는 미성년자 관련 콘텐츠
  • 워터마크 제거: 특히 예외적인 범주입니다
  • 잘 알려진 IP (2026년 1월 23일 추가): Disney 등 — Google이 새로운 모더레이션 정책을 도입한 것으로 보입니다
  • 더 엄격한 안전 메커니즘 (2026년 2월 27일, Nano Banana 2 출시 후): 잘 알려진 공인, 금융/주문 정보 수정, 인물 의상 교체/얼굴 교체, 암시적 성적 콘텐츠 등은 모두 “xxx에 대한 요청한 편집을 완료할 수 없습니다”와 유사한 텍스트 오류 메시지를 반환합니다

생성 실패의 증상

로그 출력 Tokens가 1000 미만입니다

Google은 예를 들어: “I’m unable to help with this task”와 같은 텍스트 한 줄을 반환합니다 / I'm just a language model and can't help with that.

로그 출력 Tokens가 비어 있습니다

이미지 생성이 아예 거부되고 오류는 비어 있습니다. API 응답 데이터의 핵심 지표는 "candidatesTokenCount": 0
gemini-3-pro-image-preview 모델의 completion Tokens 열에 173 및 176과 같은 아주 작은 값이 표시되고, 실패한 생성으로 표시된 로그 목록

Log list: when the 'Completion' (output Tokens) column shows tiny values like 100-200, that call is a failed generation

실패했는데도 왜 과금되나요?

  • Google이 쿼터를 차감합니다: prompt를 수정하지 않고 같은 요청을 반복해서 보내면 Google의 RPD 쿼터를 낭비합니다
  • 시스템은 아직 “출력이 비어 있을 때 과금하지 않기”를 지원하지 못합니다
  • 금지된 콘텐츠를 요청하면 공식 KEY가 차단될 가능성이 높아지며, 이는 되돌릴 수 없는 손실입니다

참여하려면?

대상 고객은 다음과 같습니다:
  1. 월 지출이 USD 1000부터 시작하는 경우(온사이트 모델에 한함) — 기준은 의도적으로 낮게 설정되어 있습니다. 소액 크레딧 테스트와 개인 사용에서는 어차피 실패 가능성이 낮기 때문입니다
  2. 도구 서비스 제공자를 대상으로 합니다: 고객 측에서 최종 사용자의 입력 내용을 통제하기 어렵기 때문입니다
  3. 비주관적 사유만 해당합니다: 악의적으로 동일하거나 유사한 금지 콘텐츠를 요청하는 경우에는 보상되지 않습니다
  4. 기간: 5월 1일(UTC+8)부터
  5. 내부 목록에 등록하기 위해 순차적으로 연락드리겠습니다

환급은 어떻게 진행됩니까?

로그 섹션으로 이동한 다음, 오른쪽 상단 모서리에서 내보내기를 클릭하고 기간(예: 지난달)을 선택한 후 비동기 내보내기를 선택합니다. 제출한 뒤에는 상단 탐색 메뉴의 비동기 작업에서 진행 상황을 확인하고 최종 Excel 데이터 결과를 다운로드합니다.
로그 섹션 도구 모음에서 오른쪽 상단의 내보내기 버튼이 강조 표시된 화면

The Export button in the top-right corner of the Logs section

환급된 크레딧: 실패한 요청의 정확한 수를 집계한 다음 failed count × model price / discount factor을 기준으로 환급합니다(예: 15% 충전 보너스가 있는 경우 1.15로 나눕니다). 환급 시점: 매월 말에 전월 데이터를 집계하며, 환급은 일반적으로 다음 달 첫 5영업일 이내에 지급됩니다.