行业应用前沿资讯

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

约 7 分钟阅读

AI最前沿 88Z.ai 11 月 12 日消息,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 模型 API 使用说明示意:Base URL、本站密钥和积分计费
88z.ai 模型 API 使用说明示意:Base URL、本站密钥和积分计费

它是什么,以及它明确不是什么

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 的当天内容为准。本文依据公开文档整理,若页面更新,以最新文本为准。

资料来源与整理说明

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

  1. 88z.ai API 说明原始资料发布于

以上日期为原始资料发布日期;标题下方日期为本文在 AI最前沿的发布时间。

相关阅读

全部资讯
Ai最前沿