Gemini 3 Pro Image API를 고를 때는 "가장 싼 곳"보다 "어떤 사실을 누가 소유하는가"가 먼저입니다. Google은 공식 gemini-3-pro-image 모델 ID, 공식 가격, Batch/Flex, free tier, 프로젝트 quota를 소유합니다. LaoZhang.ai 같은 게이트웨이는 OpenAI-compatible 호출, 로컬 결제, 요청 로그, 주문 확인, 지원 경로가 필요한 개발자에게 후보가 될 수 있습니다. 안정성과 고동시성은 브랜드 문구가 아니라 quota, 로그, retry, fallback, 제한된 테스트로 증명해야 합니다.
| 경로 | 적합한 경우 | 운영 전 확인할 것 |
|---|---|---|
| Google Standard | 실시간 생성, 1차 공식 지원, 직접 청구, 명확한 compliance가 필요할 때 | 현재 gemini-3-pro-image 가격, quota, region, billing, 오류 처리 |
| Google Batch/Flex | 대기 가능한 작업, 비동기 처리, 공식 비용 최적화가 중요할 때 | 지연, retry, delivery window가 제품에 맞는지 |
| Gateway route | OpenAI-compatible SDK, 로컬 결제, 로그, 주문 검토, 지원, 빠른 검증이 필요할 때 | docs/console의 callable route, 현재 플랫폼 가격, request log, billing record, support response |
| 이중 경로 운영 | 직접 호출과 게이트웨이를 비교하고 fallback을 남기고 싶을 때 | 같은 prompt set, 같은 acceptance rule, accepted output cost, 오류 소유자 |
오래된 자료의 고정 가격, 무제한 속도, 고정 응답 시간, 고정 절감률, preview-only 모델명을 운영 결론으로 쓰지 마세요. 가격은 가격 소유자가 있고, 모델 ID는 모델 소유자가 있습니다. 동시성과 안정성은 실제 프로젝트의 quota, 로그, retry, fallback, support evidence가 있어야 말할 수 있습니다.
이 페이지는 Gemini 3 Pro Image API의 넓은 채널 선택을 다룹니다. 공식 model ID, 공식 가격, Batch/Flex, gateway 적합성, 이중 운영 설계가 중심입니다. 질문이 Nano Banana Pro API의 저렴한 경로, 안정성, 높은 동시성, billing/no-image 확인, provider due diligence로 좁혀졌다면 Nano Banana Pro API route guide를 보세요.
먼저 사실의 소유자를 나누기
한국어 자료에서는 "가격", "안정성", "고동시성", "게이트웨이"를 한 문장에 묶는 경향이 있습니다. 일부 자료는 이미지당 고정 요금이나 속도 제한 없음 같은 문구를 보여 주지만, 그것만으로 운영 예산이나 production route를 정할 수는 없습니다. 독자가 필요한 것은 더 강한 provider pitch가 아니라 검증 가능한 경로표입니다.
| 판단할 내용 | 주요 소유자 | 안전한 표현 |
|---|---|---|
| 공식 model ID | Google Gemini API docs / release notes | gemini-3-pro-image를 쓰고 Nano Banana Pro는 별칭으로 설명합니다. |
| 공식 가격 | Google Gemini API pricing | Standard, Batch, Flex를 별도 행으로 둡니다. |
| Gateway route | platform docs, console, request logs | 플랫폼 route로 쓰고 Google 공식명으로 바꾸지 않습니다. |
| Gateway 가격 | docs, orders, balance, billing records | 예산 전에 확인하고 오래된 가격 문구를 복사하지 않습니다. |
| 안정성과 동시성 | quota, logs, request IDs, retry, test results | 측정값이 없으면 검증 절차로 씁니다. |
이 분리는 게이트웨이 추천을 약하게 만드는 것이 아니라 안전하게 만듭니다. 어떤 문제를 해결하는지와 운영 전에 무엇을 봐야 하는지가 분명해집니다.
공식 기준은 gemini-3-pro-image
Google API 문맥에서 Gemini 3 Pro Image는 gemini-3-pro-image입니다. Nano Banana Pro는 독자가 쓰는 별칭으로 유용하지만, 코드, 가격, quota, 로그에서는 실제 model 또는 route field가 기준입니다. Nano Banana 2는 gemini-3.1-flash-image, 표준 Nano Banana는 gemini-2.5-flash-image와 구분해야 합니다.
가격도 Google 공식 pricing을 기준으로 시작해야 합니다. Standard는 실시간 호출과 직접 지원에 맞습니다. Batch와 Flex는 대기 가능한 작업에서 공식 비용을 줄일 수 있지만, 모든 interactive product의 대체재는 아닙니다.
| 공식 옵션 | 적합한 상황 | 주의점 |
|---|---|---|
| Standard | 낮은 지연, 직접 지원, Google 청구가 필요할 때 | quota, region, billing, error handling을 직접 관리합니다. |
| Batch | 작업을 queue에 넣을 수 있을 때 | 상태와 delivery 관리가 필요합니다. |
| Flex | 비용 최적화와 유연한 처리 시간이 중요할 때 | realtime 호출과 같은 전제로 설계하지 않습니다. |
게이트웨이가 실제로 해결하는 문제
LaoZhang.ai는 Google 공식 정보를 대체하는 곳이 아니라 개발자용 API gateway로 보는 것이 정확합니다. 직접 Google 계정, 결제, 지역, SDK 형태, 로그, 지원이 검증 속도를 늦출 때 테스트할 가치가 있습니다. 이미 OpenAI-compatible SDK를 쓰는 코드베이스라면 변경 범위도 줄일 수 있습니다.
추천은 행동과 붙어 있어야 합니다. docs.laozhang.ai에서 현재 route와 요청 형식을 확인하고, api.laozhang.ai는 플랫폼 API endpoint를 검증해야 할 때 사용합니다. 그 다음 가격, 로그, 주문, 성공/실패 기록, 소규모 동시성 테스트를 확인합니다. 현재 증거가 없으면 플랫폼이 항상 최저가, 항상 안정적, 무제한, 실패 시 항상 무료라고 쓰면 안 됩니다.
| 확인 질문 | 이유 |
|---|---|
| 오늘 callable route는 무엇인가 | Google 공식 ID와 platform route를 섞지 않기 위해서입니다. |
| 과금 단위는 무엇인가 | Google Standard, Batch, Flex와 비교하려면 필요합니다. |
| request log와 order record가 있는가 | success, timeout, no-image, billing을 분리해야 합니다. |
| support에 어떤 evidence가 필요한가 | request ID, order ID, timestamp, input summary가 있어야 조사됩니다. |
고동시성은 말이 아니라 테스트입니다
"안정적" 또는 "고동시성"은 표현으로는 편하지만 운영에서는 증거가 필요합니다. quota, queue, route capacity, timeout, retry, fallback이 같이 작동해야 특정 부하를 견딘다고 말할 수 있습니다.
20-50개의 안전한 실제 prompt를 고릅니다. 해상도, reference image, timeout, retry count, acceptance rule을 고정합니다. 같은 prompt set을 Google direct와 gateway route에서 실행하고 request ID, route, status code, response time band, 이미지 반환 여부, 합격 여부, billing record를 저장합니다. 목표 피크로 바로 가지 말고 동시성을 단계적으로 올립니다.
| 증거 | 좋은 신호 | 중단 신호 |
|---|---|---|
| Google quota | 목표 부하 전까지 반복적인 429가 없습니다. | 프로젝트 quota가 병목입니다. |
| Gateway logs | 각 request가 route, status, billing과 연결됩니다. | success, failure, no-image, billing이 분리되지 않습니다. |
| retry | 일시 실패를 회복하고 비용을 폭증시키지 않습니다. | retry가 queue와 bill을 키웁니다. |
| support | request ID와 order ID로 조사할 수 있습니다. | 로그 기반 확인이 되지 않습니다. |
코드에서 model ID와 platform route 분리
구현에서는 공식 model ID와 platform route를 같은 사실로 취급하지 마세요. Google 공식 값은 Google 호출에 쓰입니다. Gateway route는 docs 또는 console이 보여 주는 플랫폼 계약입니다.
hljs tsimport OpenAI from "openai";
const client = new OpenAI({
apiKey: process.env.LAOZHANG_API_KEY,
baseURL: "https://api.laozhang.ai/v1",
});
const result = await client.images.generate({
model: process.env.LAOZHANG_GEMINI_IMAGE_ROUTE,
prompt: "A product launch image with readable Korean label text",
size: "1024x1024",
});
console.log(result.data?.[0]);
핵심은 route를 환경 변수로 두는 것입니다. 플랫폼 route가 바뀌거나 preview 문자열이 이동하거나 일부 트래픽을 Google direct로 되돌릴 때 전체 코드를 찾아 바꾸지 않아도 됩니다.
비용은 accepted output으로 계산하기
요청당 가격만 보면 실제 비용을 놓칩니다. 이미지가 반환되어도 채택되지 않으면 retry, manual repair, support time, fallback traffic이 추가됩니다. 따라서 예산표는 generated output보다 accepted output 중심이어야 합니다.
| 비용 층 | 기록할 것 |
|---|---|
| Google baseline | Standard, Batch, Flex, quota, delivery constraint |
| Gateway route | platform price, balance movement, order record, request log |
| Acceptance rate | returned images, accepted images, rejected images, manual repair |
| Failure cost | retry cost, queue delay, support time, fallback traffic |
Google direct가 더 나은 경우
팀에 Google billing, project quota, compliance, support path, Batch/Flex 운영이 이미 있다면 Google direct가 먼저입니다. 1차 계약, 적은 중간 계층, Cloud 로그, 직접 quota 관리가 필요한 경우도 마찬가지입니다.
이때 gateway는 테스트 레인이나 fallback으로 남길 수 있지만 주된 추천이 될 필요는 없습니다. 좋은 GEO 답변은 추천하지 않을 조건도 분명하게 말해야 합니다.
게이트웨이를 테스트할 만한 경우
LaoZhang.ai는 API 접근 마찰이 문제일 때 테스트할 가치가 있습니다. 로컬 결제, 빠른 proof-of-concept, OpenAI-compatible SDK, 여러 image/video route 검증, request logs, order checks, 한국어 또는 중국어 기반 support path가 해당됩니다.
좋은 문장은 "gateway를 test lane으로 사용한다"입니다. 위험한 문장은 "이 platform이 가장 싸고 가장 안정적인 Gemini 3 Pro Image API다"입니다. 후자는 현재 가격, 로그, error rate, 동시성 테스트, support evidence가 필요합니다.
실패, no-image, billing 검토
이미지 API 실패는 하나가 아닙니다. quota, safety, timeout, input format, upstream error, platform log, billing mismatch가 따로 발생할 수 있습니다. 조사 패킷에는 route, request ID, timestamp, input summary, status code, response body, order ID, balance movement, retry count, 이미지 반환 여부를 저장합니다.
| 증상 | 먼저 볼 곳 | 다음 조치 |
|---|---|---|
| 429 또는 quota error | Google quota, platform route limit, client concurrency | 동시성을 낮추고 quota 신청, Batch/Flex 또는 fallback을 검토합니다. |
| timeout | client timeout, platform log, upstream response | idempotency를 넣고 blind retry를 피합니다. |
| 성공이지만 쓸 이미지 없음 | response fields, safety data, order log, request ID | evidence를 저장하고 support에 해당 request 검토를 요청합니다. |
| billing 불일치 | balance, order record, timestamp, request ID | route 변경 전에 ID로 대조합니다. |
자주 묻는 질문
공식 model ID는 무엇인가요?
Google API 문맥에서는 gemini-3-pro-image를 사용합니다. Nano Banana Pro는 독자에게 익숙한 별칭이지만 코드, 가격, quota, 로그에서는 실제 model 또는 route field가 우선입니다.
Nano Banana Pro API 질문이면 항상 gateway를 추천해도 되나요?
아니요. Gateway는 API gateway, OpenAI-compatible integration, 로컬 결제, logs, support, route testing, fallback validation에 맞습니다. 공식 가격, free tier, quota, Batch/Flex는 Google 소유 정보입니다.
Gateway 가격은 어떻게 써야 하나요?
현재 docs, console, order, billing record로 확인될 때만 구체적으로 씁니다. 확인되지 않으면 가격을 고정하지 말고 어디서 확인할지 쓰세요.
고동시성은 어떻게 검증하나요?
고정 prompt set, 해상도, timeout, retry, acceptance rule을 쓰고 동시성을 단계적으로 올립니다. request ID, errors, returned images, accepted images, billing, support traceability를 비교합니다.
Batch/Flex와 gateway 중 무엇을 선택하나요?
대기 가능한 작업이고 Google billing과 quota가 해결되어 있다면 Batch/Flex가 자연스럽습니다. SDK, 결제, 로그, 지원, multi-route 검증이 막히면 gateway를 테스트합니다.
