端点总览与鉴权

先说域名：渊站有三个入口

这三个地址指向同一套服务，功能、模型、计费完全一样：

https://api.syuan.org
https://ai.syuan.org
https://aiapi.syuan.org

用同一把 Key 分别请求，返回的模型清单是一模一样的。

怎么选：

情况	建议
一般使用	用 https://api.syuan.org（站内配置里写的也是这个）
某个域名访问慢或不稳定	换另一个，它们是独立的线路
在写脚本或配置	固定用其中一个，别来回换

别来回换

配置里一会儿用 A 一会儿用 B，出问题时你会分不清到底是域名的问题还是 Key 的问题。挑一个写好，就够了。

另外几个域名不是 API

域名	是什么
draw.syuan.org	星渊画布，网页生图台
vue.syuan.org	陪伴插件 wiki
status.syuan.org	服务状态页

这三个都不能用来调模型。

有一个域名已经停用了

ai-api.syuan.org（带连字符的那个）已经不通了。如果你在旧教程或旧配置里看到它，换成上面三个之一。

鉴权

所有请求都带同一个头：

Authorization: Bearer sk-你的密钥

没有 Key、Key 写错、Key 被禁用，都会返回 401。

端点一览

用途	方法	路径
聊天补全（OpenAI 兼容）	POST	/v1/chat/completions
文本补全	POST	/v1/completions
Claude 原生消息	POST	/v1/messages
Responses 接口	POST	/v1/responses
Gemini 原生	POST	/v1beta/models/{model}:{action}
图像生成	POST	/v1/images/generations
图像编辑	POST	/v1/images/edits
语音合成	POST	/v1/audio/speech
语音转写	POST	/v1/audio/transcriptions
向量嵌入	POST	/v1/embeddings
重排序	POST	/v1/rerank
模型列表	GET	/v1/models

完整前缀都是 https://api.syuan.org。

每个响应都带 request id

出问题的时候，把下面这一串发给管理员，比描述半天管用：

(request id: 202610311516287031397838268d9d6TtirOo6w)

它在错误响应的 error.message 末尾，成功响应有时在响应头里。

限流

部分分组配了频率限制。触发时返回 429，文中会写清「几分钟内最多请求多少次」。

被限流不代表你被封了，等一会儿就好。具体见报错怎么读。