Sign in

Get input token counts

Returns input token counts of the request.

Returns an object with object set to response.input_tokens and an input_tokens count.

post/responses/input_tokens?beta=true

Headers

openai-betastring[]

Optional beta features to enable for this request.

Request body

modelstring nullable

Model ID used to generate the response, like gpt-4o or o3. OpenAI offers a wide range of models with different capabilities, performance characteristics, and price points. Refer to the model guide to browse and compare available models.

previous_response_idstring nullable

The unique ID of the previous response to the model. Use this to create multi-turn conversations. Learn more about conversation state. Cannot be used in conjunction with conversation.

truncation'auto' | 'disabled'
instructionsstring nullable

A system (or developer) message inserted into the model's context. When used along with previous_response_id, the instructions from a previous response will not be carried over to the next response. This makes it simple to swap out system (or developer) messages in new responses.

parallel_tool_callsboolean nullable

Whether to allow the model to run tool calls in parallel.

Response

Success

object'response.input_tokens' required
input_tokensinteger required

Example response

{
  "object": "response.input_tokens",
  "input_tokens": 123
}

Changes

Changed in 2 of the 31 revisions of this API.21

  • 241fb501b3722See the full diff
    • ▲

      removed subschema #1 subschema #2 subschema #3 from the input/anyOf[subschema #1]/anyOf[subschema #2]/items/anyOf[subschema #2: Item]/anyOf[BetaMultiAgentCallOutputItemParam]/output/items/annotations request property anyOf list

      request-property-any-of-removed

    • ▲

      the input/anyOf[subschema #1]/anyOf[subschema #2]/items/anyOf[subschema #2: Item]/anyOf[BetaMultiAgentCallOutputItemParam]/output/items/annotations request property type/format changed from / to array/

      request-property-type-changed

  • e0508a503b841See the full diff
    • ○

      endpoint added

      endpoint-added

    This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog