ToAPIs

快速结论

  • 适合高复杂度问答、方案推演、代码分析与多步骤任务拆解。
  • 使用 OpenAI 兼容格式：POST /v1/chat/completions，可直接复用现有 OpenAI SDK 工作流。
  • 支持 stream=true 的 SSE 流式返回，适合 IDE、终端助手与实时交互场景。

关键参数

  • model | string | 必填 | gpt-5-4-mini | - | 模型名称，使用当前页面模型 ID（例如 gpt-5-4-mini）。
  • messages | object[] | 必填 | - | - | 对话消息列表，按时间顺序排列；角色支持 system、user、assistant。
  • max_tokens | integer | 可选 | - | >=1 | 生成内容的最大 token 数量（不设置时使用模型默认上限）。
  • stream | boolean | 可选 | false | - | 是否启用流式输出（SSE）。
  • temperature | number | 可选 | 1 | 0-2 | 采样温度，控制输出随机性。
  • top_p | number | 可选 | 1 | 0-1 | 核采样概率阈值，建议不要同时大幅调整 temperature 与 top_p。
  • stop | string | string[] | 可选 | - | - | 停止序列，最多支持 4 个。
  • Authorization | HTTP Header | 必填 | - | - | Bearer Token 认证：Authorization: Bearer <YOUR_API_KEY>。

常见错误

  • 400 invalid_request_error: 触发=请求体缺少必填字段或字段类型不匹配。; 修复=校验 model、messages 与参数类型。; 重试=修正请求后重试。
  • 401 authentication_error: 触发=鉴权头缺失、格式错误或密钥失效。; 修复=确认 Authorization 头和密钥有效性。; 重试=修复鉴权后重试。
  • 429 rate_limit_error: 触发=请求频率、并发或当前额度命中上游限流策略。; 修复=先做指数退避重试，并检查当前请求节奏、并发设置和额度使用情况。; 重试=建议 1s/2s/4s + 抖动；连续触发时再收紧提交节奏。
返回模型广场

模型解析页

Gpt 5 4 Mini

模型 ID: gpt-5-4-mini

厂商: OpenAI能力类型: Chat价格: Input $0.15/1M, Output $0.90/1M更新于: 2026-05-02

Gpt 5 4 Mini 是面向复杂推理与高质量文本/代码生成的高阶通用模型。本页聚焦 OpenAI Chat Completions 接入、关键参数与工程落地做法，帮助你从验证快速迁移到生产。

在 Playground 中打开文档

模型概览

快速结论

  • 适合高复杂度问答、方案推演、代码分析与多步骤任务拆解。
  • 使用 OpenAI 兼容格式：POST /v1/chat/completions，可直接复用现有 OpenAI SDK 工作流。
  • 支持 stream=true 的 SSE 流式返回，适合 IDE、终端助手与实时交互场景。

Gpt 5 4 Mini模型特点

核心能力

能力一览与工程实践价值

复杂推理与任务分解

适合长链路问题拆解、技术方案比较与多约束条件下的决策支持。

高质量代码与技术内容生成

可用于代码解释、重构建议、测试样例与技术文档初稿生成。

OpenAI 兼容接入

可直接使用 OpenAI Chat Completions 请求结构，降低接入与迁移成本。

流式实时交互

支持 stream=true，便于边生成边展示，优化交互响应体验。

参数可控输出

通过 temperature、top_p、stop 与 system 角色提示精细控制输出风格与稳定性。

工程化生产友好

结合鉴权、重试、限流与日志追踪，便于在服务端稳定运行。

如何使用 Gpt 5 4 Mini API

  1. 创建 API Key，并在请求头设置 Authorization: Bearer <YOUR_API_KEY>。
  2. 向 /v1/chat/completions 发送 POST，请求体至少包含 model 与 messages。
  3. 按场景设置 max_tokens、temperature、top_p、stop 等参数。
  4. 如需实时输出，设置 stream=true 并按 SSE 事件流增量处理。
  5. 根据 finish_reason 与 usage 统计收尾并记录监控指标。
Gpt 5 4 Mini

适用场景

  • 需要处理高复杂度推理、技术评估、编码分析或长上下文问答。
  • 需要 OpenAI SDK 兼容接入，快速落地聊天与助手能力。
  • 需要流式输出构建实时交互体验。

API 运行特性

  • 请求入口为 POST /v1/chat/completions，遵循 OpenAI Chat Completions 格式。
  • stream=true 时返回 SSE 事件流；stream=false 时一次性返回完整响应。
  • 响应主体包含 choices 与 usage，可根据 finish_reason 判断收尾状态。
Gpt 5 4 Mini

关键参数

参数类型必填默认值取值范围说明
modelstring是gpt-5-4-mini-模型名称，使用当前页面模型 ID（例如 gpt-5-4-mini）。
messagesobject[]是--对话消息列表，按时间顺序排列；角色支持 system、user、assistant。
max_tokensinteger否->=1生成内容的最大 token 数量（不设置时使用模型默认上限）。
streamboolean否false-是否启用流式输出（SSE）。
temperaturenumber否10-2采样温度，控制输出随机性。
top_pnumber否10-1核采样概率阈值，建议不要同时大幅调整 temperature 与 top_p。
stopstring | string[]否--停止序列，最多支持 4 个。
AuthorizationHTTP Header是--Bearer Token 认证：Authorization: Bearer <YOUR_API_KEY>。

常见错误

400 invalid_request_error

触发条件: 请求体缺少必填字段或字段类型不匹配。

修复建议: 校验 model、messages 与参数类型。

重试策略: 修正请求后重试。

401 authentication_error

触发条件: 鉴权头缺失、格式错误或密钥失效。

修复建议: 确认 Authorization 头和密钥有效性。

重试策略: 修复鉴权后重试。

429 rate_limit_error

触发条件: 请求频率、并发或当前额度命中上游限流策略。

修复建议: 先做指数退避重试，并检查当前请求节奏、并发设置和额度使用情况。

重试策略: 建议 1s/2s/4s + 抖动；连续触发时再收紧提交节奏。

FAQ

Gpt 5 4 Mini 最适合哪些任务？

适合复杂推理、技术问答、代码分析与高质量内容生成等高价值任务。

怎么最快接入？

使用 OpenAI 兼容格式，POST 到 /v1/chat/completions，至少传 model 与 messages。

流式输出怎么处理？

设置 stream=true 后按 SSE 事件增量处理内容，最终以 finish_reason 收尾。

temperature 和 top_p 怎么选？

一般优先调 temperature；若需更强概率裁剪再调 top_p，避免同时大幅调整两者。

模式说明

Chat Completions 模式（Gpt 5 4 Mini）

OpenAI 兼容入口，适合复用现有 SDK 与应用链路。

模式参数

modelmessagesmax_tokenstemperaturetop_pstopstream

最佳应用场景

  • 通用问答助手
  • 代码解释与重构建议
  • 技术文档生成

Streaming 模式（Gpt 5 4 Mini）

开启 stream 后可增量返回，适合实时交互界面。

模式参数

streammessagesmax_tokens

最佳应用场景

  • IDE 实时建议
  • 聊天窗口逐段输出
  • 终端助手

Tool Calling 模式（Gpt 5 4 Mini）

在支持工具调用的模型与场景中，可扩展外部函数与执行链路。

模式参数

toolstool_choicemessagesmax_tokens

最佳应用场景

  • 检索增强问答
  • 自动化测试执行
  • 多步骤 Agent 流程

相关 API

准备开始统一接入 AI 模型了吗？

免费注册后，你可以先看模型广场选模型，再到定价页确认成本和默认路由策略

免费开始查看定价