星枢 AI 用户接入指南

Access Guide

接入星枢 AI 平台

本指南仿照独立文档站的版式编写，覆盖 OpenAI 中转接入、环境检查、SDK 示例、高速号池说明和常见问题排查。

1. 快速开始

开始前，请先准备好以下信息：

平台访问地址：https://pro.ycstar.xyz/
OpenAI 兼容 Base URL：https://pro.ycstar.xyz/v1
一个可用的 API 令牌
推荐先调用 /v1/models 验证令牌和网络是否可用

如果你还没有 API 令牌，请先在平台控制台完成以下操作：

登录星枢 AI 控制台
进入“令牌管理”
新建一个令牌
复制生成后的密钥并妥善保存

平台信息

OpenAI 兼容工具与 SDK 的 Base URL：https://pro.ycstar.xyz/v1

推荐认证方式：Authorization: Bearer <你的令牌>

当前文档只围绕已接入的 OpenAI 能力说明，模型名称和可用额度以控制台实际配置为准。

2. 环境检查

正式接入前，建议先完成下面这些基础检查。只要能成功获取模型列表，后续 SDK 或业务服务接入就会顺很多。

2.1 准备平台令牌

请确认你已经在平台控制台创建好了 API Key，并能随时复制出来使用。

平台地址：https://pro.ycstar.xyz/
Base URL：https://pro.ycstar.xyz/v1

2.2 验证网络连通性

建议先执行一次接口测试，确认当前网络可以访问平台：

curl https://pro.ycstar.xyz/v1/models \
  -H "Authorization: Bearer YOUR_API_KEY"

如果能正常返回模型列表，说明网络和令牌都没有问题，可以继续配置 SDK 或业务服务。

3. OpenAI 兼容 SDK

如果你使用 OpenAI 官方 SDK 或 OpenAI 兼容工具，只需要替换 base_url 和 api_key。示例里的 MODEL_NAME 请替换为控制台模型列表里实际可用的模型。

3.1 Python 示例

from openai import OpenAI

client = OpenAI(
    api_key="YOUR_API_KEY",
    base_url="https://pro.ycstar.xyz/v1",
)

resp = client.chat.completions.create(
    model="MODEL_NAME",
    messages=[
        {"role": "user", "content": "请用一句话说明星枢 AI 已接入成功。"}
    ],
)

print(resp.choices[0].message.content)

3.2 curl 示例

curl https://pro.ycstar.xyz/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "model": "MODEL_NAME",
    "messages": [
      {
        "role": "user",
        "content": "你好，请返回一句接入成功提示。"
      }
    ]
  }'

3.3 JavaScript / TypeScript 示例

const response = await fetch("https://pro.ycstar.xyz/v1/chat/completions", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    Authorization: "Bearer YOUR_API_KEY",
  },
  body: JSON.stringify({
    model: "MODEL_NAME",
    messages: [
      {
        role: "user",
        content: "请返回一句接入成功提示。",
      },
    ],
  }),
});

const data = await response.json();
console.log(data.choices?.[0]?.message?.content);

4. Codex / 兼容工具接入

支持 OpenAI 兼容地址的开发工具，通常只需要配置 API Key 与 Base URL。不同工具的配置字段名称可能不同，但核心信息一致。

API Key 填入星枢 AI 控制台生成的令牌。

Base URL 填入 https://pro.ycstar.xyz/v1。

4.1 临时环境变量

export OPENAI_API_KEY="YOUR_API_KEY"
export OPENAI_BASE_URL="https://pro.ycstar.xyz/v1"

4.2 配置建议

生产环境和测试环境建议使用不同令牌
不要把 API Key 写入前端页面或公开仓库
模型名称请以 /v1/models 返回结果为准
如果工具不支持自定义 Base URL，可以优先使用 SDK 或 HTTP 接口接入

5. 高速号池说明

星枢 AI 的核心卖点是高速号池调度。平台强调 TEAM、PLUS、PRO 高质量资源，减少低质量资源带来的排队、失败和速度波动。

TEAM 团队级号池 适合稳定业务接入，强调持续可用、项目隔离和团队共享。

PLUS 高频可用 面向日常高频调用，响应速度更轻快，适合产品和脚本长期运行。

PRO 优先能力 优先调度高规格资源，适合对速度、失败率和响应体验敏感的任务。

接入方式不变

号池不会改变 OpenAI 兼容接口的调用方式。你仍然只需要替换 Base URL 与 API Key，具体可用模型、额度和速率以控制台实际配置为准。

6. 额度与用量

用量和额度以平台控制台展示为准。建议为不同项目创建不同 API Key，方便区分调用来源、成本和异常日志。

为生产环境和测试环境分别创建令牌
给不同业务线配置不同令牌，方便统计消耗
发现 Key 泄露后立即删除旧 Key 并重新创建
调用失败时先查看控制台调用日志

7. 常见问题

401 Unauthorized / Invalid token

API 令牌是否复制完整
是否正确携带 Authorization: Bearer YOUR_API_KEY
令牌是否已过期、被禁用或额度耗尽

404 Not Found

确认 Base URL 末尾是否为 /v1
确认路径是否为 /v1/chat/completions、/v1/responses 或其他有效接口

429 Too Many Requests

降低请求并发
加入指数退避重试
联系平台管理员确认限流策略

返回“模型不存在”或“无权限”

模型名拼写错误
当前令牌没有该模型调用权限
后端暂未给你的分组分配该模型

接入建议

推荐顺序是：先测试 /v1/models，再验证 /v1/chat/completions 或 /v1/responses，最后接入业务 SDK。