Skip to content

Document cache_control_injection_points on OpenAI GPT-5.6 targets - #963

Merged
mateo-berri merged 2 commits into
mainfrom
litellm_lit5876_openai_prompt_cache_breakpoint_docs
Aug 20, 2026
Merged

Document cache_control_injection_points on OpenAI GPT-5.6 targets#963
mateo-berri merged 2 commits into
mainfrom
litellm_lit5876_openai_prompt_cache_breakpoint_docs

Conversation

@mateo-berri

@mateo-berri mateo-berri commented Aug 20, 2026

Copy link
Copy Markdown
Contributor

TLDR

Problem this solves:

How it solves it:

  • Prompt caching page: OpenAI explicit breakpoint section with SDK and proxy examples
  • Auto-inject tutorial: OpenAI GPT-5.6 section, Anthropic vs OpenAI table, config example
  • Spells out the api.openai.com gate, prompt_cache_options opt-in, /v1/responses notes

User Flow

Before: a proxy admin with GPT-5.6 deployments reads the auto-inject tutorial and finds it Anthropic-only

  1. They open https://docs.litellm.ai/docs/tutorials/prompt_caching and see cache_control_injection_points described for Anthropic models only
  2. They open https://docs.litellm.ai/docs/completion/prompt_caching and find OpenAI listed as automatic caching, nothing about prompt_cache_breakpoint or prompt_cache_options
  3. They cannot tell whether configuring an injection point on an openai/gpt-5.6 deployment does anything

After: the same pages explain the OpenAI mapping and its limits

  1. They open https://docs.litellm.ai/docs/tutorials/prompt_caching and find "OpenAI GPT-5.6 and newer" with the Anthropic vs OpenAI table, a config example with prompt_cache_options, and the rules (block-level only, api.openai.com targets, /v1/responses behavior, supports_prompt_cache_breakpoint flag)
  2. They open https://docs.litellm.ai/docs/completion/prompt_caching and find "OpenAI explicit breakpoints (GPT-5.6 and newer)" with SDK and proxy examples that set the marker and prompt_cache_options

Relevant PRs

Type

📖 Documentation


Note

Cursor Bugbot is generating a summary for commit cf7f7d4. Configure here.

Adds the OpenAI explicit breakpoint mapping that BerriAI/litellm#37628 ships: how
injection points become prompt_cache_breakpoint markers plus prompt_cache_options,
the per-deployment mode and ttl override, the api.openai.com gate with the
prompt_cache_options opt-in for custom api_base deployments, the /v1/responses
input_text behavior, and the supports_prompt_cache_breakpoint model map flag.
@vercel

vercel Bot commented Aug 20, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
litellm Ready Ready Preview Aug 20, 2026 12:38pm

Request Review

@mateo-berri

Copy link
Copy Markdown
Contributor Author

bugbot run

@cursor cursor Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

✅ Bugbot reviewed your changes and found no new issues!

Comment @cursor review or bugbot run to trigger another review on this PR

Reviewed by Cursor Bugbot for commit cf7f7d4. Configure here.

@mateo-berri

Copy link
Copy Markdown
Contributor Author

bugbot run

@cursor cursor Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

✅ Bugbot reviewed your changes and found no new issues!

Comment @cursor review or bugbot run to trigger another review on this PR

Reviewed by Cursor Bugbot for commit cd5e698. Configure here.

@mateo-berri
mateo-berri merged commit e9e7e48 into main Aug 20, 2026
3 checks passed
@mateo-berri
mateo-berri deleted the litellm_lit5876_openai_prompt_cache_breakpoint_docs branch August 20, 2026 17:33
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant