快速接入指南
本指南将引导您完成天鸿智算大模型 API 的接入：从注册账号、获取 API Key，到发起第一次成功调用，整个流程通常只需 5 分钟。
第一步：注册并实名认证
访问 https://api.thhtcloud.com/，使用手机号注册账号并完成实名认证后，即可进入控制台。
新用户完成实名认证后，可在控制台领取免费体验额度，用于测试 API。
第二步：创建并保存 API Key
在控制台 API Key 管理 页面，点击「创建 API Key」按钮，根据提示输入名称（建议按用途命名，例如 dev-test、prod-app），即可生成一条以 sk- 开头的字符串。
API Key 仅在创建时完整展示一次，请妥善保存。一旦泄露请立即在控制台禁用旧 Key 并重新生成。
第三步：选择 API 端点
天鸿智算 API 兼容 OpenAI 协议，您可以使用现有的 OpenAI SDK 或任何 HTTP 客户端调用，仅需替换 base_url 与 api_key。
| 项目 | 值 |
|---|---|
| API Base URL | https://api.thhtcloud.com/v1 |
| 认证方式 | 请求头 Authorization: Bearer <YOUR_API_KEY> |
| 请求格式 | JSON（Content-Type: application/json） |
第四步：发起第一次调用
下面以最常用的对话补全（Chat Completions）接口为例，演示三种主流语言的调用方式。
1. cURL
curl https://api.thhtcloud.com/v1/chat/completions \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $YOUR_API_KEY" \
-d '{
"model": "deepseek-ai/DeepSeek-V3",
"messages": [
{"role": "user", "content": "你好，请简单介绍一下你自己"}
]
}'2. Python（OpenAI SDK）
from openai import OpenAI
client = OpenAI(
base_url="https://api.thhtcloud.com/v1",
api_key="YOUR_API_KEY",
)
resp = client.chat.completions.create(
model="deepseek-ai/DeepSeek-V3",
messages=[{"role": "user", "content": "你好"}],
)
print(resp.choices[0].message.content)3. Node.js（OpenAI SDK）
import OpenAI from "openai";
const client = new OpenAI({
baseURL: "https://api.thhtcloud.com/v1",
apiKey: process.env.YOUR_API_KEY,
});
const resp = await client.chat.completions.create({
model: "deepseek-ai/DeepSeek-V3",
messages: [{ role: "user", content: "你好" }],
});
console.log(resp.choices[0].message.content);调用成功后会返回 JSON 响应，
choices[0].message.content 即为模型回答。如果返回 401，请检查 API Key 是否正确填写并附带 Bearer 前缀。