快速开始

从零到第一次成功调用大约需要 5 分钟。下面四步适用于所有语言与客户端,完成后即可继续阅读OpenAI 兼容或Anthropic 兼容章节。

第 1 步:注册并领取试用积分

使用邮箱在注册页完成注册,系统会自动发放试用积分(默认 2000 积分,约 ¥20),无需绑定支付方式。注册成功后直接进入控制台。

第 2 步:创建 API Key

在控制台进入「API Keys」,点击新建并填写用途名称(例如 本地调试)。生成的 Key 形如 sk-zn-xxxxxxxxxxxxxxxx,仅在创建时完整展示一次,请立即复制保存。

  • 建议按项目 / 环境分别创建 Key,便于定位异常用量与单独停用。
  • Key 可随时停用,停用后立即失效,不影响其他 Key。
  • Key 数量上限由订阅套餐决定,未订阅用户也可创建少量 Key。

第 3 步:发起第一次调用

智脑的 OpenAI 兼容 base_url 是 https://zhinao.75zs.com/v1。选择你熟悉的语言:

bash
curl https://zhinao.75zs.com/v1/chat/completions \
  -H "Authorization: Bearer sk-zn-xxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-chat",
    "messages": [{ "role": "user", "content": "用一句话介绍你自己" }],
    "stream": false
  }'

返回体中 choices[0].message.content 即模型输出,usage 字段包含本次消耗的输入 / 输出 tokens,可据此估算积分消耗。

查看可用模型

模型 slug 即请求中的 model 字段。也可以直接拉取清单:

bash
curl https://zhinao.75zs.com/v1/models \
  -H "Authorization: Bearer sk-zn-xxxx"

完整模型与单价见模型与价格。

第 4 步:确认扣费与用量

  • 控制台「用量」按请求列出模型、tokens、耗时与扣除积分,可按时间与 Key 筛选。
  • 「订阅」查看周期额度与到期时间,「充值」查看永久积分余额与积分包。
  • 1 积分 = ¥0.01;单次请求不足 1 积分按 1 积分计,失败请求不计费。

流式输出

对话类应用建议开启流式,首字延迟更低。以 Python 为例:

python
from openai import OpenAI

client = OpenAI(api_key="sk-zn-xxxx", base_url="https://zhinao.75zs.com/v1")

stream = client.chat.completions.create(
    model="deepseek-chat",
    messages=[{"role": "user", "content": "写一段 100 字的产品介绍"}],
    stream=True,
)

for chunk in stream:
    delta = chunk.choices[0].delta.content
    if delta:
        print(delta, end="", flush=True)

常见接入问题

  • 401 缺少或无效 Key:确认请求头是 Authorization: Bearer sk-zn-...,且没有多余空格或换行。
  • 404 model_not_found:确认 model 使用的是智脑的模型 slug(见模型与价格),不是上游厂商的内部名称。
  • 402 积分不足:试用积分用尽,可在控制台充值或订阅。
  • 更多错误码见错误码与排查。