响应接口
OpenAI Responses API 兼容端点，支持文本、图片、非流式 JSON 与 SSE 流式响应，复用 Swarmix 的统一路由与计费链路。
POST
/v1/responses/v1/responses 复用同一套模型路由、鉴权、钱包预扣、失败候选处理、计费和日志。 Router 在请求发出前按渠道配置选择原生 Responses 或 Chat Completions 兼容转换模式。
当前支持范围
支持文本、图片 URL / Base64、客户端执行的函数工具，以及
stream=true 的 SSE 输出。input_image.file_id 明确返回 400 暂不支持；未提供文件上传与存储接口。 音频、视频、文件内容、持久状态、托管工具及后台执行仍未开放。 含图片的 function_call_output 仅支持原生 Responses 渠道。图片输入
在消息的 content 中使用 input_image，其中image_url 为 HTTP(S) 图片地址或 data:image/png;base64,...。 本地图片需先在客户端读取并编码，不能直接填写本地文件路径。支持多图、纯图片消息及图文混排。
detail 可省略，或传入 auto、low、high、original；具体图片格式和精度支持由上游模型决定。 成功后优先使用上游 usage 计费，缺失时使用本地 Token 估算，不按 Base64 字符长度计费。 原生渠道保留图片参数，Chat 兼容渠道转换为对应的 image_url 内容块。
与对话补全的关系
| 能力 | 对话补全 | 响应接口 |
|---|---|---|
| 端点 | /v1/chat/completions | /v1/responses |
| 输入 | messages | input + instructions |
| 底层执行 | 直接进入统一路由管线 | 请求前选择原生 Responses 或 Chat 兼容转换模式 |
| 推荐场景 | 兼容 Dify、Cursor、ChatBox、旧 OpenAI SDK | 兼容新版 OpenAI SDK 的 client.responses.create() |
请求头
| Header | 必填 | 示例 | 说明 |
|---|---|---|---|
Authorization | 是 | Bearer sk-swx-xxx | Swarmix 签发的 API Key |
Content-Type | 是 | application/json | 请求体格式 |
请求体
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
model | string | 是 | 要调用的模型 ID，例如 aliyun/qwen-max、aliyun/deepseek-r1。 |
input | string | array | 是 | 文本字符串，或包含 input_text / input_image 内容块的消息数组；也支持函数调用历史。 |
instructions | string | 系统级指令；原生模式透传，Chat 兼容模式映射为 system message。 | |
max_output_tokens | integer | 输出上限；Chat 兼容模式按模型映射为 max_tokens 或 max_completion_tokens。 | |
temperature | number | 采样温度，默认 1。 | |
stream | boolean | 设为 true 时返回 OpenAI Responses 事件格式的 SSE 流。 |