多模态接口
/v1/responses）。接口地址
POST https://www.moyu.info/v1/responses请求示例
纯文本
cURL
图文混合输入
content 数组中，type 分别为 input_text 与 input_image。cURL
image_url 也支持 Base64 Data URL（data:image/jpeg;base64,...），适合上传本地图片。其他语言
响应格式
{
"id": "resp_xxx",
"object": "response",
"created_at": 0,
"model": "MODEL_NAME",
"status": "completed",
"output": [
{
"id": "msg_xxx",
"type": "message",
"role": "assistant",
"status": "completed",
"content": [
{
"type": "output_text",
"text": "图片中是一只坐在草地上的橘色猫咪。"
}
]
}
],
"usage": {
"input_tokens": 258,
"output_tokens": 24,
"total_tokens": 282,
"input_tokens_details": {
"cached_tokens": 0
},
"output_tokens_details": {
"reasoning_tokens": 0
}
}
}请求参数
基础参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| model | string | 是 | 多模态模型名称 |
| input | string/array | 是 | 输入内容，可以是字符串或消息数组。混合多模态输入时使用数组格式 |
input 格式
{
"model": "MODEL_NAME",
"input": "你好"
}{
"model": "MODEL_NAME",
"input": [
{
"role": "user",
"content": [
{"type": "input_text", "text": "描述这张图片"},
{"type": "input_image", "image_url": "https://example.com/a.jpg"}
]
}
]
}content 内容类型
content 是一个内容块数组，常用类型如下：| type | 说明 | 关键字段 |
|---|---|---|
| input_text | 文本内容 | text：文本字符串 |
| input_image | 图片内容 | image_url：图片的 URL 或 Base64 Data URL |
一条消息的 content中可以同时包含多个文本块与图片块，顺序即为模型看到的顺序。
采样参数
| 参数 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
| temperature | number | 否 | 1 | 采样温度，范围 0-2 |
| top_p | number | 否 | 1 | 核采样参数，范围 0-1 |
| max_output_tokens | integer | 否 | 模型最大值 | 生成的最大 token 数量 |
控制参数
| 参数 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
| instructions | string | 否 | - | 系统指令，用于设定助手的行为 |
| stream | boolean | 否 | false | 是否流式输出。true 时以 SSE 事件流返回 |
| previous_response_id | string | 否 | - | 上一次响应的 ID，用于多轮对话上下文衔接 |
高级参数
| 参数 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
| tools | array | 否 | [] | 可用工具列表（函数调用等） |
| tool_choice | object | 否 | - | 工具选择策略 |
| reasoning | object | 否 | - | 推理配置，如 {"effort": "medium"} |
| metadata | object | 否 | {} | 自定义元数据 |
| user | string | 否 | - | 终端用户的唯一标识符 |
响应字段说明
| 字段 | 类型 | 说明 |
|---|---|---|
| id | string | 本次响应的唯一标识符，格式为 resp_xxx |
| object | string | 对象类型，固定为 response |
| created_at | integer | 创建时间戳 |
| model | string | 使用的模型名称 |
| status | string | 响应状态：completed(完成)、failed(失败)、in_progress(进行中) |
| output | array | 输出内容列表 |
| output[].type | string | 输出项类型，如 message |
| output[].role | string | 角色，固定为 assistant |
| output[].content | array | 内容列表 |
| output[].content[].type | string | 内容类型，如 output_text |
| output[].content[].text | string | 助手的回复文本 |
| usage | object | token 使用情况统计 |
| usage.input_tokens | integer | 输入使用的 token 数（含文本与图片折算） |
| usage.output_tokens | integer | 输出使用的 token 数 |
| usage.total_tokens | integer | 总 token 数 |
| usage.input_tokens_details | object | 输入 token 详情 |
| usage.input_tokens_details.cached_tokens | integer | 缓存命中的输入 token 数（未命中缓存时为 0） |
| usage.output_tokens_details | object | 输出 token 详情 |
| usage.output_tokens_details.reasoning_tokens | integer | 推理过程消耗的 token 数（不支持推理的模型为 0） |
修改于 2026-08-05 01:35:17