Update examples/How_to_count_tokens_with_tiktoken.ipynb #2108
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Summary
This PR adds comprehensive examples for counting tokens with structured responses to the existing "How to count tokens with tiktoken" notebook, addressing issue #2102. The addition includes a new function for calculating token overhead from structured response schemas, practical examples comparing different response formats, and API verification to ensure accuracy.
Motivation
The existing notebook provided excellent coverage for counting tokens in regular messages and tool calls, but lacked examples for structured responses - a key feature that adds token overhead due to schema definitions and validation instructions. This gap left developers without guidance on how to estimate token consumption when using structured outputs, which is increasingly important as more applications adopt structured response formats for better data consistency and parsing.
The new examples fill this gap by:
This addition makes the cookbook more complete and helps developers make informed decisions about when and how to use structured responses based on their token budget considerations.
For new content
When contributing new content, read through our contribution guidelines, and mark the following action items as completed:
We will rate each of these areas on a scale from 1 to 4, and will only accept contributions that score 3 or higher on all areas. Refer to our contribution guidelines for more details.