haiyushuke-website/content/faq.mdx

---
title: 常见问题
description: 接入、账号、计费与错误排查
---

# 常见问题

## 账号与实名认证

### 为什么无法创建 API Key 或充值？

创建 API Key、使用体验中心、充值与查看完整财务信息前，需先在 **账户中心 → 实名认证** 完成认证。若页面提示「请先完成实名认证」，按指引提交材料即可。

### 个人认证和企业认证有什么区别？

- **个人认证**：满足个人开发者试调用、在线充值与 API 接入。
- **企业认证**：满足企业对公结算、发票与合规要求；**对公转账充值** 仅企业认证用户可用。

### 实名核验次数有限制吗？

个人/企业/法人相关核验接口有 **每日次数上限**（如单日 10 次）。若提示「今日核验次数已达上限」，请次日再试或联系客服。

### 如何修改登录密码？

**账户中心 → 账号设置** 中通过手机号验证修改密码；忘记密码可在登录页使用 **忘记密码** 流程。

---

## 接入与 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