星渊 API 指南

外观

语言模型 ​

渊站同时提供三种协议的语言模型接口，按你手头的客户端挑一种。

一、OpenAI 兼容（最常用） ​

POST /v1/chat/completions

bash
curl https://api.syuan.org/v1/chat/completions \
  -H "Authorization: Bearer sk-你的密钥" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-v4.1-flash",
    "messages": [
      {"role": "system", "content": "你是一个温柔的人。"},
      {"role": "user", "content": "今天有点累"}
    ],
    "temperature": 0.8,
    "stream": true
  }'

常用参数：

参数说明
model模型 ID，必须是站里有的
messagessystem / user / assistant 三种角色
streamtrue 为流式返回，客户端打字机效果靠它
temperature0~2，越高越发散
max_tokens单次最大输出

二、Claude 原生消息接口 ​

POST /v1/messages

适合直接用 Anthropic 协议的客户端。它和 OpenAI 协议的请求体不一样，别混着抄：

bash
curl https://api.syuan.org/v1/messages \
  -H "x-api-key: sk-你的密钥" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-5",
    "max_tokens": 1024,
    "messages": [{"role": "user", "content": "在吗"}]
  }'

鉴权头的差异

Claude 协议除了 Authorization: Bearer，也接受 x-api-key。用哪个都行，但别两个都不带。

三、Responses 接口 ​

POST /v1/responses

OpenAI 新一代接口，部分新客户端（以及 Codex 类工具）默认走这条。请求体形如：

json
{
  "model": "gpt-5.5",
  "input": "你好",
  "stream": false
}

该用哪个模型 ​

按用途大致分：

用途去看的分组
日常对话、陪伴CN、Gemini、Plus
写代码Pro 系列、Plus、官key组
长文与细腻语气Claude、Kiro 系列
便宜量大的批处理Free、CN

具体模型名和分组区别在模型与分组。