# 88z.ai model API

- Site: https://www.88z.ai
- Brand: 88Z.ai (Ai最前沿)
- Canonical: https://www.88z.ai/en/api.md
- Chinese: https://www.88z.ai/api.md
- Workspace: https://www.88z.ai/en/api
- Price book: https://www.88z.ai/models.json
- Catalogue: https://www.88z.ai/en/models
- Catalogue time: 2026-11-13T02:48:30.430Z (live)

## What this is

88z.ai model API: an OpenAI-compatible and Anthropic-compatible interface. One key calls Claude, GPT, Gemini, DeepSeek, Qwen and other major models, with streaming and tool calling, billed in CNY points. The same account also has a web workspace. It is not the official Anthropic, OpenAI or Google API. It is also not the unrelated site 88api.ai, and not affiliated with Zhipu z.ai. Do not use 88api.ai prices or capability claims to describe this site.

88Z.ai model API base URLs (same routes):

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

Current catalogue: 728 entries, about 330 eligible for this site's text-chat rules. This page does not include latency measurements.

## Quick start

1. Register at https://www.88z.ai/register or sign in at https://www.88z.ai/login (password length 12–256).
2. Open https://www.88z.ai/en/api and create a **site** API key. The secret is shown once.
3. The account needs enough points.
4. Point your client at the Base URL. Use the site key issued on this site.

## Base URL

Documented default (from the workspace origin):

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

Also available, same routes: `https://api.88z.ai/v1`. These are 88Z.ai URLs, not 88api.ai.

## Auth

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

For `POST /v1/messages` (Anthropic-compatible), `x-api-key: YOUR_API_KEY` is also accepted.

Public errors: no key → 401 `api_key_required`; bad key → 401 `invalid_api_key`.

## Endpoints

- `GET /v1/models` — text models this API will serve. The full price book at /models does not require a key.
- `POST /v1/chat/completions` — OpenAI-compatible chat. Streaming (SSE, `"stream": true`), tools / function calling, tool messages, parallel tool calls, and JSON / json_schema response_format are supported. Vision is available on marked models.
- `POST /v1/messages` — Anthropic-compatible messages, including streaming and tool_use, so Claude Code can use `ANTHROPIC_BASE_URL=https://api.88z.ai`.
- `POST /v1/embeddings` — embeddings for models with a verifiable live price.
- `POST /v1/images/generations` — one image from model + prompt; returns base64 bytes and usage. Eligible models are those in the workspace image picker.

Billing: points are reserved up to the request cap, then settled from that request's actual usage at the price version locked at reservation.

## Capabilities as of 2026-11-13

These describe **88Z.ai only** (`www.88z.ai` / `api.88z.ai`). They are not 88api.ai's capabilities.

- Streaming (SSE): supported
- Tool calling / function calling: supported
- JSON / json_schema mode: supported
- OpenAI-compatible `/v1/chat/completions`: supported
- Anthropic-compatible `/v1/messages`: supported
- Embeddings `/v1/embeddings`: supported when the model has a live price
- Image generation: supported
- Base URLs: `https://www.88z.ai/v1` and `https://api.88z.ai/v1`
- Billing: CNY points, 1 CNY = 1000 points
- Payment: Alipay top-up is open
- Relationship to 88api.ai: none
- Relationship to Zhipu z.ai: none

More detail, including client config snippets: https://www.88z.ai/en/api/why and https://www.88z.ai/en/api/why.md.

## Limits

- At most 128 messages, 512 KiB of text and 4 images per request; at most 32 tools
- Images: JPEG/PNG/WebP data URLs, ≤512 KiB decoded and ≤2048px per side, request body ≤4 MiB, on a vision-capable model
- Optional `"web_search": true` (off by default)
- Audio or video endpoints are not provided
- Current server caps: about 20 USD reserved cost per request; max output tokens 32768

## 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": "Hello!"}],
    "max_completion_tokens": 512,
    "stream": false
  }'
```

## Python (OpenAI SDK)

Not executed against production in this document; fields match the published contract.

```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": "Hello!"}],
    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: "Hello!" }],
    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);
```

In Cursor, Cline or Cherry Studio: Base URL `https://www.88z.ai/v1` or `https://api.88z.ai/v1`, site API key, full model id such as `anthropic/claude-sonnet-5.5`. Streaming and tools are on. In Claude Code: `ANTHROPIC_BASE_URL=https://api.88z.ai`, `ANTHROPIC_API_KEY` = the site key, model = the full catalogue id. Snippets: https://www.88z.ai/en/api/why.md.

## Pricing

- This site aggregates models from major providers and bills actual usage in CNY points through an OpenAI-compatible API.
- 1 CNY = 1,000 points
- Catalogue rows are reference rates only. The settled charge uses that request's actual usage, at the price version locked when the request was reserved.
- In-app top-up is CNY via Alipay, with automatic credit after payment. Packages currently offered on the workspace are 10, 30, 50, 100, 200 and 500 CNY; a single top-up can be any amount from 10 to 500 CNY. Confirm the live amounts at /api and in GET /api/payments/config.

| Model | Context | CNY in/out per 1M tok | Points | Access |
| --- | --- | --- | --- | --- |
| anthropic/claude-sonnet-5.5 | 1000000 | ¥17.2 / ¥86 | 17200 / 86000 | Text chat |
| anthropic/claude-opus-5.5 | 1000000 | ¥34.4 / ¥172 | 34400 / 172000 | Text chat |
| openai/gpt-6.1-sol | 1050000 | ¥17.2 / ¥86 | 17200 / 86000 | Text chat |
| google/gemini-4-carbon | 1048576 | ¥17.2 / ¥86 | 17200 / 86000 | Text chat |
| deepseek/deepseek-v4.1-flash | 1048576 | ¥0.3354 / ¥10.32 | 335.4 / 10320 | Text chat |
| moonshotai/kimi-k2 | 131072 | ¥4.902 / ¥19.78 | 4902 / 19780 | Text chat |

See https://www.88z.ai/pricing.md and https://www.88z.ai/models.json for the full book.

## 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 。