快速开始

本指南对应开放平台常见的「分钟级接入」流程(参见 智谱 · 快速开始  类文档结构),步骤以 海宇数科控制台与网关 为准。

1. 注册并登录控制台

访问 控制台 ,使用手机号注册并登录。

2. 完成实名认证

创建 API Key、使用 体验中心账户充值 与查看完整 财务 信息前,需完成实名认证:

  1. 侧栏 账户中心 → 实名认证
  2. 按页面指引提交个人或企业认证材料
  3. 认证通过后,上述功能即可正常使用

企业用户若需 对公转账充值,须完成 企业认证

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

  1. 侧栏 API Key创建
  2. 填写名称(如 dev-backend
  3. 可选:可用模型、额度、过期时间、IP 白名单
  4. 立即复制并保存 完整密钥(仅展示一次)

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.contentusage。接口细节见 HTTP API

8. 核对用量

财务 → 使用记录 查看 token 与费用;理解 Token 含义见 核心概念

下一步

目标文档
用 SDK 接入OpenAI SDK 兼容
流式 UI流式调用
配置 IDECursorClaude Code
运维与计费API Key计费与财务
排错常见问题