gpt-5-nano
能力: 128K 上下文 · 工具调用 · 视觉 · 流式
计价: 按 token,nano 档(实时费率)
GPT-5-nano 是 5 系列的延迟底线。当方案里需要大量便宜的 LLM 调用 —— 子 LLM 评审、
分类链、每一步是路由决策而非答案的 agent 循环 —— 就该用它。在 prompt 长度可控
的情况下,相对 mini 的质量差距很小,而延迟优势显著。
Request
Body 参数
| 字段 | 类型 | 必填 | 默认 | 说明 |
|---|---|---|---|---|
model | string | 是 | — | gpt-5-nano |
messages | array | 是 | — | OpenAI chat 结构。 |
max_tokens | integer | 否 | 模型上限 | 最大值:8192。 |
temperature | number | 否 | 1.0 | 范围 0.0–2.0。 |
tools | array | 否 | — | 支持 function calling。 |
response_format | object | 否 | — | 支持 JSON 模式 + 结构化输出。 |
stream | boolean | 否 | false | SSE 流式。 |
Response
代码示例
流式与缓存
"stream": true 走 SSE。稳定前缀自动 prompt caching。在 nano 上,缓存命中比
在更大模型上重要性低 —— 输入费率本来就低 —— 但在长 system prompt 时仍有帮助。
Errors
| Code | 触发条件 | 是否计费 |
|---|---|---|
| 400 | Body 校验 | 否 |
| 401 | key 缺失 / 已吊销 | 否 |
| 402 | 钱包余额不足 | 否 |
| 422 | 参数不支持 | 否 |
| 429 | 触发限流 | 否 |
| 5xx | 上游问题 | 否 |
何时选用
- agent pipeline 头部的路由 / 分流 / 分类。
- 大吞吐子 LLM 评审。
- 想要更高能力、可接受略高延迟,见 GPT-5-mini。
- 5.4 档的路由,见 GPT-5.4-nano。
限制
| 项 | 值 |
|---|---|
| 上下文窗口 | 128K tokens |
| 最大输出 | 8192 tokens |
| 支持工具调用 | 是 |
| 支持视觉 | 是 |
| 支持流式 | 是 |
| 支持 prompt caching | 自动 |