← 返回 New API

New API 用户接入指南

本指南面向普通用户，介绍如何注册、创建个人 API 令牌，并在兼容 OpenAI API 的应用中使用本站服务。

API Base URL：https://ai.starxcs.cn/v1
接口格式：兼容 OpenAI Chat Completions 等常用接口

1. 注册并登录

打开注册页面创建账号；已有账号可直接登录。
登录后进入“控制台”，打开“令牌管理”。
点击创建令牌，填写备注并保存。令牌通常只会完整显示一次，请立即复制并妥善保管。

2. 配置客户端

在支持 OpenAI 兼容接口的应用中填写以下信息：

Base URL：https://ai.starxcs.cn/v1
API Key：你在“令牌管理”中创建的个人令牌
Model：选择平台提供的可用模型

3. 使用 cURL

curl https://ai.starxcs.cn/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{"model":"YOUR_MODEL","messages":[{"role":"user","content":"你好"}]}'

4. Python（OpenAI SDK）

from openai import OpenAI
client = OpenAI(api_key="YOUR_API_KEY", base_url="https://ai.starxcs.cn/v1")
result = client.chat.completions.create(
    model="YOUR_MODEL",
    messages=[{"role": "user", "content": "你好"}],
)
print(result.choices[0].message.content)

5. JavaScript

const response = await fetch("https://ai.starxcs.cn/v1/chat/completions", {
  method: "POST",
  headers: {"Content-Type":"application/json", "Authorization":"Bearer YOUR_API_KEY"},
  body: JSON.stringify({model:"YOUR_MODEL", messages:[{role:"user",content:"你好"}]})
});
console.log(await response.json());

6. 常见问题

401 未授权：检查 API Key 是否正确，并确认请求头包含 Bearer 前缀。
模型不可用：更换为控制台中显示的可用模型，或联系平台管理员。
余额或额度不足：查看个人账户余额和使用额度。
请求超时：检查网络连接并稍后重试。

7. 安全提示

不要把 API Key 提交到代码仓库、截图或公开网页。
如果令牌泄露，请立即在“令牌管理”中删除并重新创建。
建议通过环境变量保存密钥，例如 OPENAI_API_KEY。

如需帮助，请联系平台管理员。