协议

Synthorai 在同一个 base URL 上提供三种输入协议。选择与你的 SDK 匹配的那一种；网关会透明地处理到上游供应商的协议转换。

协议对照表

端点	SDK	适用场景
`POST /v1/chat/completions`	OpenAI SDK	通用——适用于所有供应商。 e.g. `gpt-5.4-mini, qwen3.5-flash, gemini-2.5-flash, claude-sonnet-4-6`
`POST /v1/responses`	OpenAI SDK (Responses)	工具调用、推理、结构化输出。 e.g. `gpt-5.4, gpt-5.4-mini, gpt-5.3-codex`
`POST /v1/messages`	Anthropic SDK	通过 Anthropic 或 Bedrock 通道实现 Claude 原生工作流。 e.g. `claude-sonnet-4-6, claude-opus-4-1`

我该使用哪一种？

已经在使用 OpenAI SDK？ 继续使用即可。 /v1/chat/completions 是通用路径，可路由到任何已配置的供应商。
已经在使用 Anthropic SDK？ 将其 baseURL 指向网关并调用 /v1/messages. 路由到 Anthropic 或 Bedrock-Anthropic 通道。
需要在 OpenAI 模型上进行工具调用、推理或结构化输出？ 使用 /v1/responses.

ℹ

这三种协议共享同一个 API key、限流、计费和配额。唯一的区别在于请求/响应的结构形态——网关会在内部统一规范化处理。

辅助端点

除三种聊天协议外，网关还代理以下 OpenAI 兼容端点：

参数	类型	说明
`POST /v1/embeddings`	`embedding`	为文本生成向量嵌入（embeddings）。
`POST /v1/images/generations`	`image`	根据文本提示词生成图像。
`POST /v1/audio/transcriptions`	`audio`	将音频转写为文本（multipart/form-data）。
`POST /v1/audio/speech`	`audio`	将文本转换为语音音频。
`POST /v1/rerank`	`rerank`	根据查询对文档进行重排序。

流式传输

使用 Server-Sent Events (SSE) 在响应 token 生成时即时接收它们。

启用流式传输

设置 "stream": true 在你的请求体中。响应将是一个流，由以下事件组成： data: 事件。

curl https://synthorai.io/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.4-mini",
    "stream": true,
    "messages": [{"role": "user", "content": "Count to 5"}]
  }'

SSE 响应格式

data: {"id":"chatcmpl-...","choices":[{"delta":{"content":"1"},"index":0}]}
data: {"id":"chatcmpl-...","choices":[{"delta":{"content":","}}]}
data: {"id":"chatcmpl-...","choices":[{"delta":{"content":"2"}}]}
data: [DONE]

ℹ

流以下列内容结束： data: [DONE] 事件。解析每一行以下列内容开头的行： data: 并提取 choices[0].delta.content 字段。

所有这些模型——以及它们的按 token 价格——都列在 model price comparison 页面上。