> ## 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 문서: API 키 발급부터 첫 요청까지

> LaoZhang API의 base URL을 확인하고 3단계로 첫 요청을 보내 보세요. 텍스트·이미지·비디오 API 가이드, 모델 가격, 과금 방식도 여기서 찾을 수 있습니다.

LaoZhang API는 싱가포르 YingTu Technology Pte. Ltd.가 2025년부터 운영하는 AI API 게이트웨이입니다. API 키(콘솔에서는 '토큰'이라고 부릅니다) 하나와 base URL 하나로 Google Nano Banana, OpenAI GPT Image, xAI Grok Imagine 같은 이미지 모델과 여러 제공사의 텍스트·비디오 모델을 호출할 수 있습니다.

> [!NOTE]
>
> **가입과 서비스 이용은 허용 목록(allowlist) 심사를 거칩니다.**
>
> * [가입](https://api.laozhang.ai/register)은 Gmail 주소로만 할 수 있습니다.
> * 기업 사용자는 [hi@laozhang.ai](mailto:hi@laozhang.ai)로 메일을 보내거나 Telegram [@laozhang\_cn](https://t.me/laozhang_cn)으로 문의하면 허용 목록 등록을 신청할 수 있습니다.

| 항목 | 내용 |
| - | - |
| API 호스트 | `https://api.laozhang.ai` |
| OpenAI SDK base URL | `https://api.laozhang.ai/v1` |
| Google Gen AI SDK, Anthropic SDK | 호스트 루트 `https://api.laozhang.ai` |
| 주요 이미지 모델 | Nano Banana 2.1 호출당 \$0.045, GPT Image 2.5 VIP 호출당 \$0.03, Grok Imagine 2.0 이미지당 \$0.055 (2026년 10월 공개 가격). [이미지 생성 API 비교](https://docs.laozhang.ai/ko/api-capabilities/image-generation-guide.md) 참고 |
| 주요 비디오 모델 | MiniMax H3 768P 초당 \$0.05(MiniMax 공식 가격보다 37.5% 낮음), Muse 영상당 \$0.30 (5\~10초, 10초 기준 초당 \$0.03). 둘 다 오디오가 포함되며 `default` 그룹 토큰으로 호출할 수 있습니다. [비디오 API 비교](https://docs.laozhang.ai/ko/api-capabilities/video-generation-guide.md) 참고 |
| 동시 요청과 속도 제한 | 플랫폼 차원의 동시 요청 제한과 스로틀링이 없습니다. [동시 요청과 429](https://docs.laozhang.ai/ko/faq/api-concurrency.md) 참고 |

## 첫 요청 보내기

먼저 계정이 필요합니다. 위의 가입 안내를 확인하세요.

**1. API 키 발급**

로그인한 뒤 [토큰 관리](https://api.laozhang.ai/token)에서 토큰을 만듭니다. 이 예제에서는 `default` 그룹을 선택하세요. 그룹과 과금 방식은 [과금 가이드](https://docs.laozhang.ai/ko/pricing.md)에서 설명합니다. 만든 키는 터미널 환경 변수로 설정합니다.

```bash theme={null}
export LAOZHANG_API_KEY="YOUR_LAOZHANG_API_KEY"
```

**2. 모델 선택**

[모델 및 가격](https://docs.laozhang.ai/ko/models.md)에서 정확한 모델 ID를 복사합니다. 이 페이지에는 모델별 가격, 토큰 그룹, 엔드포인트도 함께 나옵니다. 이 예제는 `default` 그룹의 사용량 과금 텍스트 모델인 `gpt-5.4-mini`를 사용합니다.

**3. 요청 보내기**

```bash theme={null}
curl https://api.laozhang.ai/v1/chat/completions \
  -H "Authorization: Bearer $LAOZHANG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.4-mini",
    "messages": [{"role": "user", "content": "connected라고만 답하세요"}]
  }'
```

응답은 `choices[0].message.content`에 들어 있고, 이 프롬프트라면 `connected`가 나옵니다. SDK 설정, 이미지 요청, Gemini·Anthropic 네이티브 API, 오류 해결은 [API 연동 가이드](https://docs.laozhang.ai/ko/api-manual.md)에서 이어서 볼 수 있습니다.

## 문서 둘러보기

> [card] [Nano Banana API](https://docs.laozhang.ai/ko/api-capabilities/nano-banana-image.md)
>
> Google의 Gemini 이미지 모델(나노 바나나) 5종입니다. 호출당 고정 가격이며 Gemini 네이티브 또는 OpenAI 호환 요청을 쓸 수 있습니다.

> [card] [GPT Image 2.5 API](https://docs.laozhang.ai/ko/api-capabilities/gpt-image-2-5.md)
>
> OpenAI 이미지 모델입니다. 공식 포워딩 또는 호출당 과금 경로로 이미지 생성, 편집, 투명 배경을 쓸 수 있습니다.

> [card] [Grok Imagine API](https://docs.laozhang.ai/ko/api-capabilities/grok-imagine-image.md)
>
> xAI 이미지 모델입니다. 이미지당 \$0.055, 1K 또는 2K 출력, 참조 이미지 최대 3장으로 편집합니다.

> [card] [이미지 API 비교](https://docs.laozhang.ai/ko/api-capabilities/image-generation-guide.md)
>
> 이미지 모델, 엔드포인트, 과금 방식을 비교한 뒤 모델별 가이드로 이동합니다.

> [card] [MiniMax H3 비디오](https://docs.laozhang.ai/ko/api-capabilities/minimax-h3-video-generation.md)
>
> 768P 초당 \$0.05로 공식 가격보다 37.5% 낮으며, 2K 출력, 참조 미디어, 내장 오디오를 지원합니다.

> [card] [Muse 비디오](https://docs.laozhang.ai/ko/api-capabilities/muse-video-generation.md)
>
> Meta의 비디오 모델입니다. 10초 영상은 \$0.30(초당 \$0.03)이며 OpenAI 방식 `/v1/videos`로 한 번에 최대 60초까지 이어서 생성합니다.

> [card] [비디오 API 비교](https://docs.laozhang.ai/ko/api-capabilities/video-generation-guide.md)
>
> H3, Muse, Seedance, Wan의 영상당 비용과 엔드포인트, 토큰 그룹을 비교합니다.

> [card] [OpenAI 프로토콜](https://docs.laozhang.ai/ko/api-reference/chat-completions.md)
>
> OpenAI SDK와 호환 클라이언트로 Chat Completions 요청을 보냅니다.

> [card] [Gemini 프로토콜](https://docs.laozhang.ai/ko/api-reference/gemini.md)
>
> cURL 또는 Google Gen AI SDK로 `generateContent`를 호출합니다.

> [card] [모델 및 가격](https://docs.laozhang.ai/ko/models.md)
>
> 모델 ID, 가격, 토큰 그룹, 엔드포인트를 검색합니다.

> [card] [공지사항](https://docs.laozhang.ai/en/changelog.md)
>
> 모델 출시, 가격 변경, 서비스 상태 소식을 확인합니다.

> [card] [연동 가이드](https://docs.laozhang.ai/en/scenarios.md)
>
> Codex CLI, Gemini CLI, Cline, Cherry Studio 등에서 LaoZhang API를 쓰는 방법입니다.

## AI 도구에서 이 문서 활용하기

코딩 어시스턴트는 이 문서를 직접 읽을 수 있습니다.

* [skill.md](https://docs.laozhang.ai/skill.md): 에이전트용 스킬 파일입니다. SDK별 base URL, 환경 변수에서 API 키를 읽는 방법, 최소 텍스트·이미지 요청, 오류 진단, 다음에 열어야 할 레퍼런스를 코딩 어시스턴트에 알려 줍니다.
* [llms-full.txt](https://docs.laozhang.ai/llms-full.txt): 문서 전체를 하나의 텍스트 파일로 묶은 것으로, 문서를 컨텍스트에 불러오는 도구에 적합합니다. 현재는 중국어 문서가 담겨 있습니다.

어시스턴트가 코드를 대신 실행한다면 API 키는 환경 변수로 전달하고, 프롬프트에 직접 붙여 넣지 마세요.

## LaoZhang API 소개

LaoZhang API([www.laozhang.ai](https://www.laozhang.ai))는 싱가포르 회사 YingTu Technology Pte. Ltd.가 운영하며, 서드파티 모델에 대한 기술적인 API 접속과 라우팅을 제공합니다. 해당 모델의 공식 운영사가 아니고 OpenAI, Google, xAI와 제휴 관계도 없으며, 일반 사용자를 대상으로 콘텐츠 생성 서비스를 제공하지 않습니다.

| 항목 | 내용 |
| - | - |
| 운영 주체 | YingTu Technology Pte. Ltd.(싱가포르), 2025년부터 운영 |
| 결제 | 선불 잔액. 카드 결제는 Stripe, 기업은 계좌 이체 |
| 서비스 상태 | [상태 페이지](https://api.laozhang.ai/uptimeStatus). 변경 사항은 [공지사항](https://docs.laozhang.ai/en/changelog.md)에 게시 |
| 데이터 처리 | [데이터 정책](https://www.laozhang.ai/data-policy): 프롬프트와 응답은 기본적으로 저장하지 않음 |
| 서비스, 과금, 환불 | [이용약관](https://www.laozhang.ai/terms) |

운영 주체, 모델 출처, 이용 가능한 경로, 결제, 환불은 [LaoZhang API 소개](https://docs.laozhang.ai/en/about.md)에서 한곳에 정리해 두었습니다. 모델 출력을 검토하고 활용하는 책임은 사용자에게 있습니다.

문의는 [hi@laozhang.ai](mailto:hi@laozhang.ai) 또는 Telegram [@laozhang\_cn](https://t.me/laozhang_cn)으로 보내 주세요. 서비스 소식은 Telegram 채널 [@laozhang\_ai](https://t.me/laozhang_ai)에도 올라오며, 긴 글은 [LaoZhang AI Blog](https://blog.laozhang.ai)에서 볼 수 있습니다.

## 자주 묻는 질문

### 모델 제공사마다 계정이 필요한가요?

아니요. LaoZhang API 계정과 API 키 하나로, 키의 그룹이 호출할 수 있는 모든 모델에 접근합니다. 모델별 그룹은 [모델 및 가격](https://docs.laozhang.ai/ko/models.md)에서 확인하고, 내 계정에 적용되는 모델과 가격은 콘솔에서 볼 수 있습니다.

### 사용 요금은 어떻게 청구되나요?

요청은 선불 잔액에서 차감됩니다. 모델에 따라 사용량(토큰) 기준 또는 호출당으로 과금되며, 일부 토큰 그룹에는 가격 배율이 적용됩니다. 과금 방식, 충전, 인보이스는 [과금, 토큰 그룹, 인보이스](https://docs.laozhang.ai/ko/pricing.md)에서 설명하고, 요청별 비용은 [호출 로그](https://api.laozhang.ai/log)에서 확인합니다.

### 어느 API 도메인을 써야 하나요?

기본값은 `https://api.laozhang.ai`입니다. 세 호스트는 같은 API 키와 경로를 받으므로 바꿔도 호스트 이름만 달라집니다. 자세한 내용은 [API 연동 가이드](https://docs.laozhang.ai/ko/api-manual.md)를 참고하세요.

* 기본: `https://api.laozhang.ai`. OpenAI SDK base URL은 `https://api.laozhang.ai/v1`
* 유럽·북미 서버에서 직접 연결하려는 경우: `api-vip.laozhang.ai`
* 네트워크에서 `api.laozhang.ai`에 접속할 수 없는 경우: `api2.laozhang.ai`

### 코드로 잔액을 조회하려면 어떻게 하나요?

시스템 AccessToken으로 `GET https://api.laozhang.ai/api/user/self`를 호출합니다. AccessToken은 API 키와 별개의 인증 정보입니다. 발급 방법과 quota를 미국 달러로 환산하는 방법은 [잔액 조회 API](https://docs.laozhang.ai/ko/api-capabilities/balance-query.md)에 있습니다.


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