# 怎样调用 88z.ai 的模型 API：Base URL、鉴权、限制和计费怎么对上

- 分类: 行业应用
- 发布时间: 2026-11-12T02:22:02.334Z
- 原始资料日期: 2026-11-12
- HTML: https://www.88z.ai/news/news-how-to-call-the-88z-ai-relay-api-20261112
- Markdown: https://www.88z.ai/news/news-how-to-call-the-88z-ai-relay-api-20261112.md
- 另一语言: https://www.88z.ai/en/news/news-how-to-call-the-88z-ai-relay-api-20261112.md

88z.ai 提供一套聚合多家主流模型厂商、按人民币积分计费的 OpenAI 兼容子集 API。本文根据仍在线上的 /api.md 整理：如何注册并创建本站密钥，把 Base URL 指到 https://www.88z.ai/v1，以及当前支持哪些接口、有哪些限制、费用如何计算。它不是 Anthropic、OpenAI 或 Google 的官方接口，也和 88api.ai 不是同一家。

## 消息要点

- Base URL 使用 https://www.88z.ai/v1，密钥必须是本站创建的 Key，不要用其他平台的密钥。
- 当前已实现模型列表、非流式对话补全和生图；不支持流式、自定义工具调用、嵌入和音视频输出。
- 按实际用量以人民币积分计费，1 元 = 1,000 积分；目录价只是参考，结算使用请求开始时锁定的价格版本。
- 单次最多 32 条消息、64 KiB 文本；请设置 stream 为 false，并带上 Idempotency-Key。

## 它是什么，以及它明确不是什么

88z.ai（品牌为 88Z.ai（Ai最前沿））提供网页工作台，以及一套聚合多家主流模型厂商的 OpenAI 兼容 HTTP API。它是 AI 模型 API 平台：OpenAI 兼容接口，一个 Key 调用 Claude、GPT、Gemini、DeepSeek、Qwen 等主流模型，按人民币积分计费。规范说明在 https://www.88z.ai/api.md，英文版在 /en/api.md，机器可读价目在 https://www.88z.ai/models.json。

这份说明同时划了几条边界，应当先读清楚。它不是 Anthropic、OpenAI 或 Google 的官方 API；也不是 88api.ai，那是另一家独立站点。本站规范域名是 www.88z.ai。说明里还写明：当前目录条目数以当天页面为准，其中只有符合本站文本对话规则的模型可通过 /v1/chat/completions 调用；本页不提供延迟测评，也不把 88z.ai 说成一定是全网最便宜或某家厂商的官方国内直连。

## 注册、创建密钥，并把 Base URL 指到本站

使用前需要先在 https://www.88z.ai/register 注册，填写邮箱、昵称和 12 到 256 位密码，或在 https://www.88z.ai/login 登录。然后打开 https://www.88z.ai/api，在「API 密钥」里创建本站 Key。完整密钥只显示一次，账户还需要有足够积分。

调用时，把客户端的 Base URL 指到 https://www.88z.ai/v1。说明写明，工作台文档会按当前站点 origin 拼接，从 www 打开时就是这个地址；https://api.88z.ai/v1/ 同样指向同一组接口，但文档和示例默认仍使用 https://www.88z.ai/v1。鉴权方式是 Authorization: Bearer YOUR_API_KEY，同时带上 Content-Type: application/json，以及 Idempotency-Key: 你自己生成的唯一请求编号。没有密钥会返回 401 api_key_required，密钥无效则是 401 invalid_api_key。请使用本站创建的密钥，不要用其他平台的密钥。

## 现在能调用哪些接口，又有哪些限制

已实现的接口有三个。GET /v1/models 返回当前本站支持的文本模型，完整价格目录在 https://www.88z.ai/models，不必带密钥。POST /v1/chat/completions 支持多轮 system / user / assistant 的文字输入，部分模型支持图片，但仅非流式，请设置 stream 为 false。POST /v1/images/generations 使用 model 和 prompt 生成 1 张图，返回 base64 与费用，可用模型见工作台生图选择器。

限制同样写在说明里：单次最多 32 条消息、64 KiB 文本、4 张图片；图片须为 JPEG、PNG 或 WebP 的 data URL，解码后每张不超过 512 KiB、边长不超过 2048px，整个请求体不超过 4 MiB，并且模型须支持图片输入。可选 web_search 默认为关闭。不支持流式、自定义工具调用、嵌入和音视频输出。服务端对单次请求设有预留积分上限，默认 maxOutputTokens 为 4096。在 Cursor、Claude Code、Cherry Studio 等客户端里，同样要填本站 Base URL 和本站密钥，模型填完整 ID，并关闭 streaming。

## 费用怎么算，以及一个最小可运行的调用例子

计费规则是：发送前按请求上限预留积分；完成后按该次请求的实际用量，以请求开始时锁定的价格版本结算。1 元人民币 = 1,000 积分。目录价只是参考，不是承诺的最终账单。充值按人民币计价、设计为支付宝；在线充值是否已经开放自动到账，要以工作台和 GET /api/payments/config 的 enabled 字段为准，本文不把它写成一定已经开通。

一个最小的非流式调用可以这样写。先准备本站密钥和唯一的 Idempotency-Key，然后向 https://www.88z.ai/v1/chat/completions 发送 JSON：模型例如 anthropic/claude-sonnet-5.5，messages 里放一条用户消息，max_completion_tokens 设为 512，stream 设为 false。用官方 OpenAI Python SDK 时，api_key 填本站密钥，base_url 填 https://www.88z.ai/v1，并关闭流式；若 SDK 默认开启流式，必须显式关掉。说明中的 SDK 示例是按已公布的 HTTP 合同编写，并不在该页保证对生产环境逐行实测，因此第一次接入时，建议先用一把小额上限的请求确认返回格式和扣费是否符合预期。

## 88Z 观察：先对合同，再把它接到自己的工具里

这类模型 API 最容易踩的两个坑，是把本站接口理解成官方原厂 API，以及假定它支持完整的 OpenAI 能力，尤其是流式和工具调用。对照 /api.md 可以很快排除这两点。另一个常见问题是用错密钥：必须用本站创建的 Key，不要用其他平台的密钥。

如果你要把 88z.ai 接到现有应用，建议先完成三步核对：Base URL 和鉴权头是否与文档一致，stream 是否为 false，以及账户积分是否足够覆盖这次请求的预留额度。模型目录和价格会变化，应以 https://www.88z.ai/models 和 https://www.88z.ai/pricing.md 的当天内容为准。本文依据公开文档整理，若页面更新，以最新文本为准。

## 资料来源

- [88z.ai API 说明](https://www.88z.ai/api.md) (2026-11-12)

本文由 AI最前沿通过 AI 辅助整理公开资料。产品能力与开放范围按发布方说明转述，未将其视为本站实测或独家采访结论。
