快速开始
五分钟接入算力宝的模型算力:创建 API Key → 跑通第一次调用 → 查看用量 → 接入生产。
一、准备账号与算力
- 注册并登录 算力宝,进入控制台。
- 充值算粒。算粒是本站唯一的计价单位,1 元 = 1,000,000 算粒,算粒永不过期。
- (可选)如果某个模型你调用量很大,可以购买模型权益套餐:包期内该模型调用免扣算粒。
二、创建 API Key
进入控制台的「API 密钥」,创建一枚密钥。密钥只在创建时完整展示一次,请妥善保存。
调用模型接口时用的是这枚 API Key,不是网站登录令牌:
export SLB_API_KEY="sk-xxxxxxxxxxxxxxxx"
三、跑通第一次调用
接入地址是一个完整端点,请求体需要带 stream 与 stream_options.include_usage:
curl -X POST https://www.hgzscloud.fun/admin-api/ai/chat/completions \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $SLB_API_KEY" \
-d '{
"model": "qwen3.7-flash",
"messages": [
{ "role": "user", "content": "用一句话介绍你自己" }
],
"stream": true,
"stream_options": { "include_usage": true }
}'
用 Python(原生 HTTP 流式请求):
import httpx, json
API_KEY = "sk-xxxxxxxxxxxxxxxx"
ENDPOINT = "https://www.hgzscloud.fun/admin-api/ai/chat/completions"
with httpx.stream(
"POST",
ENDPOINT,
headers={
"Authorization": "Bearer " + API_KEY,
"Content-Type": "application/json",
},
json={
"model": "qwen3.7-flash",
"messages": [{"role": "user", "content": "用一句话介绍你自己"}],
"stream": True,
"stream_options": {"include_usage": True},
},
) as response:
for line in response.iter_lines():
if not line or not line.startswith("data: "):
continue
data = line[len("data: "):]
if data == "[DONE]":
break
chunk = json.loads(data)
for choice in chunk.get("choices", []):
print(choice.get("delta", {}).get("content", ""), end="")
用 Node.js(原生 fetch 流式请求):
const response = await fetch("https://www.hgzscloud.fun/admin-api/ai/chat/completions", {
method: "POST",
headers: {
"Content-Type": "application/json",
Authorization: "Bearer " + process.env.SLB_API_KEY,
},
body: JSON.stringify({
model: "qwen3.7-flash",
messages: [{ role: "user", content: "用一句话介绍你自己" }],
stream: true,
stream_options: { include_usage: true },
}),
});
const reader = response.body.getReader();
const decoder = new TextDecoder();
let buffer = "";
while (true) {
const { done, value } = await reader.read();
if (done) break;
buffer += decoder.decode(value, { stream: true });
const lines = buffer.split("\n");
buffer = lines.pop() || "";
for (const line of lines) {
if (!line.startsWith("data: ")) continue;
const data = line.slice(6);
if (data === "[DONE]") break;
const chunk = JSON.parse(data);
for (const choice of chunk.choices || []) {
process.stdout.write(choice.delta && choice.delta.content ? choice.delta.content : "");
}
}
}
用 OpenAI 官方 SDK 时注意:SDK 固定拼接{base_url}/chat/completions,与本站端点不一致会 404。 需要把 base_url 设为https://www.hgzscloud.fun/admin-api并覆写请求路径为/ai/chat/completions, 请求体同样要带stream与stream_options.include_usage。
四、查看用量
控制台的「用量统计」可以按时间、模型、密钥查看每一次调用的:
- 输入 / 输出 token 数
- 真实算粒消耗(命中权益套餐的调用为 0)
- 计费来源(按量计费 / 套餐权益)
- 若按量计费,这笔调用等价于多少人民币
五、接入生产
- 密钥支持设置有效期与禁用,怀疑泄露时先禁用再换新。
- 建议为不同业务线创建不同密钥,用量才能分开统计。
- 模型单价按「算粒 / 千 Token」标价,调价以模型广场展示为准,历史账单不受影响。