帮助中心

🚀快速入门

5 分钟上手词元宝，快速开始你的 AI 之旅

1

注册账号

点击右上角「立即使用」进入控制台注册，支持手机号 / 邮箱注册，3 分钟完成。

2

获取 API Key

登录后在控制台「API 密钥」页面创建 Key，妥善保管，不要在客户端代码中暴露。

3

发送第一个请求

使用以下代码发送你的第一个 API 请求，选择合适的模型即可开始使用。

curl https://api.ciyuanbao.net/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-your-api-key" \
  -d '{
    "model": "deepseek-v4-pro",
    "messages": [{"role": "user", "content": "你好，请简单介绍一下词元宝"}]
  }'

👤账号与计费

关于账号管理、Token 计费、充值方式的常见问题

如何充值？▼

登录控制台 →「计费中心」→「充值」，支持微信支付 / 支付宝 / 对公转账。最低充值金额 ¥10，实时到账。企业客户可联系销售经理申请后付费模式。

Token 如何计算？▼

Token 是模型处理的文本单位，中文约 1-1.5 字 = 1 Token，英文约 0.75 词 = 1 Token。费用 = 输入 Token + 输出 Token 分别按模型单价计算。每小时更新一次用量，控制台提供实时消耗看板。

文本模型：¥0.3~¥2.0 / 百万 Token | 视觉模型：¥2.5~¥3.0 / 百万 Token | 推理模型：¥2.0 / 百万 Token

如何修改密码？▼

控制台右上角头像 →「账号设置」→「安全」→「修改密码」。如忘记密码，在登录页面点击「忘记密码」通过注册手机/邮箱重置。

余额不足会怎样？▼

余额为零时 API 调用将返回 HTTP 402 Payment Required 错误。建议开启「自动充值」功能，设置最低余额阈值，余额低于阈值时自动充值，避免服务中断。

如何申请发票？▼

控制台「计费中心」→「发票管理」→「申请开票」。支持电子发票和纸质专票，电子发票 1 个工作日内开具，纸质发票 5 个工作日内寄出。

🔌API 接入

API 基础地址、请求格式、错误码说明

API 基础地址是什么？▼

生产环境：https://api.ciyuanbao.net
测试环境：https://api-test.ciyuanbao.net

所有 API 端点遵循 OpenAI 兼容格式，可直接使用 OpenAI SDK（openai Python 包）接入，只需修改 base_url 和 api_key。

支持哪些 SDK？▼

词元宝 API 完全兼容 OpenAI SDK，支持以下语言：

• Python：pip install openai，修改 base_url 即可
• Node.js：npm install openai，修改 baseURL
• Java / Go / C# 等：可直接通过 REST API 调用

我们还提供官方的 CIYUANBAO Python SDK 和 JS SDK，欢迎在 GitHub 上查阅。

调用频次限制是多少？▼

• 免费版：10 次/分钟，500 次/天
• 专业版（¥169/月）：60 次/分钟
• 企业版（¥699/月）：300 次/分钟，可定制

超出限制返回 HTTP 429 Too Many Requests，建议客户端实现指数退避重试。

常见错误码有哪些？▼

400 — 请求参数错误，检查 model 名称和 messages 格式
401 — API Key 无效或已过期
402 — 账户余额不足
429 — 请求频率超限
500 — 服务器内部错误，稍后重试
503 — 服务暂时不可用（模型过载或维护中）

返回体统一格式：{ "error": { "code": "xxx", "message": "xxx" } }

是否支持流式输出（SSE）？▼

支持。在请求体中设置 "stream": true 即可启用 SSE 流式输出，体验类似打字机效果的逐字生成。响应格式与 OpenAI 兼容，每个 chunk 为 JSON 行，以 data: 前缀发送。

🧠模型使用

模型选择、切换、对比与最佳实践

如何选择最适合的模型？▼

截至 2026 年 7 月平台汇聚 16 款模型。选择大总管按场景推荐：

• 文本生成：DeepSeek-V4-Pro（综合）> Qwen3.6-Plus（编程）> Kimi K2.7（长文）
• 深度推理：DeepSeek-R2 ≥ 豆包 Seed 2.1 Pro
• 代码生成：Qwen3.5-Coder ＞ GLM-5.2 ＞ DeepSeek-V4-Pro
• 多模态/图像：Qwen-VL-Max ＞ GLM-5V-Turbo ＞豆包 Vision
• 中文优化：文心一言 5.0 ≥ 百川 4 ＞星火 V5+
• 低延迟 / 高并发：文心 Speed ¥0.3/M → 豆包 Seed 2.1 ¥1.0/M → MiniMax M2.7 ¥1.0/M
• 超长上下文（>200K）：DeepSeek-V4-Pro / Kimi K2.7 (1M) ＞ MiniMax M2.7 / Yi-Lightning (256K)

如何切换使用的模型？▼

修改 API 请求中的 model 参数即可。模型 ID 与平台命名一致，例如 deepseek-v4-pro、qwen-3.6-plus。

如果启用了「智能路由」功能，传入 "model": "auto" 系统将自动选择最优模型。

如何对比不同模型的效果？▼

控制台提供「模型对比」工具：输入同一个 Prompt，同时向多个模型发送请求，直观对比回复质量、响应速度和 Token 消耗。访问控制台 →「模型对比」即可使用。

模型响应太慢怎么办？▼

响应速度受模型复杂度和负载影响。建议：
• 优先使用轻量模型（文心 Speed / GLM-5.2）
• 启用「语义缓存」减少重复计算的延迟
• 开启「智能路由」自动切换到当前可用的最快模型
• 检查网络延迟，国内用户建议使用国内节点

🔐安全与合规

数据安全、隐私保护、合规认证

我的数据安全吗？▼

我们高度重视数据安全：所有 API 通信采用 TLS 1.3 加密传输；默认不记录用户 Prompt 和回复内容（可通过控制台开启审计日志功能）；日志数据加密存储，访问权限严格控制。如需最高安全级别，可选择「私有化部署」方案，数据完全留在你的内网环境。

模型会用我的数据训练吗？▼

不会。词元宝作为 API 网关，不会将你的请求数据用于模型训练。各底层模型服务商也有独立的数据使用政策，所有主流模型均已承诺不将 API 调用数据用于训练。我们建议在控制台开启「数据不做训练」配置以确保。

如何保护敏感信息不被泄露？▼

平台提供多重保护机制：
• PII 脱敏：自动识别并脱敏手机号、身份证、银行卡号等敏感信息
• 内容安全过滤：实时过滤涉政、涉黄、涉暴等违规内容
• 数字水印：输出内容可嵌入不可见水印，便于泄露溯源
• 以上功能可在控制台「安全策略」页面按需开启

🔧排障指南

常见故障排查与自助解决

API 返回 401 Unauthorized▼

检查 API Key 是否正确、是否已过期或被删除。在控制台「API 密钥」页面确认 Key 状态，如有问题请重新创建一个新 Key 并替换环境变量。

请求超时怎么办？▼

默认超时时间为 60 秒。如遇到超时：
• 适当增加客户端超时设置（SDK 中设置 timeout 参数）
• 检查 Prompt 是否过长导致处理时间增加
• 尝试切换至轻量级模型
• 启用智能路由功能自动切换至响应最快的可用模型
• 如果持续超时，请检查网络连接并查看「服务状态」页面确认是否有维护

回复内容不完整或截断？▼

增加 max_tokens 参数值。各模型默认最大输出 Token 数不同，如需更长回复可在请求中显式设置更大的 max_tokens 值，但注意总 Token 数 = max_tokens + 输入 Token，不能超过模型的上下文长度限制。

如何联系技术支持？▼

• 在线聊天：控制台右下角点击「在线客服」图标
• 邮件支持：support@ciyuanbao.net，通常 4 小时内回复
• 企业客户专属：请联系你的 TAM（技术支持经理）或拨打 400 热线
• 社区：加入我们的技术社区获取其他开发者的帮助

还没找到答案？