API 文档

OpenAPI 兼容 · 600+ 模型 · 三协议支持 · 智能路由

v1.0

快速开始

5 分钟接入星枢 API，兼容 OpenAI SDK

注册获取 API 密钥

注册星枢账号，在控制台「API 密钥」页面创建密钥。新用户赠送 ¥5 额度。

注册账号

选择模型 & 发起请求

在模型市场中浏览 600+ 模型，或直接用模型 ID 发起 Chat Completions 请求。

浏览模型

监控用量 & 优化成本

在控制台查看实时用量统计、缓存命中率和消费明细。智能路由自动降本。

控制台

代码示例

兼容 OpenAI SDK，切换 base_url 即可接入

curl https://api.xingshu.ai/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer sk-xingshu-YOUR_KEY" \
  -d '{
    "model": "gpt-4o",
    "messages": [
      {"role": "user", "content": "你好，请用一句话介绍你自己"}
    ],
    "temperature": 0.7,
    "max_tokens": 500
  }'

提示：将 OpenAI SDK 的 base_url 修改为星枢 API 地址，无需改代码即可享受智能路由和多模型切换。

平台特性

智能路由

自动选择最优 provider，故障时自动切换，保障 99.99% 可用性

语义缓存

相似请求自动命中缓存，响应 <50ms，成本节省 50%+

流式输出

支持 SSE 流式响应，首 Token 延迟 <300ms，实时打字效果

统一计费

一把 API Key 调用 600+ 模型，按 Token 计费，用量实时透明

函数调用

兼容 OpenAI Function Calling / Tool Use，支持结构化输出

多协议

OpenAI / Anthropic / Gemini 协议，与现有 SDK 无缝集成

API 端点

方法	路径	说明	认证
POST	`/v1/chat/completions`	对话补全 — 兼容 OpenAI API 格式	Bearer Token
POST	`/v1/embeddings`	文本向量嵌入 — 语义检索、相似度计算	Bearer Token
POST	`/v1/images/generations`	文生图 — DALL-E / SDXL 等模型	Bearer Token
POST	`/v1/audio/transcriptions`	语音转文字 — Whisper 等模型	Bearer Token
GET	`/v1/models`	获取可用模型列表	Bearer Token
GET	`/api/user/profile`	获取用户信息及额度	Bearer Token
GET	`/api/keys`	管理 API 密钥	Bearer Token
GET	`/api/usage/stats`	用量统计与报表	Bearer Token

认证方式

Bearer Token 认证，兼容 OpenAI 格式

HTTP Header 认证

Authorization: Bearer sk-xingshu-YOUR_API_KEY

速率限制

免费套餐

100 请求/分钟

适合个人开发测试

Pro 套餐

3000 请求/分钟

适合小型生产环境

企业版

无限制

专属实例，按需定制