Input Tokens

Get input token counts

$ openai responses:input-tokens count

post /responses/input_tokens

Returns input token counts of the request.

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

Parameters

--conversation: optional string or ResponseConversationParam

The conversation that this response belongs to. Items from this conversation are prepended to input_items for this response request. Input items and output items from this response are automatically added to this conversation after this response completes.
--input: optional string or array of ResponseInputItem

Text, image, or file inputs to the model, used to generate a response
--instructions: optional string

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.
--model: optional string

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.
--parallel-tool-calls: optional boolean

Whether to allow the model to run tool calls in parallel.
--previous-response-id: optional string

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.
--reasoning: optional object { effort, generate_summary, summary }

gpt-5 and o-series models only Configuration options for reasoning models.
--text: optional object { format, verbosity }

Configuration options for a text response from the model. Can be plain text or structured JSON data. Learn more:
- Text inputs and outputs
- Structured Outputs
--tool-choice: optional ToolChoiceOptions or ToolChoiceAllowed or ToolChoiceTypes or 5 more

Controls which tool the model should use, if any.
--tool: optional array of Tool

An array of tools the model may call while generating a response. You can specify which tool to use by setting the tool_choice parameter.
--truncation: optional "auto" or "disabled"

The truncation strategy to use for the model response. - auto: If the input to this Response exceeds the model's context window size, the model will truncate the response to fit the context window by dropping items from the beginning of the conversation. - disabled (default): If the input size will exceed the context window size for a model, the request will fail with a 400 error.

Returns

InputTokenCountResponse: object { input_tokens, object }
- input_tokens: number
- object: "response.input_tokens"

Example

openai responses:input-tokens count \
  --api-key 'My API Key'

Response

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

cli/resources/responses/subresources/input_tokens/index.md +87 −0 created

1# Input Tokens

3## Get input token counts

5`$ openai responses:input-tokens count`

7**post** `/responses/input_tokens`

9Returns input token counts of the request.

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

13### Parameters

15- `--conversation: optional string or ResponseConversationParam`

17 The conversation that this response belongs to. Items from this conversation are prepended to `input_items` for this response request.

18 Input items and output items from this response are automatically added to this conversation after this response completes.

20- `--input: optional string or array of ResponseInputItem`

22 Text, image, or file inputs to the model, used to generate a response

24- `--instructions: optional string`

26 A system (or developer) message inserted into the model's context.

27 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.

29- `--model: optional string`

31 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](https://platform.openai.com/docs/models) to browse and compare available models.

33- `--parallel-tool-calls: optional boolean`

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

37- `--previous-response-id: optional string`

39 The unique ID of the previous response to the model. Use this to create multi-turn conversations. Learn more about [conversation state](https://platform.openai.com/docs/guides/conversation-state). Cannot be used in conjunction with `conversation`.

41- `--reasoning: optional object { effort, generate_summary, summary }`

43 **gpt-5 and o-series models only** Configuration options for [reasoning models](https://platform.openai.com/docs/guides/reasoning).

45- `--text: optional object { format, verbosity }`

47 Configuration options for a text response from the model. Can be plain

48 text or structured JSON data. Learn more:

50 - [Text inputs and outputs](https://platform.openai.com/docs/guides/text)

51 - [Structured Outputs](https://platform.openai.com/docs/guides/structured-outputs)

53- `--tool-choice: optional ToolChoiceOptions or ToolChoiceAllowed or ToolChoiceTypes or 5 more`

55 Controls which tool the model should use, if any.

57- `--tool: optional array of Tool`

59 An array of tools the model may call while generating a response. You can specify which tool to use by setting the `tool_choice` parameter.

61- `--truncation: optional "auto" or "disabled"`

63 The truncation strategy to use for the model response. - `auto`: If the input to this Response exceeds the model's context window size, the model will truncate the response to fit the context window by dropping items from the beginning of the conversation. - `disabled` (default): If the input size will exceed the context window size for a model, the request will fail with a 400 error.

65### Returns

67- `InputTokenCountResponse: object { input_tokens, object }`

69 - `input_tokens: number`

71 - `object: "response.input_tokens"`

73### Example

75```cli

76openai responses:input-tokens count \

77 --api-key 'My API Key'

78```

80#### Response

82```json

83{

84 "input_tokens": 123,

85 "object": "response.input_tokens"

86}

87```