快速开始

本页带你从零发出第一个请求:创建 API Key → 找到接入地址 → 用官方 SDK 调用。

1. 创建 API Key

1. 登录 星算 控制台。
2. 左侧导航选择「API 密钥」。
3. 点击右上角「创建密钥」,填写名称(可选填模型范围、额度上限、过期时间、IP 白名单)。
4. 创建成功后弹窗会一次性显示密钥明文,形如 xsk_xxxxxxxx...,立即复制并妥善保存。

密钥即密码

虽然可以在密钥详情页重新查看明文,但请像对待密码一样保管它。一旦泄露,请在「API 密钥」页立即撤销并重建。

Key 格式:固定前缀 xsk_ + 32 字节 base64url 随机串,合计约 47 个字符。

2. 接入地址

你的接入地址:https://xingsuan.cloud

下方代码示例用变量 API_BASE 表示该地址,请替换为上方显示的值。

提前把 Key 放进环境变量

为避免把密钥写进代码,示例中用 $XSK_KEY(curl)或 process.env.XSK_KEY(Node)读取。请先在终端执行:

export XSK_KEY=xsk_你的密钥

3. 发出第一个请求

以 OpenAI 兼容接口 POST /v1/chat/completions 为例。下面三段等价,任选一种。

curl

API_BASE=https://xingsuan.cloud   # 替换为你的接入地址
curl "$API_BASE/v1/chat/completions" \
  -H "Authorization: Bearer $XSK_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-4o-mini",
    "messages": [{"role": "user", "content": "用一句话介绍你自己"}]
  }'

Python

from openai import OpenAI

client = OpenAI(
    base_url="https://xingsuan.cloud/v1",  # 你的接入地址 + /v1
    api_key="xsk_...",                        # 你的 API Key
)

resp = client.chat.completions.create(
    model="gpt-4o-mini",
    messages=[{"role": "user", "content": "用一句话介绍你自己"}],
)
print(resp.choices[0].message.content)

Node.js

import OpenAI from "openai"

const client = new OpenAI({
  baseURL: "https://xingsuan.cloud/v1",  // 你的接入地址 + /v1
  apiKey: process.env.XSK_KEY,
})

const resp = await client.chat.completions.create({
  model: "gpt-4o-mini",
  messages: [{ role: "user", content: "用一句话介绍你自己" }],
})
console.log(resp.choices[0].message.content)

成功后你会收到与 OpenAI 官方格式完全一致的响应(choices / usage 等字段原样透传)。

4. 下一步

• 换个协议试试:Anthropic Messages、Gemini、Seedance
• 鉴权细节:三种鉴权头与各家 SDK 对照
• 错误码:平台错误码与各协议错误信封
• 可用模型