文本生成模型

SilvaMux 支持多种厂商协议兼容入口,也提供一个可选的统一入口。新项目建议按照目标模型支持的厂商协议接入;使用 OpenAI SDK 的项目默认选择 OpenAI Chat Completions 兼容入口。

厂商协议兼容入口(推荐)

下列端点接收对应厂商的请求格式,并保持相应的响应和错误结构,适合官方 SDK、已有代码迁移或需要字段级透传的场景。

兼容格式端点文档
OpenAI Chat CompletionsPOST /api/v1/chat/completionsOpenAI 兼容接口
AnthropicPOST /api/v1/messagesAnthropic 兼容
Volcengine v3POST /api/v3/chat/completionsVolcengine 兼容
智谱POST /api/paas/v4/chat/completions智谱兼容
SilvaMux 统一入口POST /api/v0/chat/completionsSilvaMux 统一入口
ResponsesPOST /api/v1/responses兼容 OpenAI Responses API,适用于支持的模型(如 codex 系列)
GeminiPOST /api/v1beta/models/{model}:generateContent兼容 Gemini generateContent 格式;当前无公开可发现模型,不作为可执行示例

这些路径属于 SilvaMux 的兼容入口,并非模型厂商的官方服务地址。调用时使用 SilvaMux 提供的 API Key。公开 OpenAPI 仅以上表中的标准路径作为新接入契约;历史地址 /api/anthropic/v1/messages/api/v1/gemini/v1beta/models/{model}:generateContent 仅供已接入项目兼容,新项目不应使用。

OpenAI Responses

兼容 OpenAI Responses API,适用于支持的模型(如 codex 系列):

POST/api/v1/responses

OpenAI Responses

Bearer API Key请求头使用 Authorization: Bearer sk_live_...,也支持 x-api-key。
先确认模型调用名请先在 模型广场 筛选支持当前接口格式的模型,打开模型详情页复制调用名。当前账号的最终可用范围还受组织权限影响。

请求结构

下方内容用于确认方法、地址和鉴权方式,属于 HTTP 结构片段,不是可独立执行示例。

HTTP
POST https://www.silvamux.com/api/v1/responses
Authorization: Bearer $SILVAMUX_API_KEY
Content-Type: application/json

请求体

application/json · ResponsesRequest · 必填

字段类型必填说明
inputstring | array<FreeFormObject>
modelstring从模型广场选择标注支持 OpenAI Responses 的模型并复制调用名。
streamboolean默认值:false

响应

200Responses JSON 或 SSE 响应。

application/json · FreeFormObject

defaultOpenAI 兼容错误。

application/json · OpenAIError

字段类型必填说明
errorobject
error.codestring | integer
error.messagestring
error.typestring

常用参数

OpenAI Chat 与统一入口的常用参数:

参数类型说明
modelstring必填。模型调用名(idalias),如 minimax-m2.5doubao-seed-2.0-pro
messagesarray必填。对话消息列表,格式同 OpenAI(role + content
streamboolean是否流式返回,默认 false
temperaturenumber采样温度,默认 1.0
max_tokensinteger最大生成 token 数

不同厂商协议的字段结构不同。请先在模型广场筛选支持目标接口格式的模型,再复制详情页中的调用名填入 model

认证

Authorization: Bearer <API_KEY>x-api-key: <API_KEY>

流式输出

设置 stream: true 即可获得流式响应(SSE)。响应为 text/event-stream,每个事件以 data: 开头。最终可能收到 choices 为空、带有 usage 的用量 chunk,随后服务器关闭连接;客户端不应仅依赖 data: [DONE] 判断完成。Anthropic 格式流式遵循 Anthropic SSE 规范。

curl https://www.silvamux.com/api/v1/chat/completions \
  -H "Authorization: Bearer $SILVAMUX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "minimax-m2.5",
    "messages": [{"role": "user", "content": "写一首五言绝句"}],
    "stream": true
  }'

多模态

图片、音频等多模态输入格式见多模态输入