API 参考

API Reference

星算纪API兼容OpenAI接口规范,可无缝替换base_url使用。以下是核心端点与参数说明。

基础信息

Base URLhttps://api.xingsuanji.com/v1
认证方式Bearer Token
请求格式JSON
响应格式JSON / SSE (Streaming)

Chat Completions

POST /v1/chat/completions — 创建聊天补全

请求参数

参数类型必填说明
modelstring模型ID,如 gpt-4o、claude-3.5-sonnet
messagesarray消息列表,包含 role 和 content
temperaturenumber采样温度 0-2,默认 1
max_tokensinteger最大输出token数
streamboolean是否流式输出,默认 false

请求示例

curl https://api.xingsuanji.com/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "model": "gpt-4o",
    "messages": [
      {"role": "system", "content": "你是一个有帮助的助手。"},
      {"role": "user", "content": "解释什么是AI模型聚合?"}
    ],
    "temperature": 0.7,
    "max_tokens": 500
  }'

响应示例

{
  "id": "chatcmpl-xxx",
  "object": "chat.completion",
  "created": 1735699200,
  "model": "gpt-4o",
  "choices": [{
    "index": 0,
    "message": {
      "role": "assistant",
      "content": "AI模型聚合是指..."
    },
    "finish_reason": "stop"
  }],
  "usage": {
    "prompt_tokens": 25,
    "completion_tokens": 150,
    "total_tokens": 175
  }
}

支持的模型列表

GET /v1/models — 获取可用模型列表

gpt-4o gpt-4-turbo claude-3.5-sonnet claude-3-opus gemini-1.5-pro gemini-1.5-flash qwen-max deepseek-v2

💡 完整文档与SDK使用指南请查看 开发文档

返回首页