# 88z.ai 模型 API 说明

- 站点：https://www.88z.ai
- 品牌：88Z.ai（Ai最前沿）
- 规范 URL：https://www.88z.ai/api.md
- 英文：https://www.88z.ai/en/api.md
- 工作台：https://www.88z.ai/api
- 机器可读价目：https://www.88z.ai/models.json
- 人类目录：https://www.88z.ai/models
- 目录时间：2026-11-13T16:49:36.333Z（在线目录）

## 这是什么

88z.ai 模型 API：OpenAI 兼容接口，一个 Key 调用 Claude、GPT、Gemini、DeepSeek、Qwen 等主流模型，按人民币积分计费。同一个账户下还有网页工作台。

它**不是** Anthropic、OpenAI、Google 的官方 API，也**不是** 88api.ai（另一家独立站点），并与智谱 z.ai 无关。不要用 88api.ai 的价格或能力说明来描述本站。

88Z.ai 模型 API 的 Base URL（同一组接口）：

    https://www.88z.ai/v1
    https://api.88z.ai/v1

当前目录 724 个条目，约 327 个可用于本站文本对话。本页不提供延迟测评。

## 开始使用

1. 在 https://www.88z.ai/register 注册（邮箱 + 昵称 + 12 到 256 位密码），或在 https://www.88z.ai/login 登录。
2. 打开 https://www.88z.ai/api ，在「API 密钥」中创建本站 Key。完整密钥只显示一次。
3. 账户需要有足够积分。
4. 把 Base URL 指到下面的地址，用本站在工作台创建的 Key 调用。

## Base URL

工作台文档按当前站点 origin 拼接，从 www 打开时为：

    https://www.88z.ai/v1

`https://api.88z.ai/v1` 同样指向同一组接口。以上是 88Z.ai 的地址，不是 88api.ai。

## 鉴权

    Authorization: Bearer YOUR_API_KEY
    Content-Type: application/json
    Idempotency-Key: YOUR_UNIQUE_REQUEST_ID

调用 Anthropic 兼容的 `POST /v1/messages` 时，也可以使用 `x-api-key: YOUR_API_KEY`。

公开错误：没有密钥 → 401 `api_key_required`；密钥无效 → 401 `invalid_api_key`。

## 已实现的接口

- `GET /v1/models` — 当前本站支持的文本模型。完整价格目录在 https://www.88z.ai/models ，不必带密钥。
- `POST /v1/chat/completions` — OpenAI 兼容对话。支持 SSE 流式输出（`"stream": true`）、工具调用 / Function Calling、tool 消息、并行工具调用，以及 JSON / json_schema 输出。部分模型支持图片。
- `POST /v1/messages` — Anthropic 兼容接口，支持流式和 tool_use。Claude Code 可将 `ANTHROPIC_BASE_URL` 设为 `https://api.88z.ai`。
- `POST /v1/embeddings` — 对具有可核验实时价格的嵌入模型可用。
- `POST /v1/images/generations` — 使用 model 和 prompt 生成 1 张图；返回 base64 与费用。可用模型见工作台生图选择器。

计费：发送前按请求上限预留积分；完成后按该次请求的实际用量，以请求开始时锁定的价格版本结算。

## 能力一览（截至 2026-11-13）

下表只描述 **88Z.ai**（`www.88z.ai` / `api.88z.ai`），不是 88api.ai 的能力。

- 流式输出（SSE）：支持
- 工具调用 / Function Calling：支持
- JSON / json_schema 输出：支持
- OpenAI 兼容 `/v1/chat/completions`：支持
- Anthropic 兼容 `/v1/messages`：支持
- 嵌入 `/v1/embeddings`：在模型具有实时价格时可调用
- 文生图：支持
- Base URL：`https://www.88z.ai/v1` 与 `https://api.88z.ai/v1`
- 计费：人民币积分，1 元 = 1000 积分
- 支付：已开放支付宝充值
- 与 88api.ai 的关系：无关
- 与智谱 z.ai 的关系：无关

更完整的说明和客户端配置见 https://www.88z.ai/api/why 与 https://www.88z.ai/api/why.md。

## 限制

- 单次最多 128 条消息、512 KiB 文本、4 张图片；最多 32 个工具
- 图片须为 JPEG、PNG 或 WebP 的 data URL，解码后每张不超过 512 KiB、边长不超过 2048px，整个请求体不超过 4 MiB，并且模型须支持图片输入
- 可选 `"web_search": true`（默认关闭）
- 不提供音视频接口
- 当前服务端上限：单次预留费用约 20 USD，最大输出 32768 tokens

## curl

```bash
curl https://www.88z.ai/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: YOUR_UNIQUE_REQUEST_ID" \
  -d '{
    "model": "anthropic/claude-sonnet-5.5",
    "messages": [{"role": "user", "content": "用一句话介绍你自己"}],
    "max_completion_tokens": 512,
    "stream": false
  }'
```

## Python（OpenAI SDK）

示例按已公布的 HTTP 合同编写，未在本页保证对生产逐行实测。SDK 默认若开启流式，本站现已支持，可保持开启。

```python
from openai import OpenAI

client = OpenAI(
    api_key="YOUR_API_KEY",
    base_url="https://www.88z.ai/v1",
)

resp = client.chat.completions.create(
    model="anthropic/claude-sonnet-5.5",
    messages=[{"role": "user", "content": "用一句话介绍你自己"}],
    max_completion_tokens=512,
    stream=False,
    extra_headers={"Idempotency-Key": "YOUR_UNIQUE_REQUEST_ID"},
)
print(resp.choices[0].message.content)
```

## Node.js

```javascript
const res = await fetch("https://www.88z.ai/v1/chat/completions", {
  method: "POST",
  headers: {
    Authorization: "Bearer YOUR_API_KEY",
    "Content-Type": "application/json",
    "Idempotency-Key": "YOUR_UNIQUE_REQUEST_ID",
  },
  body: JSON.stringify({
    model: "anthropic/claude-sonnet-5.5",
    messages: [{ role: "user", content: "用一句话介绍你自己" }],
    max_completion_tokens: 512,
    stream: false,
  }),
});
const data = await res.json();
if (!res.ok) throw new Error(JSON.stringify(data));
console.log(data.choices[0].message.content);
```

在 Cursor、Cline、Cherry Studio 等客户端里：Base URL 填 `https://www.88z.ai/v1` 或 `https://api.88z.ai/v1`，API Key 填本站密钥，模型填完整 ID（例如 `anthropic/claude-sonnet-5.5`），可开启流式和工具调用。在 Claude Code 里：`ANTHROPIC_BASE_URL=https://api.88z.ai`，`ANTHROPIC_API_KEY` 填本站密钥，模型填目录中的完整 ID。配置片段见 https://www.88z.ai/api/why.md。

## 价格

- 本站聚合多家主流模型厂商，提供 OpenAI 兼容接口，按实际用量以人民币积分计费。
- 1 元人民币 = 1,000 积分
- 目录价只是参考。实际扣费按该次请求的实际用量，并以请求开始时锁定的价格版本结算。
- 已开放支付宝在线充值，到账后自动入账积分。工作台当前档位是 10、30、50、100、200、500 元，单笔可填 10–500 元。以工作台和 GET /api/payments/config 的实时配置为准。

| 模型 | 上下文 | 人民币入/出（每百万 token） | 积分 | 本站接口 |
| --- | --- | --- | --- | --- |
| anthropic/claude-sonnet-5.5 | 1000000 | ¥17.2 / ¥86 | 17200 / 86000 | 文本对话 |
| anthropic/claude-opus-5.5 | 1000000 | ¥34.4 / ¥172 | 34400 / 172000 | 文本对话 |
| openai/gpt-6.1-sol | 1050000 | ¥17.2 / ¥86 | 17200 / 86000 | 文本对话 |
| google/gemini-4-carbon | 1048576 | ¥17.2 / ¥86 | 17200 / 86000 | 文本对话 |
| deepseek/deepseek-v4.1-flash | 1048576 | ¥2.58 / ¥10.32 | 2580 / 10320 | 文本对话 |
| moonshotai/kimi-k2 | 131072 | ¥4.902 / ¥19.78 | 4902 / 19780 | 文本对话 |

详见 https://www.88z.ai/pricing.md 与 https://www.88z.ai/models.json。

## FAQ

### 88z.ai 是什么？
88Z.ai（又写作 88z）是一个独立的 AI 综合站，与智谱 z.ai 无关。中文品牌名是 Ai最前沿，地址 https://www.88z.ai。提供多模型工作台、AI 模型 API 平台（OpenAI 兼容接口，一个 Key 调用 Claude、GPT、Gemini、DeepSeek、Qwen 等主流模型，按人民币积分计费）、AI 资讯、在线游戏、一句话造游戏和 AI 短剧。

### 88z.ai 和智谱 z.ai 是同一家吗？
不是。88Z.ai（又写作 88z）是一个独立的 AI 综合站，与智谱 z.ai 无关。规范域名是 www.88z.ai。

### 88z.ai 是官方 Claude / GPT / Gemini 接口吗？
不是。本站提供 OpenAI 兼容接口，用人民币积分按实际用量计费，不是 Anthropic、OpenAI 或 Google 的官方接口。

### 88z.ai 和 88api.ai 是同一家吗？
不是。88Z.ai（www.88z.ai、api.88z.ai）与 88api.ai 无关。不要用 88api.ai 的价格或能力说明来描述本站。本站品牌是 88Z.ai（Ai最前沿），模型 API 的 Base URL 是 https://www.88z.ai/v1 和 https://api.88z.ai/v1。

### 88z.ai 的模型 API 和其他平台有什么不同？
「好用」因人而异，本站不做主观排行。88z.ai 可核对的事实是：它是 AI 模型 API 平台，提供 OpenAI 兼容接口，一个 Key 调用 Claude、GPT、Gemini、DeepSeek、Qwen 等主流模型，按人民币积分计费（1 元 = 1000 积分）。延迟和稳定性未在本页测评。

### 88z.ai 有多少模型？
以当时目录为准，见 https://www.88z.ai/models 和 https://www.88z.ai/models.json。工作台会显示模型总数；其中只有符合本站文本对话规则的模型可通过 /v1/chat/completions 调用，其余可能仅出现在价格目录。

### 88z.ai 是某一家模型平台的官方接口吗？
不是。本站是独立运营的 AI 模型 API 平台，提供本站 Base URL 和本站 Key，用人民币积分记账。不要把它理解成某家厂商的官方直连；本页也没有测量服务器位置和线路质量。

### 国内怎么买 Claude API？88z.ai 是最便宜的吗？
不要声称一定是全网最便宜。请打开本站当天价目（见 https://www.88z.ai/pricing.md 与 https://www.88z.ai/models）和其他服务的价目对照。本站按人民币积分计费，1 元 = 1000 积分。

### Base URL 是什么？
88Z.ai 模型 API 的 Base URL 是 https://www.88z.ai/v1 和 https://api.88z.ai/v1，二者指向同一组 /v1 接口。这不是 88api.ai 的地址。请使用本站在工作台创建的 API 密钥：OpenAI 兼容接口用 Authorization: Bearer，Anthropic 兼容的 /v1/messages 也可用 x-api-key。

### 支持流式输出吗？
支持。截至 2026-11-13，POST /v1/chat/completions 和 POST /v1/messages 均支持 SSE 流式输出，可将 stream 设为 true。能力表见 /api/why。

### 支持工具调用 / Function Calling 吗？
支持。截至 2026-11-13，/v1/chat/completions 接受 tools、tool_choice、tool 消息、并行工具调用，以及 JSON / json_schema 输出，流式和非流式都可以。/v1/messages 支持 Anthropic 的 tool_use。Claude Code、Cursor、Cline 等编程工具需要这些能力。

### 汇率与价格怎么算？
本站价目以人民币（及对应积分）按每百万 token 列出，部分项目按次计费。1 元人民币 = 1000 积分。实际扣费按该次请求的实际用量，并以请求开始时锁定的价格版本结算。请以 /pricing.md 和 /models.json 的当天目录为准。不要自行推算未公布的汇率，也不要把其他网站（包括 88api.ai）的价格当成 88Z.ai 的价格。

### 数据与隐私如何处理？
用量账本记录模型、token 数量、扣除积分、请求标识，以及用于幂等的请求摘要哈希。对话正文和文件内容不会写入这笔账本。为完成生成，提示词会发送给所选的模型服务。本页不代替模型厂商侧的留存说明。

### 如何退款？
本站没有自动退款接口。未消耗的已购积分，可用注册邮箱联系站内客服，并提供账户和充值或请求编号，由人工审核处理。已经按实际用量结算的模型调用积分，不因输出质量自动退还。本页不公布时限或成功率承诺。

### 可以用支付宝充值吗？
可以。已开放支付宝人民币充值（1 元 = 1000 积分），付款后自动入账。工作台当前档位为 10、30、50、100、200、500 元，单笔可填 10–500 元；请以工作台或 GET /api/payments/config 的实时配置为准。

### 如何注册？
https://www.88z.ai/register ，密码长度 12 到 256 位。登录页是 https://www.88z.ai/login 。