API 参考
API Reference
星算纪API兼容OpenAI接口规范,可无缝替换base_url使用。以下是核心端点与参数说明。
基础信息
Base URL
https://api.xingsuanji.com/v1认证方式Bearer Token
请求格式JSON
响应格式JSON / SSE (Streaming)
Chat Completions
POST /v1/chat/completions — 创建聊天补全
请求参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| model | string | 是 | 模型ID,如 gpt-4o、claude-3.5-sonnet |
| messages | array | 是 | 消息列表,包含 role 和 content |
| temperature | number | 否 | 采样温度 0-2,默认 1 |
| max_tokens | integer | 否 | 最大输出token数 |
| stream | boolean | 否 | 是否流式输出,默认 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使用指南请查看 开发文档。