> ## 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. # LaoZhang API 과금과 가격: 토큰 그룹, 인보이스 > 사용량 과금과 건당 과금 모델의 요금 계산 방식, 토큰 과금 방식과 그룹 배율, 충전과 인보이스 요청 방법을 안내합니다. LaoZhang API는 요청 비용을 선불 잔액에서 차감합니다. 모델마다 사용량(토큰) 또는 호출 건당으로 과금하며, 사용하는 API 키의 그룹에 따라 가격 배율이 적용될 수 있습니다. | 항목 | 내용 | | - | - | | 결제 | 선불 잔액 | | 과금 방식 | 모델에 따라 사용량(토큰) 또는 건당 | | 그룹 배율 | 일부 토큰 그룹은 표시 가격에 배율을 곱함 | | 현재 가격 | [모델 및 가격](https://docs.laozhang.ai/ko/models.md), 내 계정 기준은 [콘솔 가격 페이지](https://api.laozhang.ai/account/pricing) | | 요청별 실제 청구액 | [호출 로그](https://api.laozhang.ai/log) | | 실패한 요청 | 업스트림이 200이 아닌 응답을 반환하면 과금하지 않음. Nano Banana는 이미지가 없는 HTTP 200도 과금하므로 [과금과 실패 처리](https://docs.laozhang.ai/ko/api-capabilities/image-billing-and-failures.md) 참고 | | 동시 요청과 속도 제한 | 플랫폼 차원의 동시 요청 제한과 스로틀링 없음. [동시 요청과 429](https://docs.laozhang.ai/ko/faq/api-concurrency.md) 참고 | ## 사용량 과금과 건당 과금 | 과금 방식 | 요청 비용이 정해지는 방법 | | - | - | | 사용량 과금 | 사용한 토큰 수에 모델의 1M 토큰당 가격을 곱합니다. 입력, 캐시 입력, 출력 토큰은 가격이 다를 수 있습니다. | | 건당 과금 | 호출 한 건당 고정 가격입니다. 한 건은 요청, 출력 이미지 한 장, 작업 하나 중 하나이며 모델 가이드에 명시되어 있습니다. | 텍스트, 임베딩, 모더레이션, 오디오 모델은 사용량 과금입니다. Nano Banana, FLUX.2, Seedream, GPT Image 2.5 VIP 모델을 포함한 대부분의 이미지 모델은 건당 과금입니다. 비디오 모델은 [Wan 2.7](https://docs.laozhang.ai/ko/api-capabilities/wan-video-generation.md)과 [Seedance 2.0 / 2.5](https://docs.laozhang.ai/ko/api-capabilities/seedance2-video-generation.md) 가이드의 과금 규칙을 따릅니다. 일부 모델은 그룹에 따라 두 방식으로 모두 가격이 매겨집니다. * `gpt-image-2`는 `default` 그룹에서 건당 과금이고, 공식 API 포워딩 그룹인 `OpenAI Official`(이전 이름 Sora2Official)과 `OpenAI Official Enterprise`(이전 이름 GPTImage2 Sora2 Enterprise)에서는 토큰 과금입니다. * 공식 포워딩 GPT Image 2.5 모델인 `gpt-image-2.5-flare`와 `gpt-image-2.5-sunburst`도 같은 단가로 토큰 과금합니다. GPT Image 2.5의 건당 과금 웹 버전 경로는 모델 ID `gpt-image-2.5-web`을 씁니다. 이전 `gpt-image-2-web`은 기존 연동을 위해 남겨 둔 레거시 ID이며 생성과 편집을 모두 지원합니다. 두 경로는 별개이므로 `gpt-image-2.5-web`에 `gpt-image-2-web`의 파라미터를 그대로 쓰지 마세요. 토큰 수는 모델의 토크나이저, 보낸 대화 기록과 파일, 도구 호출, 출력 길이에 따라 달라집니다. 단어 수로 추정하기보다 호출 로그에서 요청별 입력 토큰, 출력 토큰, 청구액을 확인하세요. 일부 모델은 한 요청의 토큰 수에 따라 [구간별 가격](https://docs.laozhang.ai/ko/models.md)이 달라집니다. ## 토큰 과금 방식 콘솔에서 '토큰'이라고 부르는 API 키마다 과금 방식이 있으며, 이 설정이 호출할 수 있는 모델과 적용되는 가격을 정합니다. [토큰 관리](https://api.laozhang.ai/token)에서 토큰을 만들거나 수정할 때 설정하며, 대부분은 사용량 우선이 맞습니다. | 방식(콘솔 중국어 표시) | 호출할 수 있는 모델 | 비고 | | - | - | - | | 사용량 우선(按量优先), 권장 | 사용량 과금 모델과 건당 과금 모델 | 두 방식 가격이 모두 있는 모델은 사용량 과금 가격을 적용합니다. | | 사용량 과금(按量计费) | 사용량 과금 모델만 | 텍스트 모델, Wan, Seedance, 공식 포워딩 GPT Image 등 | | 건당 과금(按次计费) | 건당 과금 모델만 | Nano Banana, FLUX.2, Seedream 등 | 토큰에는 알맞은 과금 방식과 알맞은 그룹이 모두 필요합니다. 아래 모델은 각자의 그룹에서만 동작하며, 해당 그룹의 토큰은 사용량 우선 또는 사용량 과금이어야 합니다. * Wan: `Wan` 그룹에서만 * Seedance: `SeeDance2` 그룹에서만 * 공식 포워딩 GPT Image: 공식 포워딩 그룹에서만 콘솔의 다른 옵션을 쓸 일은 거의 없습니다. `default` 그룹의 건당 과금 `gpt-image-2`에 건당 과금 토큰이 필요한 것처럼 모델마다 고유한 요구 사항이 있을 수 있으니, 그런 경우에는 모델 가이드를 따르세요. 요청에 어떤 과금 방식이 적용됐는지는 호출 로그에서 확인할 수 있습니다. ## 토큰 그룹과 배율 토큰의 그룹은 사용할 수 있는 경로와 모델을 정합니다. 일부 그룹은 모델 표시 가격에 배율을 적용하며, 해당 그룹의 요청은 표시 가격에 이 값을 곱한 금액으로 과금됩니다. 예를 들어 `OpenAI Official Enterprise`의 배율은 1.2×입니다. 토큰 설정의 그룹 목록에서 그룹별 배율을 볼 수 있습니다. | 그룹 | 용도 | | - | - | | `default` | 범용 그룹입니다. Claude 모델을 포함한 대부분의 모델을 쓸 수 있으며 Claude Code에도 이 그룹을 사용하세요. | | `OpenAI Official` | GPT Image 모델의 공식 포워딩 경로입니다. OpenAI 공식 가격으로 과금하며 OpenAI 키와 Azure OpenAI를 함께 사용해 처리합니다. | | `OpenAI Official Enterprise` | 같은 GPT Image 모델의 엔터프라이즈 공식 포워딩 경로입니다. 공식 가격에 20%를 더한 가격(배율 1.2×)이며 OpenAI 키로만 처리합니다. | | `Wan` | Wan 비디오 모델 | | `SeeDance2` | Seedance 2.0, 2.5 비디오 모델 | | `Claude Code`(이전 이름 claude\_code) | Claude Code용으로 먼저 만든 그룹이며, 이미 쓰는 토큰을 위해 남겨 두었습니다. 새 토큰은 `default`에서 만드세요. | `gpt-image-2-vip`, `gpt-image-2.5-web` 같은 건당 과금 GPT Image 모델은 다른 이미지 그룹에서도 제공됩니다(그룹 이름은 콘솔에서 확인). [모델 및 가격](https://docs.laozhang.ai/ko/models.md)에는 모델별 그룹과 가격이 나와 있으며 배율이 있으면 그룹 이름 뒤에 표시됩니다. 내 계정에 적용되는 가격은 콘솔에서 확인하세요. ## 가격과 청구액 확인 * [모델 및 가격](https://docs.laozhang.ai/ko/models.md): 모델별 표시 가격, 과금 방식, 토큰 그룹, 엔드포인트와 데이터 갱신 시각 * [콘솔 가격 페이지](https://api.laozhang.ai/account/pricing): 로그인한 계정에 적용되는 가격과 그룹 * [호출 로그](https://api.laozhang.ai/log): 요청별 모델, 토큰 사용량, 청구액 * [잔액 조회 API](https://docs.laozhang.ai/ko/api-capabilities/balance-query.md): 알림과 대시보드에 쓸 남은 quota와 사용한 quota 예산을 가늠하려면 대표 요청을 몇 건 보내 호출 로그에서 사용량과 청구액을 확인한 뒤 예상 호출량에 곱해 보세요. 업스트림 제공사의 공개 가격으로는 LaoZhang API 청구액을 예측할 수 없습니다. [Wan 2.7](https://docs.laozhang.ai/ko/api-capabilities/wan-video-generation.md)과 [Seedance](https://docs.laozhang.ai/ko/api-capabilities/seedance2-video-generation.md) 가이드처럼 모델 가이드가 환산 방법을 알려 주는 경우만 예외입니다. 서비스별로 지출 한도를 두려면 서비스마다 quota 한도를 가진 별도 토큰을 발급하세요. ## 충전과 결제 [콘솔](https://api.laozhang.ai)의 충전 페이지에서 잔액을 충전합니다. 충전 페이지는 Stripe 카드 결제를 지원하고, 기업은 고객 지원을 통해 계좌 이체로 결제할 수 있습니다. LaoZhang API는 카드 번호 전체를 저장하지 않습니다. 구매와 환불은 [이용약관](https://www.laozhang.ai/terms)을 따르며 [결제와 환불 FAQ](https://docs.laozhang.ai/en/faq/payment-methods.md)에 요약되어 있습니다. ## 기업 구매와 인보이스 기업 결제, 계약, 인보이스, 대량 구매 가격은 이메일 [hi@laozhang.ai](mailto:hi@laozhang.ai) 또는 Telegram [@laozhang\_cn](https://t.me/laozhang_cn)으로 고객 지원에 문의하세요. 다음 내용을 함께 보내 주세요. * 회사 이름과 계정 이메일 * 사용할 모델과 월 예상 사용량 * 계약과 인보이스 요구 사항 고객 지원이 계정에 맞는 조건과 인보이스 정보를 확인해 드립니다. LaoZhang API는 싱가포르 회사 YingTu Technology Pte. Ltd.가 운영합니다. ## 자주 묻는 질문 ### 요청이 실패해도 과금되나요? 업스트림이 200이 아닌 응답을 반환하면 과금하지 않습니다. 잘못된 파라미터, 인증 실패, `429` 속도 제한, 업스트림 5xx 오류가 여기에 해당합니다. HTTP 200이 반환된 뒤에는 사용량 과금 모델은 실제 토큰을, 건당 과금 모델은 호출 건당 또는 반환된 이미지당 요금을 부과합니다. Nano Banana는 이미지가 반환되지 않은 HTTP 200도 과금합니다. 클라이언트 타임아웃은 실패가 아니므로 다시 보내기 전에 [호출 로그](https://api.laozhang.ai/log)를 확인하세요. 이미지 모델 규칙은 [과금과 실패 처리](https://docs.laozhang.ai/ko/api-capabilities/image-billing-and-failures.md)에 있습니다. ### 청구액이 예상보다 높은 이유는 무엇인가요? 호출 로그에서 해당 요청을 열어 보세요. 흔한 원인은 다음과 같습니다. * 그룹 배율 * 예상보다 많은 입력 토큰(긴 대화 기록, 첨부한 이미지 등) * 큰 요청에 적용되는 구간별 가격 * 내 그룹에서 건당이 아니라 토큰으로 과금되는 모델 로그 항목의 과금 상세에 있는 배율을 가격으로 환산하는 방법은 [호출 로그 확인과 활용](https://docs.laozhang.ai/en/faq/call-logs.md)을 참고하세요. ### 타임아웃이 난 요청도 비용이 드나요? 클라이언트 타임아웃이 나도 서버의 요청은 취소되지 않으며, 과금 여부도 알 수 없습니다. 특히 이미지와 비디오 요청은 다시 보내기 전에 호출 로그를 확인하세요. ### 대량 구매 할인을 받을 수 있나요? 문서에는 고정 할인 구간을 공개하지 않습니다. 기업이나 대량 구매 조건은 고객 지원에 문의하세요. ## 관련 문서 * [지원하는 결제 수단](https://docs.laozhang.ai/en/faq/payment-methods.md) * [잔액이 남았는데 실패하는 이유](https://docs.laozhang.ai/ko/faq/balance-insufficient.md) * [호출 로그 확인과 활용](https://docs.laozhang.ai/en/faq/call-logs.md) * [API 연동 가이드](https://docs.laozhang.ai/ko/api-manual.md) This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.