1. 快速开始

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

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

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

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

2. 一键配置工具

一键配置工具适合不熟悉命令行的用户使用，可以帮助你更快完成 Claude Code 和 Codex CLI 的常见配置。

2.1 支持能力

2.2 下载地址

2.3 相关链接

• 工具说明文档：https://docs.ycstar.xyz
• 小店链接（兑换码购买 / 余额充值）：https://pay.ldxp.cn/shop/APEK55BM

2.4 遇到问题怎么办

如果你在使用中遇到配置失败、余额异常、Claude Code / Codex CLI 无法使用等问题，请联系群主或管理员。

3. 环境检查

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

3.1 准备平台令牌

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

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

3.2 验证网络连通性

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

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

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

4. OpenAI 兼容 SDK

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

4.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)

4.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": "你好，请返回一句接入成功提示。"
      }
    ]
  }'

4.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);

5. Codex / 兼容工具接入

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

5.1 临时环境变量

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

5.2 配置建议

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

6. 高速号池说明

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

7. 额度与用量

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

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

8. 常见问题

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

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

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

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

© 星枢 AI 用户接入指南。页面样式参考独立文档站布局，内容按当前 OpenAI 高速中转定位改写。