> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mixroute.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# GPT-5

> GPT-5：推理与编程模型。包含 MixRoute 调用示例与参数。

GPT-5 是 OpenAI 推出的推理与编程模型。

`gpt-5` 同时支持 OpenAI 兼容的 Chat Completions API 与 Responses API。

## 核心能力

* OpenAI 兼容 - 修改 base\_url 即可使用 OpenAI SDK
* 流式输出 - 通过 SSE 实时返回 token
* 多轮对话 - 使用带 role 的 messages
* Responses API - 使用 input 传入文本或结构化内容
* 推理控制 - 可为支持的模型设置 reasoning effort
* 工具调用 - 支持函数与托管工具定义

## 快速示例

### Responses API

<Tabs>
  <Tab title="cURL">
    ```bash theme={null}
    curl "https://api.mixroute.ai/v1/responses" \
      -H "Authorization: Bearer YOUR_API_KEY" \
      -H "Content-Type: application/json" \
      -d '{
      "model": "gpt-5",
      "input": [
        {
          "role": "user",
          "content": "Explain quantum entanglement in simple terms."
        }
      ],
      "max_output_tokens": 256,
      "reasoning": {
        "effort": "low"
      }
    }'
    ```
  </Tab>

  <Tab title="Python">
    ```python theme={null}
    from openai import OpenAI

    client = OpenAI(api_key="YOUR_API_KEY", base_url="https://api.mixroute.ai/v1")

    response = client.responses.create(
        model="gpt-5",
        input="Explain quantum entanglement in simple terms.",
        reasoning={"effort": "low"},
        max_output_tokens=256,
    )

    print(response.output_text)
    ```
  </Tab>

  <Tab title="Streaming">
    ```python theme={null}
    from openai import OpenAI

    client = OpenAI(api_key="YOUR_API_KEY", base_url="https://api.mixroute.ai/v1")

    with client.responses.stream(
        model="gpt-5",
        input="Write a short poem about the sea.",
        reasoning={"effort": "low"},
        max_output_tokens=256,
    ) as stream:
        for event in stream:
            if event.type == "response.output_text.delta":
                print(event.delta, end="")
    ```
  </Tab>
</Tabs>

### Chat Completions

<Tabs>
  <Tab title="cURL">
    ```bash theme={null}
    curl "https://api.mixroute.ai/v1/chat/completions" \
      -H "Authorization: Bearer YOUR_API_KEY" \
      -H "Content-Type: application/json" \
      -d '{
      "model": "gpt-5",
      "messages": [
        {
          "role": "user",
          "content": "Explain quantum entanglement in simple terms."
        }
      ],
      "max_completion_tokens": 256
    }'
    ```
  </Tab>

  <Tab title="Python">
    ```python theme={null}
    from openai import OpenAI

    client = OpenAI(api_key="YOUR_API_KEY", base_url="https://api.mixroute.ai/v1")

    response = client.chat.completions.create(
        model="gpt-5",
        messages=[{"role": "user", "content": "Explain quantum entanglement in simple terms."}],
        max_completion_tokens=256,
    )

    print(response.choices[0].message.content)
    ```
  </Tab>

  <Tab title="Streaming">
    ```python theme={null}
    from openai import OpenAI

    client = OpenAI(api_key="YOUR_API_KEY", base_url="https://api.mixroute.ai/v1")

    stream = client.chat.completions.create(
        model="gpt-5",
        messages=[{"role": "user", "content": "Write a short poem about the sea."}],
        max_completion_tokens=256,
        stream=True,
    )

    for chunk in stream:
        print(chunk.choices[0].delta.content or "", end="")
    ```
  </Tab>
</Tabs>

## 参数

### Responses API

| 参数                  | 类型              | 必填 | 说明                    |
| ------------------- | --------------- | -- | --------------------- |
| `model`             | string          | 是  | 固定为 `gpt-5`。          |
| `input`             | string \| array | 是  | 文本或结构化输入。             |
| `max_output_tokens` | integer         | 否  | 最大输出 token 数。         |
| `stream`            | boolean         | 否  | 启用 SSE 流式输出，默认 false。 |
| `reasoning`         | object          | 否  | 推理配置，包括 effort。       |
| `text`              | object          | 否  | 文本格式与 verbosity 控制。   |
| `tools`             | array           | 否  | 模型可以调用的工具。            |
| `store`             | boolean         | 否  | 是否存储响应。               |

### Chat Completions

| 参数                      | 类型              | 必填 | 说明                       |
| ----------------------- | --------------- | -- | ------------------------ |
| `model`                 | string          | 是  | 固定为 `gpt-5`。             |
| `messages`              | array           | 是  | 包含 role 与 content 的对话消息。 |
| `max_completion_tokens` | integer         | 否  | 最大生成 token 数。            |
| `stream`                | boolean         | 否  | 启用 SSE 流式输出，默认 false。    |
| `temperature`           | number          | 否  | 模型支持时用于控制采样随机性。          |
| `top_p`                 | number          | 否  | 模型支持时使用的核采样阈值。           |
| `stop`                  | string \| array | 否  | 触发停止生成的序列。               |
| `tools`                 | array           | 否  | OpenAI 兼容工具定义。           |