*更新日期: 2026-10-10*

# Responses

**POST** `/v1/responses`

OpenAI **Responses API** 兼容入口，与 [`/v1/chat/completions`](/docs/chat) 共用 chat 模型与计费。服务端会把 `input` / `instructions` 转成 chat messages 交给模型服务；返回 `object: "response"` 与 `output` 数组。

支持文本、Vision、文件附件与 function calling。`input` message 的 content 可为字符串，或含 `input_text` / `input_image` / `input_file`（也会接受 chat 风格的 `text` / `image_url` / `file`）的数组。`input_file` 可用 `file_data`（data URL / base64）或公网 `file_url`；内嵌数据会先转存。网关把 Responses 的 function tools 转成 chat `tools` 交给模型服务，再把结果放进 `output` 里的 `function_call`。网关不执行函数。`previous_response_id`、有状态 `store` 以及 `web_search` 等内置工具会被忽略或返回 400。`file_id` / `/v1/files` 不可用，传入返回 400。

## 请求

| 字段 | 类型 | 必填 | 说明 |
|------|------|------|------|
| `model` | string | 是 | 对外 id（capability = chat） |
| `input` | string \| array | 是 | 字符串等价于一条 user 文本；数组为 message / item 列表 |
| `instructions` | string | 否 | 作为 system 消息前置 |
| `stream` | boolean | 否 | `true` 时 SSE（Responses 事件流） |
| `temperature` | number | 否 | 作用于所选模型 |
| `max_output_tokens` | number | 否 | 映射为所选模型的 `max_tokens` |
| `tools` | array | 否 | 仅 `type: "function"`，字段为顶层 `name` / `description` / `parameters` / `strict`。也接受 chat 嵌套的 `function.name` |
| `tool_choice` | string \| object | 否 | `none` / `auto` / `required`，或 `{ "type": "function", "name": "..." }`。设置时必须同时传 `tools` |
| `parallel_tool_calls` | boolean | 否 | 是否允许并行函数调用。设置时必须同时传 `tools` |

多轮时在 `input` 里带回上一次的 `function_call`（`call_id`、`name`、`arguments`）和 `function_call_output`（`call_id`、`output`）。连续的 `function_call` 会合成一条带多个 `tool_calls` 的 assistant 消息。

```bash
curl https://tokenmei.com/v1/responses \
  -H "Authorization: Bearer $MOMO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "YOUR_CHAT_MODEL",
    "instructions": "你是助手",
    "input": "你好",
    "temperature": 0.7,
    "max_output_tokens": 2048
  }'
```

```javascript
const response = await client.responses.create({
  model: "YOUR_CHAT_MODEL",
  instructions: "你是助手",
  input: "你好",
  temperature: 0.7,
  max_output_tokens: 2048,
});
console.log(response.id);
console.log(response.output_text);
console.log(response.usage);
```

```python
response = client.responses.create(
    model="YOUR_CHAT_MODEL",
    instructions="你是助手",
    input="你好",
    temperature=0.7,
    max_output_tokens=2048,
)
print(response.id)
print(response.output_text)
print(response.usage)
```

## 响应

同步成功时 `status` 为 `completed`（触达 `max_output_tokens` 时可能为 `incomplete`）。文本在 `output[].content[].text`；官方 SDK 可用 `output_text` 快捷读取。

`usage` 使用 Responses 字段名：`input_tokens` / `output_tokens` / `total_tokens`。若平台开启对客展示费用，可能附带 `usage.cost`。

## 流式

`stream: true` 时返回 SSE，事件类型包括 `response.created`、`response.output_text.delta`、`response.completed` 等，与 OpenAI Responses 流式约定一致。

```bash
curl -N https://tokenmei.com/v1/responses \
  -H "Authorization: Bearer $MOMO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "YOUR_CHAT_MODEL",
    "input": "写一句问候",
    "stream": true
  }'
```

```javascript
const stream = await client.responses.create({
  model: "YOUR_CHAT_MODEL",
  input: "写一句问候",
  stream: true,
});
for await (const event of stream) {
  if (event.type === "response.output_text.delta") {
    process.stdout.write(event.delta);
  }
}
```

```python
with client.responses.stream(
    model="YOUR_CHAT_MODEL",
    input="写一句问候",
) as stream:
    for event in stream:
        if event.type == "response.output_text.delta":
            print(event.delta, end="")
```
