常见问题 — API 文档

Q: 接入需要改代码吗？

不需要。网关同时兼容 OpenAI、Anthropic、Google Gemini 三套官方 SDK， 你只改 base_url 和 api_key 两行： OpenAI SDK：base_url="https://zhonkezhonkeapi.dflop.top/v1" Anthropic SDK：base_url="https://zhonkezhonkeapi.dflop.top"（不带 /v1） Gemini SDK：http_options={"base_url": "https://zhonkezhonkeapi.dflop.top"} 用哪套 SDK 与调哪家模型互不绑定 —— 可以用 OpenAI SDK 调 Claude，也可以用 Anthropic SDK 调 GPT，协议翻译在网关内部完成。完整示例见 快速开始。

Q: API Key 长什么样，在哪里创建？

格式是 sk-gpushare- 前缀 + 64 位十六进制字符，总长 76 字符。 在控制台 Dashboard → API Keys → Create Key 创建；原始 Key 之后可在 详情页随时重新查看（服务端加密存储）。每把 Key 可单独设置模型白名单、 有效期、启停、速率与并发上限、消费限额 —— 用于权限隔离与审计。 详见鉴权。

Q: 支持哪几种鉴权方式？

四种，任选其一：x-api-key 请求头（推荐）、Authorization: Bearer、 Gemini SDK 默认发送的 x-goog-api-key、以及 ?key= 查询参数。 三套 SDK 的默认鉴权行为都被直接识别，不需要为鉴权做任何改造。

Q: 怎么计费？一次调用扣多少？

平台唯一计量单位是积分，60 积分 = ¥1（机器可读口径见 GET https://zhonkezhonkeapi.dflop.top/api/v1/config/currency）。计费口径按模态区分： 文本模型：按输入 / 输出 token 计费，命中提示词缓存的输入按缓存价结算 图像模型：按出图张数计费 视频模型：按成片秒数计费 语音合成：按输入字符数计费；语音克隆、数字人形象按次计费 每次调用先按上限预扣，返回后按实际用量结算，差额自动退回。 每个模型的实时单价在模型广场逐条列出。

Q: 有免费额度吗？

有。注册即送 120 积分体验额度，足够跑通文档里的全部入门示例； 免费版用户每日登录再赠送 100 积分，并可畅用平台的精选免费模型。 额度与会员权益见价格页。

Q: 会员套餐怎么选？

免费版 ¥0：每日登录赠 100 积分，精选免费模型与 AI 创作平台开放 Plus 会员 ¥168/月（年付 ¥1,680）：每周赠 1,400 积分，全部模型开放 Pro 会员 ¥888/月（年付 ¥8,880）：每周赠 7,000 积分，更高速率与并发 企业 SaaS 版 ¥9,800 起：企业独立空间、团队共享积分池 企业私有化部署 ¥98,000 起：数据不出企业内网 积分不够时可随时买加油包（¥100 = 5,000 积分，大额档另有赠送），不必升级套餐。

Q: 所有 Key 共用一个余额吗？

是。同一账号下的全部 Key 共享同一个账户余额，Key 级配置用于权限与审计， 不是预算隔离。需要按项目分账时，用 Key 的消费限额与调用日志按 Key 归集。

Q: 支持流式输出吗？

支持。三套协议都支持 SSE 流式：OpenAI 侧传 stream=true， Anthropic 侧用 messages.stream()，Gemini 侧用 streamGenerateContent。 细节与中断处理见流式响应。

Q: 能在 Claude Code、Cursor 这类客户端里用吗？

可以，而且多数只要改一个环境变量或一个 Base URL 输入框。 已经验证过的客户端有 Claude Code、Cursor、Cline、Continue.dev、Open WebUI、 New API 与 FlopCode，逐个的配置步骤见 客户端集成。

本页把接入、计费、模型选择、会员与企业方案里最常被问到的问题集中在一处，每条都给出可直接照做的答案。想看完整参数与 schema，请从 API 参考进入。

Model 广场是什么？#

Model 广场（zhonkemodel.dflop.top）是一个多协议大模型 API 网关，同时也是一个 AI 创作平台。一把 sk-gpushare- 开头的密钥即可调用 Claude、GPT、Gemini、Grok、DeepSeek、豆包、 Kimi、通义千问、MiniMax、GLM、混元等厂商的模型，覆盖对话、图像生成、视频生成、音乐、语音合成、数字人与知识库检索。全部模型与实时价格见模型广场。

接入需要改代码吗？#

不需要。网关同时兼容 OpenAI、Anthropic、Google Gemini 三套官方 SDK，你只改 base_url 和 api_key 两行：

OpenAI SDK：base_url="https://zhonkezhonkeapi.dflop.top/v1"
Anthropic SDK：base_url="https://zhonkezhonkeapi.dflop.top"（不带 /v1）
Gemini SDK：http_options={"base_url": "https://zhonkezhonkeapi.dflop.top"}

用哪套 SDK 与调哪家模型互不绑定 —— 可以用 OpenAI SDK 调 Claude，也可以用 Anthropic SDK 调 GPT，协议翻译在网关内部完成。完整示例见快速开始。

API Key 长什么样，在哪里创建？#

格式是 sk-gpushare- 前缀 + 64 位十六进制字符，总长 76 字符。在控制台 Dashboard → API Keys → Create Key 创建；原始 Key 之后可在详情页随时重新查看（服务端加密存储）。每把 Key 可单独设置模型白名单、有效期、启停、速率与并发上限、消费限额 —— 用于权限隔离与审计。详见鉴权。

支持哪几种鉴权方式？#

四种，任选其一：x-api-key 请求头（推荐）、Authorization: Bearer、 Gemini SDK 默认发送的 x-goog-api-key、以及 ?key= 查询参数。三套 SDK 的默认鉴权行为都被直接识别，不需要为鉴权做任何改造。

怎么计费？一次调用扣多少？#

平台唯一计量单位是积分，60 积分 = ¥1（机器可读口径见 GET https://zhonkezhonkeapi.dflop.top/api/v1/config/currency）。计费口径按模态区分：

文本模型：按输入 / 输出 token 计费，命中提示词缓存的输入按缓存价结算
图像模型：按出图张数计费
视频模型：按成片秒数计费
语音合成：按输入字符数计费；语音克隆、数字人形象按次计费

每次调用先按上限预扣，返回后按实际用量结算，差额自动退回。每个模型的实时单价在模型广场逐条列出。

有免费额度吗？#

有。注册即送 120 积分体验额度，足够跑通文档里的全部入门示例；免费版用户每日登录再赠送 100 积分，并可畅用平台的精选免费模型。额度与会员权益见价格页。

会员套餐怎么选？#

免费版 ¥0：每日登录赠 100 积分，精选免费模型与 AI 创作平台开放
Plus 会员 ¥168/月（年付 ¥1,680）：每周赠 1,400 积分，全部模型开放
Pro 会员 ¥888/月（年付 ¥8,880）：每周赠 7,000 积分，更高速率与并发
企业 SaaS 版 ¥9,800 起：企业独立空间、团队共享积分池
企业私有化部署 ¥98,000 起：数据不出企业内网

积分不够时可随时买加油包（¥100 = 5,000 积分，大额档另有赠送），不必升级套餐。

所有 Key 共用一个余额吗？#

是。同一账号下的全部 Key 共享同一个账户余额，Key 级配置用于权限与审计，不是预算隔离。需要按项目分账时，用 Key 的消费限额与调用日志按 Key 归集。

支持流式输出吗？#

支持。三套协议都支持 SSE 流式：OpenAI 侧传 stream=true， Anthropic 侧用 messages.stream()，Gemini 侧用 streamGenerateContent。细节与中断处理见流式响应。

能在 Claude Code、Cursor 这类客户端里用吗？#

可以，而且多数只要改一个环境变量或一个 Base URL 输入框。已经验证过的客户端有 Claude Code、Cursor、Cline、Continue.dev、Open WebUI、 New API 与 FlopCode，逐个的配置步骤见客户端集成。

图像、视频、数字人怎么调用？#

图像走 /v1/images/generations 与 /v1/images/edits（按张计费）；视频是异步任务：提交后拿任务 ID 轮询结果（按成片秒数计费）；数字人与智能剪辑另有专用端点。参数与示例见图像 / 视频 API 与数字人 / 智能剪辑 API。

调用报错了，先看什么？#

先看 HTTP 状态码：401 invalid_api_key 是 Key 不对或已停用； 402 quota_exceeded 是余额不足；403 model_not_allowed 是这把 Key 的白名单不含该模型；429 rate_limit_exceeded 是超出速率或并发上限； 503 no_channel_available 是该模型当前无可用上游。每个错误响应都带 trace 字段，报障时附上它能直接定位到那一次调用。完整真值表见错误码。

一个模型的上游挂了会怎样？#

网关为同一个模型维护多条上游渠道，按优先级阶梯排列；可重试的失败（连接错误、5xx、429、超时）会自动换到下一条渠道重试，调用方拿到的仍是同一次请求的结果。上游明确拒绝的 4xx（如内容策略拒答）不会被重试 —— 换一条渠道只会买到同一个拒绝。

我的数据会被用于训练吗？#

不会用于我们自己的模型训练。请求与响应用于完成本次调用、计费结算与调用日志，调用日志可在控制台按 Key 查询。上游厂商的数据策略以各厂商条款为准。详见隐私政策。

有 OpenAPI 规范或者给 AI agent 用的机器可读文档吗？#

有，而且是一整套：

OpenAPI 3.1：https://zhonkezhonkemodel.dflop.top/openapi.json
RFC 9727 API 目录：https://zhonkezhonkemodel.dflop.top/.well-known/api-catalog
llms.txt：https://zhonkezhonkemodel.dflop.top/llms.txt（全文版 llms-full.txt）
A2A Agent Card：https://zhonkezhonkemodel.dflop.top/.well-known/agent-card.json
MCP Server Card：https://zhonkezhonkemodel.dflop.top/.well-known/mcp/server-card.json
Agent Skills 索引：https://zhonkezhonkemodel.dflop.top/.well-known/agent-skills/index.json

本站每一篇文档与每一个模型详情页都有 Markdown 版本 —— 在页面地址后加 .md 即可，例如 https://zhonkezhonkemodel.dflop.top/docs/quickstart.md。

有 MCP 服务器吗？#

有两个，用途不同：

知识库检索：https://zhonkezhonkeapi.dflop.top/mcp（Streamable HTTP），用同一把 sk-gpushare- 密钥鉴权，检索的是你自己在本平台建的知识库。接入步骤见知识库 API & MCP。
本站内容检索：https://search.dflop.top/mcp，无需鉴权，检索的是本站全部文档与模型详情页，让 AI 客户端直接查「某个模型怎么调、多少钱」。同一个索引也有 REST 形态：POST https://search.dflop.top/search，请求体 {"query": "..."}。

和直接用官方 API 有什么区别？#

三点：一把密钥覆盖多家厂商，不必逐家开户与充值；三套 SDK 协议互通，换模型不用换代码；同一个账号还带整套 AI 创作平台（生图、视频、数字人、无限画布）与桌面数字员工 Deski。代价是价格由平台统一定价，不等同于各厂商官网标价。

Deski 是什么？#

Deski 是本平台的桌面数字员工，运行在你自己的 macOS / Windows 电脑上：读本地文件、改代码、跑命令，每个任务开一个独立的 Git 工作树，改动先经你审查再合并。它与网关共用同一个账号和余额，详见 deski.dflop.top。

企业可以私有化部署吗？#

可以。企业版把整套平台（网关、创作工作台、知识库、素材库、智能体、数字人）部署在客户自己的服务器上，数据不出内网，账号由管理员开通、额度由企业算力包统一出资。方案与报价见价格页的企业方案部分。