#常见问题

#账号与实名认证

#为什么无法创建 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 兼容 与 核心概念 · Token。

#返回 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，并处理网络超时与代理缓冲
• 详见 流式调用

#能否在前端网页直接调用 API？

不建议。 API Key 会暴露在浏览器中。请由后端服务器持有 Key 并转发请求。

#计费与账单

#如何计费？

通常按模型的 输入 token 与 输出 token 单价从余额扣减；部分多模态模型按分辨率或时长分档，以模型广场说明为准。

#如何对账？

• 使用记录：按次查看模型、用量与费用
• 费用账单：按月汇总
• 企业客户如需定制导出，请 联系我们

#如何开发票？

财务 → 发票开具（需实名认证）。按页面选择已结清账单并填写开票信息；具体规则以控制台为准。

#充值未到账怎么办？

在 充值明细 查看订单状态；在线支付可能存在几分钟延迟。长时间未到账请保留订单号并联系客服。

#控制台与产品

#控制台「开发文档」在哪里？

侧栏 开发文档、模型卡片 接入文档、底部 常见问题 均跳转至官网 文档中心（本站 /docs）。

#智能报告和 Agent 技能如何接入？

官网 智能报告 与 Agent 技能 介绍场景与示例；Skill 安装能力持续开放，可关注控制台与官网公告。

#是否支持私有化部署？

企业方案支持专有云与私有化部署，请通过 联系我们 获取方案与 POC 安排。

#其他

#文档有错误或过时怎么办？

文档随产品迭代更新。若与控制台展示不一致，以控制台为准，并欢迎通过客服或 main@haiyushuke.cn 反馈。

#如何获取技术支持？

• 控制台侧栏 在线客服
• 官网 联系我们
• 邮件 main@haiyushuke.cn