f

content/faq.mdx

@@ -1,32 +1,128 @@
 ---
 title: 常见问题
-description: 接入与使用中的常见问题解答
+description: 接入、账号、计费与错误排查
 ---
 
 # 常见问题
 
-## 返回 401 Unauthorized
+## 账号与实名认证
 
-- 检查 `Authorization: Bearer` 后是否有多余空格  
-- 确认 Key 未被禁用、未过期  
-- 确认请求发往正确的 Base URL  
+### 为什么无法创建 API Key 或充值？
 
-## 返回 429 Too Many Requests
+创建 API Key、使用体验中心、充值与查看完整财务信息前，需先在 **账户中心 → 实名认证** 完成认证。若页面提示「请先完成实名认证」，按指引提交材料即可。
 
-表示触发 **限流**。请降低并发、实现指数退避重试，或联系商务提升配额。
+### 个人认证和企业认证有什么区别？
 
-## 模型不存在 / model_not_found
+- **个人认证**：满足个人开发者试调用、在线充值与 API 接入。
+- **企业认证**：满足企业对公结算、发票与合规要求；**对公转账充值** 仅企业认证用户可用。
 
-模型 ID 拼写错误或账号未开通该模型。请在 **模型广场** 复制准确 ID。
+### 实名核验次数有限制吗？
 
-## 如何对账？
+个人/企业/法人相关核验接口有 **每日次数上限**（如单日 10 次）。若提示「今日核验次数已达上限」，请次日再试或联系客服。
 
-控制台 **账单** 模块可按日查看调用量与费用；企业客户可申请导出明细与发票。
+### 如何修改登录密码？
 
-## 是否支持私有化部署？
+**账户中心 → 账号设置** 中通过手机号验证修改密码；忘记密码可在登录页使用 **忘记密码** 流程。
 
-企业方案支持专有云与私有化，请通过官网 [联系我们](/#contact) 获取方案与 POC 安排。
+---
 
-## 文档有错误怎么办？
+## 接入与 API
 
-文档随产品迭代更新；若发现过时信息，请通过控制台反馈或邮件联系技术支持。
+### Base URL 和路径是什么？
+
+- Base URL：`https://api.haiyushuke.com/v1`
+- 对话补全：`POST /chat/completions`
+- 鉴权：`Authorization: Bearer <API Key>`
+
+与 OpenAI 官方 SDK 兼容时，仅需修改 `apiKey` 与 `baseURL`。详见 [OpenAI SDK 兼容](/docs/guides/openai_compatible) 与 [核心概念 · Token](/docs/concepts/overview#token-与-usage)。
+
+### 返回 401 Unauthorized
+
+- 确认 Header 为 `Bearer <Key>`，Bearer 与 Key 之间有一个空格  
+- Key 是否已 **禁用** 或 **过期**  
+- 是否误用了控制台登录 JWT 代替 API Key  
+- 请求是否发往正确的网关域名  
+
+### 返回 403 Forbidden
+
+常见原因：
+
+- 未完成实名认证却访问受限能力（控制台内功能）
+- API Key 绑定的 **模型列表** 不包含当前请求的 `model`
+- **IP 白名单** 未包含调用方出口 IP
+
+### 返回 402 / 余额不足还能调用吗？
+
+不能。业务码一般为 `INSUFFICIENT_BALANCE`，表示账户余额不足以完成扣费。请在 **财务 → 账户充值** 充值，或在 **通知管理** 中设置余额告警。
+
+### 返回 429 Too Many Requests
+
+表示触发 **限流**（网关或上游）。请降低并发、对可重试错误做指数退避，或联系商务提升配额。
+
+### 模型不存在 / model_not_found
+
+- 检查 `model` 字符串是否与 **模型广场** 中的 ID 完全一致（区分大小写与后缀）  
+- 确认该 Key 的 **可用模型** 范围是否包含此模型  
+- 新模型上线后若不可用，刷新模型列表或联系支持确认开通状态  
+
+### 流式调用没有输出或中途断开
+
+- 请求体需设置 `"stream": true`  
+- 客户端需持续读取 SSE，并处理网络超时与代理缓冲  
+- 详见 [流式调用](/docs/guides/streaming)  
+
+### 能否在前端网页直接调用 API？
+
+**不建议。** API Key 会暴露在浏览器中。请由后端服务器持有 Key 并转发请求。
+
+---
+
+## 计费与账单
+
+### 如何计费？
+
+通常按模型的 **输入 token** 与 **输出 token** 单价从余额扣减；部分多模态模型按分辨率或时长分档，以模型广场说明为准。
+
+### 如何对账？
+
+- **使用记录**：按次查看模型、用量与费用  
+- **费用账单**：按月汇总  
+- 企业客户如需定制导出，请 [联系我们](/#contact)  
+
+### 如何开发票？
+
+**财务 → 发票开具**（需实名认证）。按页面选择已结清账单并填写开票信息；具体规则以控制台为准。
+
+### 充值未到账怎么办？
+
+在 **充值明细** 查看订单状态；在线支付可能存在几分钟延迟。长时间未到账请保留订单号并联系客服。
+
+---
+
+## 控制台与产品
+
+### 控制台「开发文档」在哪里？
+
+侧栏 **开发文档**、模型卡片 **接入文档**、底部 **常见问题** 均跳转至官网 **文档中心**（本站 `/docs`）。
+
+### 智能报告和 Agent 技能如何接入？
+
+官网 [智能报告](/reports) 与 [Agent 技能](/agents) 介绍场景与示例；Skill 安装能力持续开放，可关注控制台与官网公告。
+
+### 是否支持私有化部署？
+
+企业方案支持专有云与私有化部署，请通过 [联系我们](/#contact) 获取方案与 POC 安排。
+
+---
+
+## 其他
+
+### 文档有错误或过时怎么办？
+
+文档随产品迭代更新。若与控制台展示不一致，以控制台为准，并欢迎通过客服或 main@haiyushuke.cn 反馈。
+
+### 如何获取技术支持？
+
+- 控制台侧栏 **在线客服**  
+- 官网 [联系我们](/#contact)  
+- 邮件 main@haiyushuke.cn