开放API - 星枢AI | StarPivot.ai

01快速开始

三步接入：注册账号 → 创建 API Key → 调用接口。全程兼容 OpenAI SDK，无需额外学习成本。

# 基础地址
export BASE_URL="https://api.starpivot.ai/v1"
export API_KEY="sk-你的密钥"

支持的 SDK 与框架：OpenAI Python / Node SDK、Anthropic SDK、Gemini SDK、LangChain、Dify、ChatGPT-Next-Web、LobeChat 等，只需修改 base_url 即可。

02身份鉴权

所有请求需在 Header 中携带 API Key：

Authorization: Bearer sk-xxxxxxxxxxxxxxxxxxxx

参数	位置	必填	说明
Authorization	Header	是	格式：Bearer + 空格 + API Key
Content-Type	Header	是	application/json

密钥请妥善保管，仅在后端环境使用，勿提交到前端代码或公开仓库。

03对话接口 (OpenAI 兼容)

POST /v1/chat/completions —— 兼容 OpenAI 全部参数，支持流式输出。

# curl 示例
curl https://api.starpivot.ai/v1/chat/completions \
  -H "Authorization: Bearer sk-你的密钥" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.6",
    "messages": [{"role": "user", "content": "你好！"}],
    "stream": true
  }'

# Python 示例
from openai import OpenAI

client = OpenAI(
    base_url="https://api.starpivot.ai/v1",
    api_key="sk-你的密钥",
)

resp = client.chat.completions.create(
    model="claude-sonnet-5",
    messages=[{"role": "user", "content": "讲个笑话"}],
)
print(resp.choices[0].message.content)

参数	类型	说明
model	string	模型标识，见大模型广场
messages	array	对话消息列表 (role / content)
stream	boolean	是否流式输出，默认 false
temperature	number	采样温度 0~2，默认 1
max_tokens	integer	最大生成长度

04图像生成接口

POST /v1/images/generations —— 支持文生图、图生图。

# 文生图示例
curl https://api.starpivot.ai/v1/images/generations \
  -H "Authorization: Bearer sk-你的密钥" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "一只戴着宇航员头盔的橘猫，赛博朋克风格",
    "size": "1024x1024"
  }'

返回 JSON 中的 url 字段为生成的图片地址；视频生成使用 /v1/videos/generations，音乐使用 /v1/audio/music，语音合成使用 /v1/audio/speech。

05通用规范

项目	说明
Base URL	https://api.starpivot.ai/v1
兼容协议	OpenAI / Anthropic / Gemini
流式输出	SSE (text/event-stream)
错误码	401 密钥无效 · 429 限流 · 500 服务异常
超时限制	对话 300s · 图像 120s · 视频 600s

06计费价格

积分按次计费：1 元 = 1000 积分，新用户注册即送 1000 积分体验金。

模型	每次调用
Claude Sonnet 5 / Codex	150 积分
Claude Opus 4.8 / Gemini 3 Pro SVIP	200 积分
GPT 5.5 特价 / Kimi K3 / GLM 5.2	80 / 60 积分
NanoBanana Pro / GPT Image 2	300 积分
Seedance 2.0 / Sora 2 / Grok Imagine 视频	1000 积分

07常见问题

Q: 可以商用吗？	可以。所有模型均支持商业用途，需遵守模型厂商的服务条款。
Q: 余额会过期吗？	不会。充值余额长期有效，仅消耗时扣减。
Q: 支持并发吗？	支持。默认 10 并发，企业版可提升至 100+。
Q: 模型列表在哪查？	调用 GET /v1/models 或查看「大模型广场」页面。
Q: 如何对接我的应用？	将应用的 Base URL 改为上述地址并填入 Key 即可，兼容 ChatGPT-Next-Web、LobeChat、Dify、LangChain 等。

开放 API 文档