---
title: 快速开始
description: 注册、环境配置、API Key 与首次调用
---

# 快速开始

本指南对应开放平台常见的「分钟级接入」流程（参见 [智谱 · 快速开始](https://docs.bigmodel.cn/cn/guide/start/introduction) 类文档结构），步骤以 **海宇数科控制台与网关** 为准。

## 1. 注册并登录控制台

访问 [控制台](https://console.haiyushuke.com)，使用手机号注册并登录。

## 2. 完成实名认证

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

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

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

## 3. 配置开发环境（可选）

在集成代码的机器上设置环境变量，避免硬编码 Key：

```bash
export HAIYUSHUKE_API_KEY="你的密钥"
export HAIYUSHUKE_BASE_URL="https://api.haiyushuke.com/v1"
```

SDK 安装：

```bash
# Node.js
npm install openai

# Python
pip install openai
```

详见 [OpenAI SDK 兼容](/docs/guides/openai_compatible)。

## 4. 为账户充值（可选）

预付费环境下，请进入 **财务 → 账户充值** 完成充值后再调用 API。

## 5. 创建 API Key

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

## 6. 选择模型 ID

在控制台 **模型广场** 确认 `model` ID；也可在 **体验中心** 试调用后再写入代码。IDE 配置见 [工具接入概览](/docs/integrations/overview)。

## 7. 发起测试请求

**HTTP（curl）：**

```bash
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](/docs/guides/http_api)。

## 8. 核对用量

在 **财务 → 使用记录** 查看 token 与费用；理解 **Token** 含义见 [核心概念](/docs/concepts/overview)。

## 下一步

| 目标 | 文档 |
| --- | --- |
| 用 SDK 接入 | [OpenAI SDK 兼容](/docs/guides/openai_compatible) |
| 流式 UI | [流式调用](/docs/guides/streaming) |
| 配置 IDE | [Cursor](/docs/integrations/cursor)、[Claude Code](/docs/integrations/claude_code) 等 |
| 运维与计费 | [API Key](/docs/guides/api_keys)、[计费与财务](/docs/guides/billing) |
| 排错 | [常见问题](/docs/faq) |
