接口指南

五分钟快速上手

1. 创建账号与充值

注册或登录 CHINZY，然后在钱包中选择充值金额与可用支付方式。模型调用从钱包结算；充值到账以支付回调确认为准。

2. 创建并保存 API 密钥

在控制台创建 API Key，可设置每月消费上限。完整密钥只显示一次，请立即安全保存；每个应用使用独立密钥，避免在浏览器代码或公开仓库中暴露。

3. 选择模型与协议

使用实时模型目录中的公开别名。OpenAI 兼容客户端使用 /v1；Anthropic 兼容客户端使用 /anthropic。不要把供应商内部模型 ID 当作平台别名。

4. 发起请求

SDK 接收 Base URL 并自动拼接接口路径；curl 需要完整接口 URL。将密钥放在服务端环境变量中，按所用协议发送认证头；流式响应使用 stream: true。

5. 查看用量与费用

在用量页按模型或 API Key 查看费用、最近请求、状态与延迟，并导出 CSV。钱包以人民币结算；模型目录展示的单价单位以页面标注为准。

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.