Skip to content

feat(provider/openai,provider/gateway): add gpt-5.6 model id#17021

Merged
gr2m merged 4 commits into
mainfrom
feat/openai-gpt-5.6
Jul 9, 2026
Merged

feat(provider/openai,provider/gateway): add gpt-5.6 model id#17021
gr2m merged 4 commits into
mainfrom
feat/openai-gpt-5.6

Conversation

@gr2m

@gr2m gr2m commented Jul 9, 2026

Copy link
Copy Markdown
Collaborator

Background

OpenAI released GPT-5.6.

Summary

Add the gpt-5.6 model ID:

  • @ai-sdk/openai: added gpt-5.6 and the gpt-5.6-sol, gpt-5.6-terra, gpt-5.6-luna snapshot IDs to the chat and responses model ID types, the responses reasoning model IDs, and the language model capabilities (GPT-5.6 supports temperature/topP/logProbs when reasoningEffort is none, like GPT-5.1+).
  • @ai-sdk/gateway: added openai/gpt-5.6 to the gateway model IDs.
  • Docs: added gpt-5.6 to the model capability tables (foundations, OpenAI provider page, providers index).
  • Examples: updated examples that used a prior flagship GPT model (gpt-5, gpt-5.1, gpt-5.2, gpt-5.4, gpt-5.5) as a generic default to use gpt-5.6. Examples that are deliberately model-specific (codex/mini/nano/pro/chat-latest/dated variants, Azure deployment names, files named after a model) were left unchanged. Added gpt-5.6 to the e2e chat model list. Restored generate-text/openai/basic.ts to its pre-debugging state (keeping gpt-5.6) and added reasoning-max.ts examples (generate-text + stream-text) demonstrating reasoningEffort: 'max'.

Manual Verification

Ran the new examples/ai-functions/src/generate-text/openai/reasoning-max.ts and examples/ai-functions/src/stream-text/openai/reasoning-max.ts against the live OpenAI API: reasoningEffort: 'max' is accepted and returns reasoning summaries.

Ran the updated examples/ai-functions/src/stream-text/openai/reasoning.ts against the live OpenAI API with gpt-5.6: streaming works, including reasoning summary deltas and reasoning provider metadata (the API resolves the ID to the gpt-5.6-sol snapshot).

Note: openai/gpt-5.6 is not yet served by the AI Gateway (model_not_found as of this PR); the gateway model ID addition is launch preparation.

Checklist

  • All commits are signed (PRs with unsigned commits cannot be merged)
  • Tests have been added / updated (for bug fixes / features)
  • Documentation has been added / updated (for bug fixes / features)
  • A patch changeset for relevant packages has been added (for bug fixes / features - run pnpm changeset in the project root)
  • I have reviewed this pull request (self-review)

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
…odel ids

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
| [xAI Grok](/providers/ai-sdk-providers/xai) | `grok-3` | <Cross /> | <Check /> | <Check /> | <Check /> |
| [xAI Grok](/providers/ai-sdk-providers/xai) | `grok-3-mini` | <Cross /> | <Check /> | <Check /> | <Check /> |
| [Vercel](/providers/ai-sdk-providers/vercel) | `v0-1.0-md` | <Check /> | <Check /> | <Check /> | <Check /> |
| [OpenAI](/providers/ai-sdk-providers/openai) | `gpt-5.6` | <Check /> | <Check /> | <Check /> | <Check /> |

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

also add gpt-5.6-sol/terra/luna

| [xAI Grok](/providers/ai-sdk-providers/xai) | `grok-3` | <Cross /> | <Check /> | <Check /> | <Check /> |
| [xAI Grok](/providers/ai-sdk-providers/xai) | `grok-3-mini` | <Cross /> | <Check /> | <Check /> | <Check /> |
| [Vercel](/providers/ai-sdk-providers/vercel) | `v0-1.0-md` | <Check /> | <Check /> | <Check /> | <Check /> |
| [OpenAI](/providers/ai-sdk-providers/openai) | `gpt-5.6` | <Check /> | <Check /> | <Check /> | <Check /> |

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

docs should list each model, not just 5.6 as a whole

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

same thing in other docs files

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Added individual rows for gpt-5.6-luna, gpt-5.6-sol, and gpt-5.6-terra to all three docs capability tables in 96d916b.

| 'openai/gpt-5.4-pro'
| 'openai/gpt-5.5'
| 'openai/gpt-5.5-pro'
| 'openai/gpt-5.6'

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

missing -luna, -terra, -sol,

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Added openai/gpt-5.6-luna, openai/gpt-5.6-sol, and openai/gpt-5.6-terra to the gateway model IDs in 96d916b.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

update docs for new max reasoning setting

@gr2m
gr2m enabled auto-merge (squash) July 9, 2026 17:47
@gr2m
gr2m merged commit fdb6d5d into main Jul 9, 2026
49 checks passed
@gr2m
gr2m deleted the feat/openai-gpt-5.6 branch July 9, 2026 17:53
@github-actions

github-actions Bot commented Jul 9, 2026

Copy link
Copy Markdown
Contributor

🚀 Published in:

Package Version
ai 7.0.19 github npm
@ai-sdk/alibaba 2.0.9 github npm
@ai-sdk/amazon-bedrock 5.0.15 github npm
@ai-sdk/angular 3.0.19 github npm
@ai-sdk/anthropic 4.0.11 github npm
@ai-sdk/anthropic-aws 2.0.3 github npm
@ai-sdk/assemblyai 3.0.7 github npm
@ai-sdk/azure 4.0.10 github npm
@ai-sdk/baseten 2.0.7 github npm
@ai-sdk/black-forest-labs 2.0.7 github npm
@ai-sdk/bytedance 2.0.8 github npm
@ai-sdk/cerebras 3.0.7 github npm
@ai-sdk/cohere 4.0.7 github npm
@ai-sdk/deepgram 3.0.7 github npm
@ai-sdk/deepinfra 3.0.7 github npm
@ai-sdk/deepseek 3.0.7 github npm
@ai-sdk/devtools 1.0.3 github npm
@ai-sdk/elevenlabs 3.0.8 github npm
@ai-sdk/fal 3.0.8 github npm
@ai-sdk/fireworks 3.0.8 github npm
@ai-sdk/gateway 4.0.15 github npm
@ai-sdk/gladia 3.0.7 github npm
@ai-sdk/google 4.0.11 github npm
@ai-sdk/google-vertex 5.0.14 github npm
@ai-sdk/groq 4.0.7 github npm
@ai-sdk/harness 1.0.22 github npm
@ai-sdk/harness-claude-code 1.0.22 github npm
@ai-sdk/harness-codex 1.0.23 github npm
@ai-sdk/harness-deepagents 1.0.21 github npm
@ai-sdk/harness-opencode 1.0.22 github npm
@ai-sdk/harness-pi 1.0.22 github npm
@ai-sdk/huggingface 2.0.7 github npm
@ai-sdk/hume 3.0.7 github npm
@ai-sdk/klingai 4.0.8 github npm
@ai-sdk/langchain 3.0.19 github npm
@ai-sdk/llamaindex 3.0.19 github npm
@ai-sdk/lmnt 3.0.7 github npm
@ai-sdk/luma 3.0.8 github npm
@ai-sdk/mcp 2.0.10 github npm
@ai-sdk/mistral 4.0.8 github npm
@ai-sdk/moonshotai 3.0.9 github npm
@ai-sdk/open-responses 2.0.7 github npm
@ai-sdk/openai 4.0.10 github npm
@ai-sdk/openai-compatible 3.0.7 github npm
@ai-sdk/otel 1.0.19 github npm
@ai-sdk/perplexity 4.0.8 github npm
@ai-sdk/policy-opa 1.0.19 github npm
@ai-sdk/prodia 2.0.8 github npm
@ai-sdk/provider 4.0.3 github npm
@ai-sdk/provider-utils 5.0.7 github npm
@ai-sdk/quiverai 2.0.7 github npm
@ai-sdk/react 4.0.20 github npm
@ai-sdk/replicate 3.0.8 github npm
@ai-sdk/revai 3.0.7 github npm
@ai-sdk/rsc 3.0.19 github npm
@ai-sdk/sandbox-just-bash 1.0.22 github npm
@ai-sdk/sandbox-vercel 1.0.22 github npm
@ai-sdk/svelte 5.0.19 github npm
@ai-sdk/togetherai 3.0.8 github npm
@ai-sdk/tui 1.0.19 github npm
@ai-sdk/valibot 3.0.7 github npm
@ai-sdk/vercel 3.0.7 github npm
@ai-sdk/voyage 2.0.7 github npm
@ai-sdk/vue 4.0.19 github npm
@ai-sdk/workflow 1.0.19 github npm
@ai-sdk/workflow-harness 1.0.22 github npm
@ai-sdk/xai 4.0.10 github npm

gr2m added a commit that referenced this pull request Jul 9, 2026
…ontrols (#17028)

## Summary

- add GPT-5.6 `max` reasoning effort support for Chat Completions
- add Responses API `reasoningMode` and `reasoningContext` options,
including the effective reasoning context in provider metadata
- support GPT-5.6 implicit and explicit prompt cache options, 30-minute
TTL, and explicit cache breakpoints for supported message content
- report cache-write tokens for Chat Completions and Responses without
double-counting uncached input tokens
- document GPT-5.6 reasoning, prompt caching, cache-write usage, and
original image detail behavior
- add `generateText` and `streamText` examples for pro mode, persisted
reasoning context, and explicit prompt caching

Follow-up to #17021.

## Test plan

- `pnpm test:node` in `packages/openai` — 19 files, 772 tests
- `pnpm test:edge` in `packages/openai` — 19 files, 772 tests
- `pnpm type-check` in `packages/openai`
- `pnpm type-check:full`
- `pnpm check`
- `node tools/validate-properties-tables.mjs`

Live GPT-5.6 examples were not run locally because no `OPENAI_API_KEY`
was configured.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants