129 lines
4.5 KiB
Plaintext
129 lines
4.5 KiB
Plaintext
---
|
||
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
|