OpenAI API

RunCompletionUsage

object

Usage statistics related to the run. This value will be null if the run is not in a terminal state (i.e. in_progress, queued, etc.).

completion_tokensintegerrequired

Number of completion tokens used over the course of the run.

prompt_tokensintegerrequired

Number of prompt tokens used over the course of the run.

total_tokensintegerrequired

Total number of tokens used (prompt + completion).

Example

A run on a thread

object

Represents an execution run on a thread.

idstringrequired

The identifier, which can be referenced in API endpoints.

objectstringrequired

The object type, which is always thread.run.

Allowed values:thread.run

created_atintegerrequired

The Unix timestamp (in seconds) for when the run was created.

thread_idstringrequired

The ID of the thread that was executed on as a part of this run.

assistant_idstringrequired

The ID of the assistant used for execution of this run.

statusstringrequired

The status of the run, which can be either queued, in_progress, requires_action, cancelling, cancelled, failed, completed, incomplete, or expired.

Allowed values:queuedin_progressrequires_actioncancellingcancelledfailedcompletedincompleteexpired

required_actionobjectrequired

Details on the action required to continue the run. Will be null if no action is required.

Show Child Parameters
last_errorobjectrequired

The last error associated with this run. Will be null if there are no errors.

Show Child Parameters
expires_atintegerrequired

The Unix timestamp (in seconds) for when the run will expire.

started_atintegerrequired

The Unix timestamp (in seconds) for when the run was started.

cancelled_atintegerrequired

The Unix timestamp (in seconds) for when the run was cancelled.

failed_atintegerrequired

The Unix timestamp (in seconds) for when the run failed.

completed_atintegerrequired

The Unix timestamp (in seconds) for when the run was completed.

incomplete_detailsobjectrequired

Details on why the run is incomplete. Will be null if the run is not incomplete.

Show Child Parameters
modelstringrequired

The model that the assistant used for this run.

instructionsstringrequired

The instructions that the assistant used for this run.

toolsOne Of
arrayrequired

The list of tools that the assistant used for this run.

Default:[]

<= 20 items

Code interpreter toolobject
Show Child Parameters
metadataobjectrequired

Set of 16 key-value pairs that can be attached to an object. This can be
useful for storing additional information about the object in a structured
format, and querying for objects via API or the dashboard.

Keys are strings with a maximum length of 64 characters. Values are strings
with a maximum length of 512 characters.

usageobjectrequired

Usage statistics related to the run. This value will be null if the run is not in a terminal state (i.e. in_progress, queued, etc.).

Show Child Parameters
temperaturenumber

The sampling temperature used for this run. If not set, defaults to 1.

top_pnumber

The nucleus sampling value used for this run. If not set, defaults to 1.

max_prompt_tokensintegerrequired

The maximum number of prompt tokens specified to have been used over the course of the run.

>= 256

max_completion_tokensintegerrequired

The maximum number of completion tokens specified to have been used over the course of the run.

>= 256

truncation_strategyobjectrequired

Controls for how a thread will be truncated prior to the run. Use this to control the intial context window of the run.

Show Child Parameters
tool_choiceOne Of
required
AssistantsApiToolChoiceOptionstring

none means the model will not call any tools and instead generates a message. auto means the model can pick between generating a message or calling one or more tools. required means the model must call one or more tools before responding to the user.

Allowed values:noneautorequired

parallel_tool_callsbooleanrequired

Whether to enable parallel function calling during tool use.

Default:true

response_formatOne Of
required
AssistantsApiResponseFormatOptionstring

auto is the default value

Allowed values:auto

Example

RunStepCompletionUsage

object

Usage statistics related to the run step. This value will be null while the run step’s status is in_progress.

completion_tokensintegerrequired

Number of completion tokens used over the course of the run step.

prompt_tokensintegerrequired

Number of prompt tokens used over the course of the run step.

total_tokensintegerrequired

Total number of tokens used (prompt + completion).

Example

Run step delta object

object

Represents a run step delta i.e. any changed fields on a run step during streaming.

idstringrequired

The identifier of the run step, which can be referenced in API endpoints.

objectstringrequired

The object type, which is always thread.run.step.delta.

Allowed values:thread.run.step.delta

deltaobjectrequired

The delta containing the fields that have changed on the run step.

Show Child Parameters
Example

Message creation

object

Details of the message creation by the run step.

typestringrequired

Always message_creation.

Allowed values:message_creation

message_creationobject
Show Child Parameters
Example