快速开始
本指南对应开放平台常见的「分钟级接入」流程(参见 智谱 · 快速开始 类文档结构),步骤以 海宇数科控制台与网关 为准。
1. 注册并登录控制台
访问 控制台 ,使用手机号注册并登录。
2. 完成实名认证
创建 API Key、使用 体验中心、账户充值 与查看完整 财务 信息前,需完成实名认证:
- 侧栏 账户中心 → 实名认证
- 按页面指引提交个人或企业认证材料
- 认证通过后,上述功能即可正常使用
企业用户若需 对公转账充值,须完成 企业认证。
3. 配置开发环境(可选)
在集成代码的机器上设置环境变量,避免硬编码 Key:
export HAIYUSHUKE_API_KEY="你的密钥"
export HAIYUSHUKE_BASE_URL="https://api.haiyushuke.com/v1"SDK 安装:
# Node.js
npm install openai
# Python
pip install openai详见 OpenAI SDK 兼容。
4. 为账户充值(可选)
预付费环境下,请进入 财务 → 账户充值 完成充值后再调用 API。
5. 创建 API Key
- 侧栏 API Key → 创建
- 填写名称(如
dev-backend) - 可选:可用模型、额度、过期时间、IP 白名单
- 立即复制并保存 完整密钥(仅展示一次)
6. 选择模型 ID
在控制台 模型广场 确认 model ID;也可在 体验中心 试调用后再写入代码。IDE 配置见 工具接入概览。
7. 发起测试请求
HTTP(curl):
curl https://api.haiyushuke.com/v1/chat/completions \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "deepseek-chat",
"messages": [{"role": "user", "content": "你好,请用一句话介绍海宇数科"}]
}'成功时 JSON 含 choices[0].message.content 与 usage。接口细节见 HTTP API。
8. 核对用量
在 财务 → 使用记录 查看 token 与费用;理解 Token 含义见 核心概念。
下一步
| 目标 | 文档 |
|---|---|
| 用 SDK 接入 | OpenAI SDK 兼容 |
| 流式 UI | 流式调用 |
| 配置 IDE | Cursor、Claude Code 等 |
| 运维与计费 | API Key、计费与财务 |
| 排错 | 常见问题 |
