# 常见问题

> 关于 Model 广场的接入、计费、模型、会员与企业方案的高频问答

来源：https://zhonkemodel.dflop.top/docs/faq

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

## Model 广场是什么？

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

## 接入需要改代码吗？

不需要。网关同时兼容 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，协议翻译在网关内部完成。完整示例见
[快速开始](./quickstart.md)。

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

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

## 支持哪几种鉴权方式？

四种，任选其一：`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 计费，命中提示词缓存的输入按缓存价结算
- 图像模型：按出图张数计费
- 视频模型：按成片秒数计费
- 语音合成：按输入字符数计费；语音克隆、数字人形象按次计费

每次调用先按上限预扣，返回后按实际用量结算，差额自动退回。
每个模型的实时单价在[模型广场](https://zhonkezhonkemodel.dflop.top/models)逐条列出。

## 有免费额度吗？

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

## 会员套餐怎么选？

- **免费版** ¥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`。
细节与中断处理见[流式响应](./guides/streaming.md)。

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

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

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

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

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

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

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

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

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

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

## 有 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](./reference/wiki-api.md)。
- **本站内容检索**：`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](https://deski.dflop.top)。

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

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