Sign in
Responses

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

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 20 of the 163 revisions of this API.31128

  • d86203de41ae1See the full diff
    • ○

      added the non-success response with the status

      response-non-success-status-added

  • 871767e980e11See the full diff
    • ○

      api tag Responses added

      api-tag-added

  • 2cd8933757a43See the full diff
    • ○

      request property //////////// deprecated

      request-property-deprecated

    • ○

      request property //////////// deprecated

      request-property-deprecated

    • ○

      request property //// deprecated

      request-property-deprecated

  • 6dad570526f31See the full diff
    • ○

      the ////// request property's maxLength was increased from 20971520 to 104857600

      request-property-max-length-increased

  • 2f07cb0091b415See the full diff
    • ▲

      removed subschema #1 subschema #2 from the ////// request property anyOf list

      request-property-any-of-removed

    • ○

      added the new optional request property //////

      new-optional-request-property

    • ○

      added the new optional request property //////

      new-optional-request-property

    • ○

      added the new optional request property //////

      new-optional-request-property

    • ○

      added the new optional request property //////

      new-optional-request-property

    • ○

      added subschema #1 to the ////// request property anyOf list

      request-property-any-of-added

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

  • 6bfa471548022See the full diff
    • ○

      added the new optional request property //////

      new-optional-request-property

    • ○

      added the new optional request property //////

      new-optional-request-property

  • 185927e212ab18See the full diff
    • ○

      added the new gpt-image-2.5-flare enum value to the request property /////////////

      request-property-enum-value-added

    • ○

      added the new gpt-image-2.5-flare enum value to the request property /////////////

      request-property-enum-value-added

    • ○

      added the new gpt-image-2.5-flare enum value to the request property /////

      request-property-enum-value-added

    • ○

      added the new gpt-image-2.5-flare-2026-09-08 enum value to the request property /////////////

      request-property-enum-value-added

    • ○

      added the new gpt-image-2.5-flare-2026-09-08 enum value to the request property /////////////

      request-property-enum-value-added

    • ○

      added the new gpt-image-2.5-flare-2026-09-08 enum value to the request property /////

      request-property-enum-value-added

    • ○

      added the new gpt-image-2.5-sunburst enum value to the request property /////////////

      request-property-enum-value-added

    • ○

      added the new gpt-image-2.5-sunburst enum value to the request property /////////////

      request-property-enum-value-added

    • ○

      added the new gpt-image-2.5-sunburst enum value to the request property /////

      request-property-enum-value-added

    • ○

      added the new gpt-image-2.5-sunburst-2026-09-08 enum value to the request property /////////////

      request-property-enum-value-added

    • ○

      added the new gpt-image-2.5-sunburst-2026-09-08 enum value to the request property /////////////

      request-property-enum-value-added

    • ○

      added the new gpt-image-2.5-sunburst-2026-09-08 enum value to the request property /////

      request-property-enum-value-added

    • ○

      added the new max enum value to the request property ////////////

      request-property-enum-value-added

    • ○

      added the new max enum value to the request property ////////////

      request-property-enum-value-added

    • ○

      added the new max enum value to the request property ////

      request-property-enum-value-added

    • ○

      added the new xhigh enum value to the request property ////////////

      request-property-enum-value-added

    • ○

      added the new xhigh enum value to the request property ////////////

      request-property-enum-value-added

    • ○

      added the new xhigh enum value to the request property ////

      request-property-enum-value-added

  • d3d980dbba531See the full diff
    • ○

      added the new incomplete enum value to the request property //////

      request-property-enum-value-added

  • 9430b00d75b416See the full diff
    • ○

      added the new optional request property ////////////

      new-optional-request-property

    • ○

      added the new optional request property //////////////////

      new-optional-request-property

    • ○

      added the new optional request property ///////////////

      new-optional-request-property

    • ○

      added the new optional request property ////////////

      new-optional-request-property

    • ○

      added the new optional request property ////////////

      new-optional-request-property

    • ○

      added the new optional request property //////////////////

      new-optional-request-property

    • ○

      added the new optional request property ///////////////

      new-optional-request-property

    • ○

      added the new optional request property ////////////

      new-optional-request-property

    • ○

      added the new optional request property //////

      new-optional-request-property

    • ○

      added the new optional request property //////

      new-optional-request-property

    • ○

      added the new optional request property ////

      new-optional-request-property

    • ○

      added the new optional request property //////////

      new-optional-request-property

    • ○

      added the new optional request property ///////

      new-optional-request-property

    • ○

      added the new optional request property ////

      new-optional-request-property

    • ○

      added to the //// request property oneOf list

      request-property-one-of-added

    • ○

      added the optional property / to the response with the status

      response-optional-property-added

  • 959ef977e1351See the full diff
    • ●

      removed the request property /////////

      request-property-removed