API 가이드

5분 빠른 시작

1. 가입 및 지갑 충전

가입·로그인 후 지갑에서 금액과 사용 가능한 결제 수단을 선택하세요. 모델 호출은 지갑에서 정산되며 결제 확인 후 충전됩니다.

2. API 키 생성 및 저장

콘솔에서 키를 만들고 월 지출 한도를 설정할 수 있습니다. 전체 키는 한 번만 표시되니 안전하게 저장하세요. 앱마다 별도 키를 쓰고 브라우저 코드나 공개 저장소에 노출하지 마세요.

3. 모델 및 프로토콜 선택

실시간 목록의 공개 별칭을 사용하세요. OpenAI 호환은 /v1, Anthropic 호환은 /anthropic을 사용합니다. 공급자 내부 ID를 플랫폼 별칭 대신 쓰지 마세요.

4. 요청 전송

SDK는 Base URL에 경로를 추가하며 curl에는 전체 URL이 필요합니다. 키를 서버 환경 변수에 저장하고 프로토콜별 인증 헤더를 보내세요. 스트리밍은 stream: true입니다.

5. 사용량 및 비용 확인

사용량 페이지에서 모델·키별 비용, 최근 요청, 상태, 지연을 확인하고 CSV를 내보내세요. 지갑은 위안화로 정산되며 단가는 목록에 표시된 단위를 따릅니다.

API 키 모델 목록

코드의 필드명, 모델 별칭, API 경로는 개발에 사용하도록 원문을 유지합니다.

전체 기술 참조 (영어)

Getting started

5-minute quickstart

Five steps from a fresh account to a working LLM call. If you already have a key, jump straight to Use your API key.

Step 1 — Create an account

Go to Sign up.
Enter your email + a password. We send an activation link — click it to switch the account from PENDING_VERIFICATION to ACTIVE.
You land on the developer console.

Already activated? Sign in at /sign-in.

Step 2 — Add funds

Every relay call settles against your wallet, so it starts at zero balance and you need to top up before it works.

Open Billing.
Pick an amount and a payment method (Alipay if configured, or the mock provider in dev environments).
The wallet credit lands when the payment callback fires (seconds for Alipay, instant for mock).

Charges are denominated in CN¥ minor (分). Each model alias has a published per-1k-token price — see Models.

Step 3 — Create an API key

Open API keys.
Pick a name (e.g. local-dev) and an optional monthly spend cap.
Click Create API key. The reveal banner shows the token starting with tsk_. Copy it now — the platform never displays the full token again.

Step 4 — Send a request

Two URL forms come up depending on the client you use:

Base URL (the value you pass to an SDK's baseURL / base_url field): https://chinzy.com/v1
Full endpoint URL (the URL you put in raw HTTP / curl): https://chinzy.com/v1/chat/completions

SDKs (OpenAI, Anthropic, etc.) only need the base URL — they append /chat/completions themselves. Curl needs the full path because it has no concept of a base URL. Quick smoke test with curl:

curl https://chinzy.com/v1/chat/completions \
  -H "Authorization: Bearer tsk_..." \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.2",
    "messages": [{"role": "user", "content": "Say hi in one sentence"}]
  }'

Expected response shape: a JSON body with choices[0].message.content populated and a usage block. Status 200.

Got a different status code? Skip to the error table.

Step 5 — Watch your spend

Open Usage. Within seconds your first call shows up:

Cycle spend — total charged this calendar month.
By model / By API key — breakdowns sorted by spend.
Recent calls — last 50 requests with status, latency, and cost. The status code links to the request log row in the operator console for debugging if needed.
Download CSV — pull 7 / 30 / 90 days of activity into a spreadsheet for accounting.

You're live

From here, common next steps:

Switch your existing OpenAI / Anthropic SDK code to point at our base URL — see SDK examples.
Browse the full Models catalog for aliases and pricing.
Set monthly caps on each key so a runaway client can't drain the wallet.