三步开始

Three steps

注册、充值、建令牌，然后就可以调用了。

Register, add credit, create a key. Then start calling.

一把 key 只属于一个分组。想同时用国产模型和 Codex，就建两把 key。

A key belongs to exactly one group. To use both the Chinese models and Codex, create two keys.

接入地址

Endpoints

同一把 key、同一个域名，三种协议都可以用，都支持流式输出。

Same key, same host, three protocols. Streaming works on all of them.

Base URL 到底填哪个

Which base URL to enter

• OpenAI 系工具和 SDK（base_url / OPENAI_BASE_URL）：填 https://ainzy.net/v1
• Claude Code 和 Anthropic SDK（ANTHROPIC_BASE_URL）：填 https://ainzy.net，不带 /v1
• 鉴权统一用请求头 Authorization: Bearer sk-你的key；Anthropic 协议也接受 x-api-key

• OpenAI-style tools and SDKs (base_url / OPENAI_BASE_URL): https://ainzy.net/v1
• Claude Code and Anthropic SDKs (ANTHROPIC_BASE_URL): https://ainzy.net, without /v1
• Authenticate with the header Authorization: Bearer sk-YOUR_KEY; the Anthropic protocol also accepts x-api-key

不确定模型名时，先请求一次 /v1/models，列表里有的就能用。模型名区分大小写。

Not sure about a model name? Call /v1/models first. Anything in the list works. Model names are case-sensitive.

分组与模型

Groups & models

创建令牌时选择分组。价格以价格页为准，页面会按你的分组实时显示每百万 token 的单价。

Pick a group when creating a key. Prices live on the pricing page, which shows the per-million-token rate for your group.

工具接入

Tools

常用编程工具的配置方法。图形化切换请用 CC Switch，它会替你管理这些配置文件，并且能一键拉取你这把 key 能用的模型。

Configs for common coding tools. For a graphical switcher use CC Switch. It manages these config files for you and can fetch the models your key can use.

Claude Code

令牌选「国模官方 1.5 折高缓存组」，把下面这段加进 ~/.claude/settings.json（Windows 在 %USERPROFILE%\.claude\settings.json）：

Create a key in the chinese-model-15 group and add this to ~/.claude/settings.json (on Windows: %USERPROFILE%\.claude\settings.json):

复制{
  "env": {
    "ANTHROPIC_BASE_URL": "https://ainzy.net",
    "ANTHROPIC_AUTH_TOKEN": "sk-你的key",
    "ANTHROPIC_MODEL": "glm-5.3",
    "ANTHROPIC_SMALL_FAST_MODEL": "glm-5.3-flash"
  }
}

Copy{
  "env": {
    "ANTHROPIC_BASE_URL": "https://ainzy.net",
    "ANTHROPIC_AUTH_TOKEN": "sk-YOUR_KEY",
    "ANTHROPIC_MODEL": "glm-5.3",
    "ANTHROPIC_SMALL_FAST_MODEL": "glm-5.3-flash"
  }
}

也可以直接设环境变量后运行 claude。模型名可换成同分组里的 kimi-k3、deepseek-v4-pro 等。

Setting the same environment variables before running claude also works. Swap the model for any other in the group, such as kimi-k3 or deepseek-v4-pro.

Codex CLI

令牌选「Codex」分组，编辑 ~/.codex/config.toml：

Create a key in the Codex group and edit ~/.codex/config.toml:

复制model = "gpt-5.5"
model_provider = "ainzy"

[model_providers.ainzy]
name = "Ainzy"
base_url = "https://ainzy.net/v1"
env_key = "AINZY_API_KEY"
wire_api = "responses"

Copymodel = "gpt-5.5"
model_provider = "ainzy"

[model_providers.ainzy]
name = "Ainzy"
base_url = "https://ainzy.net/v1"
env_key = "AINZY_API_KEY"
wire_api = "responses"

然后设环境变量 AINZY_API_KEY=sk-你的key 再运行 codex。

Then set AINZY_API_KEY=sk-YOUR_KEY in your environment and run codex.

Cursor / Cline / Roo Code / 其他 OpenAI 兼容工具

Cursor / Cline / Roo Code / other OpenAI-compatible tools

• 提供商选 OpenAI 或 OpenAI Compatible
• Base URL 填 https://ainzy.net/v1，API Key 填你的 sk- key
• 模型名手动填写分组里的模型，例如 deepseek-v4-flash、gpt-5.5、grok-4.6

• Choose OpenAI or OpenAI Compatible as the provider
• Base URL https://ainzy.net/v1, API key your sk- key
• Type the model name from your group, e.g. deepseek-v4-flash, gpt-5.5, grok-4.6

Cursor 覆盖 OpenAI Base URL 后请点「Verify」，通过即表示 key 和地址都对。

In Cursor, click "Verify" after overriding the OpenAI base URL. A pass means both the key and the URL are correct.

代码示例

Code samples

把 sk-你的key 换成你的令牌、模型名换成分组里的模型，直接运行。

Replace sk-YOUR_KEY with your key and the model with one from your group, then run.

复制curl https://ainzy.net/v1/chat/completions \
  -H "Authorization: Bearer sk-你的key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-v4-flash",
    "messages": [{"role": "user", "content": "你好，介绍一下你自己"}],
    "stream": true
  }'

Copycurl https://ainzy.net/v1/chat/completions \
  -H "Authorization: Bearer sk-YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-v4-flash",
    "messages": [{"role": "user", "content": "Hi, introduce yourself"}],
    "stream": true
  }'

复制from openai import OpenAI

client = OpenAI(base_url="https://ainzy.net/v1", api_key="sk-你的key")

stream = client.chat.completions.create(
    model="glm-5.3",
    messages=[{"role": "user", "content": "你好，介绍一下你自己"}],
    stream=True,
)
for chunk in stream:
    print(chunk.choices[0].delta.content or "", end="", flush=True)

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://ainzy.net/v1", api_key="sk-YOUR_KEY")

stream = client.chat.completions.create(
    model="glm-5.3",
    messages=[{"role": "user", "content": "Hi, introduce yourself"}],
    stream=True,
)
for chunk in stream:
    print(chunk.choices[0].delta.content or "", end="", flush=True)

复制import OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://ainzy.net/v1", apiKey: "sk-你的key" });

const stream = await client.chat.completions.create({
  model: "kimi-k3",
  messages: [{ role: "user", content: "你好，介绍一下你自己" }],
  stream: true,
});
for await (const chunk of stream) {
  process.stdout.write(chunk.choices[0]?.delta?.content ?? "");
}

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://ainzy.net/v1", apiKey: "sk-YOUR_KEY" });

const stream = await client.chat.completions.create({
  model: "kimi-k3",
  messages: [{ role: "user", content: "Hi, introduce yourself" }],
  stream: true,
});
for await (const chunk of stream) {
  process.stdout.write(chunk.choices[0]?.delta?.content ?? "");
}

复制import anthropic

client = anthropic.Anthropic(base_url="https://ainzy.net", api_key="sk-你的key")

with client.messages.stream(
    model="glm-5.3",
    max_tokens=1024,
    messages=[{"role": "user", "content": "你好，介绍一下你自己"}],
) as stream:
    for text in stream.text_stream:
        print(text, end="", flush=True)

Copyimport anthropic

client = anthropic.Anthropic(base_url="https://ainzy.net", api_key="sk-YOUR_KEY")

with client.messages.stream(
    model="glm-5.3",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Hi, introduce yourself"}],
) as stream:
    for text in stream.text_stream:
        print(text, end="", flush=True)

复制curl https://ainzy.net/v1/responses \
  -H "Authorization: Bearer sk-你的key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.5",
    "input": "用一句话解释什么是 API 网关"
  }'

Copycurl https://ainzy.net/v1/responses \
  -H "Authorization: Bearer sk-YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.5",
    "input": "Explain what an API gateway is in one sentence"
  }'

Responses 示例需要 Codex 分组的 key；其余示例用国产模型分组的 key 即可。

The Responses sample needs a Codex-group key. The others work with a Chinese-model-group key.

计费说明

Billing

• 按量计费，无月费。只按实际消耗的 token 扣费，输入、输出、缓存命中分别计价。
• 美元计价。余额单位是美元，价格页显示每百万 token 的美元单价。支付宝按 ¥7 = $1 换算。
• 分组决定折扣。同一模型在不同分组价格不同，令牌建好后分组即固定。
• 缓存命中更便宜。国产模型分组对命中缓存的输入 token 按缓存价计费，重复上下文越多越省。
• 失败请求不扣费。返回错误的请求不会计入账单。
• 不限单账号并发。没有每账号并发上限，高并发直接跑即可。
• 邀请返利 10%。在钱包页拿邀请链接，被邀请用户每笔充值的 10% 会在几分钟内进入你的邀请奖励，可划转到余额。

• Pay as you go, no monthly fee. Only tokens actually consumed are charged. Input, output and cache-hit tokens are priced separately.
• Priced in US dollars. Balance is in USD and the pricing page shows USD per million tokens. Alipay converts at ¥7 = $1.
• The group sets the discount. The same model costs differently in different groups, and a key's group is fixed once created.
• Cache hits cost less. In the Chinese-model groups, cached input tokens are billed at the cache rate. The more repeated context, the more you save.
• Failed requests are free. Requests that return an error are not billed.
• No per-account concurrency cap. Run as many parallel requests as you need.
• 10% referral rebate. Get your invite link on the wallet page. 10% of every top-up by an invited user lands in your referral balance within minutes and can be moved to your main balance.

每一次调用的模型、token 数、扣费都记录在使用日志，账单逐条可查。

Every call's model, token counts and charge are recorded in the usage log, so the bill is auditable line by line.

错误对照

Errors

常见报错和处理方法。

Common errors and what to do about them.

常见问题

FAQ