API SERVICE PLATFORM

API 服务平台 使用手册

100% 兼容 OpenAI 格式，支持 Cherry Studio、OpenClaw、NextChat、LobeChat 等全主流 AI 客户端，创建令牌 → 配置客户端 → 调用模型三步即可使用。

进入控制台 创建令牌

支持模型

GPT
系列
Claude
Anthropic
GLM
智谱
Qwen
通义
DeepSeek
深度
更多
全量
1

平台概览

PLATFORM OVERVIEW

天鸿智算平台提供统一大模型调用网关，支持多模型统一管理、额度控制、IP 限制、模型权限隔离。只需三步即可开始使用：

1

创建令牌

获取 sk- 开头 API Key

2

配置客户端

填入 API 地址和密钥

3

调用模型

直接对话或代码调用

支持模型：GPT 系列、Claude、GLM、通义千问、DeepSeek 等全平台上架模型。平台地址：https://api.thhtcloud.com

2

创建令牌

CREATE API KEY

1 进入令牌管理

①

登录天鸿智算控制台：https://api.thhtcloud.com

②

左侧导航栏：令牌管理

③

点击右上角：添加令牌

2 填写令牌配置

配置项 填写说明 推荐设置
令牌名称 自定义标识 客户端专用、OpenClaw、CherryStudio
令牌分组 用户分组 默认即可
过期时间 令牌有效期 测试：永不过期；生产：按需设置
额度上限 调用额度 测试可设无限额度
模型限制 允许调用模型 留空 = 全部可用；指定模型可防超额
IP 白名单 访问 IP 限制 生产环境建议开启，一行一个 IP

3 保存密钥

提交后生成sk- 开头令牌，仅显示一次，务必立即复制保存！令牌列表可查看剩余额度、状态、创建时间。

3

全局调用地址

API ENDPOINTS

API 基础地址
https://api.thhtcloud.com/v1
聊天接口
/v1/chat/completions
模型列表
/v1/models
嵌入接口
/v1/embeddings

以上地址所有客户端通用，API 地址必须带 /v1，不要遗漏。

4

客户端配置教程

CLIENT CONFIGURATION

Cherry Studio
OpenClaw
通用客户端

Cherry Studio

桌面客户端，最常用

Cherry Studio 完美适配 NEW-API，支持一键接入天鸿智算全量模型。

1

打开 Cherry Studio，进入左侧设置 → 模型服务

2

拉到最下方，点击添加服务商

3

服务商类型选择：OpenAI / New-API

4

填写配置：

• API 地址：https://api.thhtcloud.com/v1

• API 密钥：你的sk- 开头令牌

• 备注：天鸿智算

5

开启右上角启用开关，点击自动获取模型，一键加载所有可用模型

6

回到对话页面，切换模型即可直接调用

API 地址必须带 /v1，不要遗漏；自动获取失败可手动输入模型 ID（如 gpt-3.5-turbo、glm-4、claude-3.5-sonnet）

OpenClaw

AI 智能体 / Agent 框架

OpenClaw 支持命令行 + 配置文件两种方式接入，两种配置方式任选其一。

A 命令行交互式配置（新手推荐）

①

终端输入启动配置向导：openclaw onboard

②

模型提供商选择：Custom Provider（自定义 OpenAI 兼容接口）

③

API Base URL：https://api.thhtcloud.com/v1

④

密钥输入方式：选择Paste API key now，粘贴你的 sk- 令牌

⑤

端点兼容类型：openai-completions

⑥

Model ID：推荐 glm-4.7、deepseek-chat-fast、gpt-4o-mini

Bash - 验证配置 复制
# 查看可用模型 openclaw models list --plain # 实时探测连通性 openclaw models status --probe

B 配置文件 JSON（高级自定义）

编辑 OpenClaw 配置文件 ~/.openclaw/openclaw.config.json：

JSON - 配置文件 复制
{ "providers": { "thhtcloud": { "base_url": "https://api.thhtcloud.com/v1", "api_key": "sk-你的令牌密钥", "api": "openai-completions" } }, "agents": { "defaults": { "model": { "primary": "thhtcloud/glm-4.7" } } } }

保存后重启网关：

Bash 复制
openclaw gateway restart

通用客户端

NextChat / LobeChat / 浏览器插件

1

打开客户端设置 → OpenAI 兼容接口

2

API 地址：https://api.thhtcloud.com/v1

3

API Key：你的 sk- 令牌

4

模型选择平台支持 ID，保存即可使用

5

代码调用示例

CODE EXAMPLES

CURL 快速调用

Bash 复制
curl https://api.thhtcloud.com/v1/chat/completions \ -H "Content-Type: application/json" \ -H "Authorization: Bearer sk-xxxxxxxxxxxxxxxx" \ -d '{ "model": "glm-4.7", "messages": [{"role": "user", "content": "你好，天鸿智算"}] }'

Python OpenAI SDK

Python 复制
from openai import OpenAI client = OpenAI( api_key="sk-你的令牌", base_url="https://api.thhtcloud.com/v1" ) resp = client.chat.completions.create( model="deepseek-chat-fast", messages=[{"role": "user", "content": "写一段AI智能体提示词"}] ) print(resp.choices[0].message.content)
6

令牌安全与管理

TOKEN SECURITY

不要泄露令牌

令牌不要明文上传代码仓库、公网，避免泄露

开启 IP 白名单

生产环境务必开启IP 白名单，限制访问来源

按用途分开创建

客户端专用、Agent 专用、开发测试专用，分开管理

定期轮换令牌

定期轮换令牌，废弃令牌及时删除

额度管理

额度不足可在控制台充值或调整令牌额度上限

7

常见问题排查

FAQ & TROUBLESHOOTING

401 未授权
令牌错误、过期、未启用，核对 sk 密钥是否正确复制，检查令牌状态是否为启用。
404 接口不存在
API 地址遗漏 /v1，必须填写完整地址 https://api.thhtcloud.com/v1
模型不可用
令牌限制模型，或平台未上架该模型，在令牌管理取消模型限制或更换可用模型 ID。
OpenClaw 探测失败
关闭网络代理，核对 base_url 和密钥，确认模型 ID 正确（如 glm-4.7、deepseek-chat-fast）。
Cherry Studio 获取模型失败
手动输入模型 ID（如 gpt-3.5-turbo、glm-4、claude-3.5-sonnet），重启客户端后重试。

立即开始使用天鸿智算 API

创建令牌、配置客户端、调用模型，三步即可接入全量大模型

进入控制台 算力云服务