Crate openai_openapi_types

Crate openai_openapi_types 

Source

Modules§

activate_project_certificates
add_upload_part
admin_api_key
admin_api_keys_create
admin_api_keys_delete
admin_api_keys_get
admin_api_keys_list
archive_project
assistant_object
assistant_tools_file_search
assistants_named_tool_choice
audit_log
audit_log_actor
audit_log_actor_api_key
batch
batch_request_input
batch_request_output
cancel_batch
cancel_eval_run
cancel_fine_tuning_job
cancel_response
cancel_run
cancel_upload
cancel_vector_store_file_batch
certificate
chat_completion_allowed_tools
chat_completion_message_custom_tool_call
chat_completion_message_list
chat_completion_message_tool_call
chat_completion_message_tool_call_chunk
chat_completion_message_tool_calls
chat_completion_modalities
chat_completion_named_tool_choice
chat_completion_named_tool_choice_custom
chat_completion_request_assistant_message
chat_completion_request_developer_message
chat_completion_request_message_content_part_audio
chat_completion_request_message_content_part_file
chat_completion_request_message_content_part_image
chat_completion_request_system_message
chat_completion_request_tool_message
chat_completion_request_user_message
chat_completion_response_message
chat_completion_stream_response_delta
chat_completion_token_logprob
click
code_interpreter_file_output
code_interpreter_tool
code_interpreter_tool_call
comparison_filter
complete_upload
completion_usage
compound_filter
computer_call_output_item_param
computer_tool_call
computer_tool_call_output
computer_tool_call_output_resource
computer_use_preview_tool
container_resource
costs_result
create_assistant_request
create_batch
create_chat_completion_request
create_chat_completion_response
create_chat_completion_stream_response
create_completion_request
create_completion_response
create_container
create_container_body
create_container_file
create_conversation_items
create_embedding_request
create_embedding_response
create_eval_completions_run_data_source
create_eval_item
create_eval_jsonl_run_data_source
create_eval_request
create_eval_responses_run_data_source
create_eval_run
create_eval_run_request
create_fine_tuning_checkpoint_permission
create_fine_tuning_job_request
create_image_edit_request
create_image_request
create_image_variation_request
create_message
create_message_request
create_moderation_request
create_moderation_response
create_project_service_account
create_project_user
create_response
create_run
create_run_request
create_run_request_without_stream
create_speech_request
create_thread_and_run_request
create_thread_and_run_request_without_stream
create_thread_request
create_transcription
create_transcription_request
create_transcription_response_json
create_translation
create_translation_request
create_upload_request
create_vector_store_file
create_vector_store_file_batch
custom_tool
custom_tool_chat_completions
deactivate_project_certificates
delete_assistant
delete_chat_completion
delete_container
delete_container_file
delete_conversation
delete_conversation_item
delete_eval
delete_eval_run
delete_file
delete_fine_tuning_checkpoint_permission
delete_invite
delete_message
delete_model
delete_project_api_key
delete_project_service_account
delete_project_user
delete_response
delete_thread
delete_user
delete_vector_store
delete_vector_store_file
download_file
easy_input_message
eval
eval_grader_string_check
eval_grader_text_similarity
eval_item
eval_jsonl_file_content_source
eval_run
eval_run_output_item
file_search_tool_call
fine_tune_chat_completion_request_assistant_message
fine_tune_chat_request_input
fine_tune_dpo_hyperparameters
fine_tune_method
fine_tune_preference_request_input
fine_tune_reinforcement_hyperparameters
fine_tune_reinforcement_method
fine_tune_reinforcement_request_input
fine_tune_supervised_hyperparameters
fine_tuning_integration
fine_tuning_job
fine_tuning_job_checkpoint
fine_tuning_job_event
function_call_output_item_param
function_tool_call
function_tool_call_output
function_tool_call_output_resource
function_tool_call_resource
get_assistant
get_certificate
get_chat_completion
get_chat_completion_messages
get_conversation
get_conversation_item
get_eval
get_eval_run
get_eval_run_output_item
get_eval_run_output_items
get_eval_runs
get_message
get_response
get_run
get_run_step
get_thread
get_vector_store
get_vector_store_file
get_vector_store_file_batch
grader_multi
grader_string_check
grader_text_similarity
image_edit_completed_event
image_edit_partial_image_event
image_gen_completed_event
image_gen_partial_image_event
image_gen_tool
image_gen_tool_call
images_response
images_usage
input_audio
input_image_content
input_image_content_2
input_message
input_message_resource
invite
invite_request
item_reference_param
list_assistants
list_audit_logs
list_batches
list_chat_completions
list_container_files
list_containers
list_conversation_items
list_evals
list_files
list_files_in_vector_store_batch
list_fine_tuning_checkpoint_permissions
list_fine_tuning_events
list_fine_tuning_job_checkpoints
list_input_items
list_invites
list_messages
list_organization_certificates
list_paginated_fine_tuning_jobs
list_project_api_keys
list_project_certificates
list_project_rate_limits
list_project_service_accounts
list_project_users
list_projects
list_run_steps
list_runs
list_users
list_vector_store_files
list_vector_stores
local_shell_tool_call
local_shell_tool_call_output
mcp_tool
message
message_content_image_file_object
message_content_image_url_object
message_content_text_annotations_file_citation_object
message_content_text_annotations_file_path_object
message_content_text_object
message_delta_content_image_file_object
message_delta_content_image_url_object
message_delta_content_text_annotations_file_citation_object
message_delta_content_text_annotations_file_path_object
message_delta_content_text_object
message_delta_object
message_object
message_stream_event
moderation_image_url_input
modify_assistant
modify_assistant_request
modify_message
modify_project
modify_project_user
modify_run
modify_thread
modify_thread_request
modify_user
modify_vector_store
open_ai_file
output_message
pause_fine_tuning_job
prediction_content
project
project_api_key
project_service_account
project_user
project_user_create_request
project_user_update_request
ranking_options
realtime_conversation_item
realtime_conversation_item_content
realtime_conversation_item_with_reference
realtime_response
realtime_response_create_params
realtime_server_event_conversation_created
realtime_server_event_conversation_item_input_audio_transcription_completed
realtime_server_event_conversation_item_input_audio_transcription_failed
realtime_server_event_error
realtime_server_event_rate_limits_updated
realtime_server_event_response_content_part_added
realtime_server_event_response_content_part_done
realtime_session
realtime_session_create_request
realtime_session_create_response
realtime_transcription_session_create_request
realtime_transcription_session_create_response
reasoning
reasoning_item
response
response_format_json_schema
response_log_prob
response_modalities
response_prompt_variables
response_properties
response_reasoning_summary_part_added_event
response_reasoning_summary_part_done_event
response_usage
resume_fine_tuning_job
retrieve_batch
retrieve_container
retrieve_container_file
retrieve_container_file_content
retrieve_file
retrieve_fine_tuning_job
retrieve_invite
retrieve_model
retrieve_project
retrieve_project_api_key
retrieve_project_service_account
retrieve_project_user
retrieve_user
retrieve_vector_store_file_content
run_grader_request
run_grader_response
run_object
run_step_delta_object_delta
run_step_delta_step_details_message_creation_object
run_step_delta_step_details_tool_calls_code_object
run_step_delta_step_details_tool_calls_code_output_image_object
run_step_delta_step_details_tool_calls_function_object
run_step_details_message_creation_object
run_step_details_tool_calls_code_object
run_step_details_tool_calls_code_output_image_object
run_step_details_tool_calls_file_search_object
run_step_details_tool_calls_file_search_result_object
run_step_details_tool_calls_function_object
run_step_object
run_step_stream_event
run_stream_event
run_tool_call_object
search_vector_store
speech_audio_done_event
submit_tool_ouputs_to_run
submit_tool_outputs_run_request
submit_tool_outputs_run_request_without_stream
thread_object
thread_stream_event
tool_choice_allowed
tool_choice_types
transcript_text_delta_event
transcript_text_done_event
transcript_text_usage_tokens
truncation_object
update_chat_completion
update_conversation
update_eval
update_project_rate_limits
update_vector_store_file_attributes
upload
usage_audio_speeches
usage_audio_transcriptions
usage_code_interpreter_sessions
usage_completions
usage_costs
usage_embeddings
usage_images
usage_moderations
usage_time_bucket
usage_vector_stores
user
user_role_update_request
vad_config
validate_grader_request
validate_grader_response
vector_store_file_attributes
vector_store_file_batch_object
vector_store_file_content_response
vector_store_file_object
vector_store_object
vector_store_search_request
vector_store_search_result_content_object
web_search_preview_tool
web_search_tool_call
webhook_batch_cancelled
webhook_batch_completed
webhook_batch_expired
webhook_batch_failed
webhook_eval_run_canceled
webhook_eval_run_failed
webhook_eval_run_succeeded
webhook_fine_tuning_job_cancelled
webhook_fine_tuning_job_failed
webhook_fine_tuning_job_succeeded
webhook_response_cancelled
webhook_response_completed
webhook_response_failed
webhook_response_incomplete

Structs§

AddUploadPartRequest
AdminApiKey
Represents an individual Admin API key in an org.
ApiKeyList
ApproximateLocation
AssistantObject
Represents an assistant that can call the model and use tools.
AssistantToolsCode
AssistantToolsFileSearch
AssistantToolsFileSearchTypeOnly
AssistantToolsFunction
AssistantsNamedToolChoice
Specifies a tool the model should use. Use to force the model to call a specific tool.
AuditLog
A log of a user action or configuration change within this organization.
AuditLogActor
The actor who performed the audit logged action.
AuditLogActorApiKey
The API Key used to perform the audit logged action.
AuditLogActorServiceAccount
The service account that performed the audit logged action.
AuditLogActorSession
The session in which the audit logged action was performed.
AuditLogActorUser
The user who performed the audit logged action.
AutoChunkingStrategyRequestParam
The default strategy. This strategy currently uses a max_chunk_size_tokens of 800 and chunk_overlap_tokens of 400.
Batch
BatchError
BatchFileExpirationAfter
The expiration policy for the output and/or error file that are generated for a batch.
BatchRequestCounts
The request counts for different statuses within the batch.
BatchRequestInput
The per-line object of the batch input file
BatchRequestOutput
The per-line object of the batch output and error files
Certificate
Represents an individual certificate uploaded to the organization.
ChatCompletionAllowedTools
Constrains the tools available to the model to a pre-defined set.
ChatCompletionAllowedToolsChoice
Constrains the tools available to the model to a pre-defined set.
ChatCompletionDeleted
ChatCompletionFunctionCallOption
Specifying a particular function via {"name": "my_function"} forces the model to call that function.
ChatCompletionFunctions
ChatCompletionList
An object representing a list of Chat Completions.
ChatCompletionMessageCustomToolCall
A call to a custom tool created by the model.
ChatCompletionMessageList
An object representing a list of chat completion messages.
ChatCompletionMessageToolCall
A call to a function tool created by the model.
ChatCompletionMessageToolCallChunk
ChatCompletionNamedToolChoice
Specifies a tool the model should use. Use to force the model to call a specific function.
ChatCompletionNamedToolChoiceCustom
Specifies a tool the model should use. Use to force the model to call a specific custom tool.
ChatCompletionRequestAssistantMessage
Messages sent by the model in response to user messages.
ChatCompletionRequestDeveloperMessage
Developer-provided instructions that the model should follow, regardless of messages sent by the user. With o1 models and newer, developer messages replace the previous system messages.
ChatCompletionRequestFunctionMessage
ChatCompletionRequestMessageContentPartAudio
Learn about audio inputs.
ChatCompletionRequestMessageContentPartFile
Learn about file inputs for text generation.
ChatCompletionRequestMessageContentPartImage
Learn about image inputs.
ChatCompletionRequestMessageContentPartRefusal
ChatCompletionRequestMessageContentPartText
Learn about text inputs.
ChatCompletionRequestSystemMessage
Developer-provided instructions that the model should follow, regardless of messages sent by the user. With o1 models and newer, use developer messages for this purpose instead.
ChatCompletionRequestToolMessage
ChatCompletionRequestUserMessage
Messages sent by an end user, containing prompts or additional context information.
ChatCompletionResponseMessage
A chat completion message generated by the model.
ChatCompletionStreamOptions
Options for streaming response. Only set this when you set stream: true.
ChatCompletionStreamResponseDelta
A chat completion delta generated by streamed model responses.
ChatCompletionTokenLogprob
ChatCompletionTool
A function tool that can be used to generate a response.
Click
A click action.
CodeInterpreterFileOutput
The output of a code interpreter tool call that is a file.
CodeInterpreterOutputImage
The image output from the code interpreter.
CodeInterpreterOutputLogs
The logs output from the code interpreter.
CodeInterpreterTextOutput
The output of a code interpreter tool call that is text.
CodeInterpreterTool
A tool that runs Python code to help generate a response to a prompt.
CodeInterpreterToolAuto
Configuration for a code interpreter container. Optionally specify the IDs of the files to run the code on.
CodeInterpreterToolCall
A tool call to run code.
ComparisonFilter
A filter used to compare a specified attribute key to a given value using a defined comparison operation.
CompleteUploadRequest
CompletionUsage
Usage statistics for the completion request.
CompoundFilter
Combine multiple filters using and or or.
ComputerCallOutputItemParam
The output of a computer tool call.
ComputerCallSafetyCheckParam
A pending safety check for the computer call.
ComputerScreenshotContent
ComputerScreenshotImage
A computer screenshot image used with the computer use tool.
ComputerToolCall
A tool call to a computer use tool. See the computer use guide for more information.
ComputerToolCallOutput
The output of a computer tool call.
ComputerToolCallOutputResource
ComputerToolCallSafetyCheck
A pending safety check for the computer call.
ComputerUsePreviewTool
A tool that controls a virtual computer. Learn more about the computer tool.
ContainerFileCitationBody
A citation for a container file used to generate a model response.
ContainerFileCitationBody2
ContainerFileListResource
ContainerFileResource
ContainerListResource
ContainerResource
Conversation
Conversation2
The conversation that this response belongs to. Input items and output items from this response are automatically added to this conversation.
ConversationItemList
A list of Conversation items.
ConversationParam
The conversation that this response belongs to.
ConversationResource
Coordinate
An x/y coordinate pair, e.g. { x: 100, y: 200 }.
CostsResult
The aggregated costs details of the specific time bucket.
CreateAssistantRequest
CreateChatCompletionRequest
CreateChatCompletionResponse
Represents a chat completion response returned by model, based on the provided input.
CreateChatCompletionStreamResponse
Represents a streamed chunk of a chat completion response returned by the model, based on the provided input. Learn more.
CreateCompletionRequest
CreateCompletionResponse
Represents a completion response from the API. Note: both the streamed and non-streamed response objects share the same shape (unlike the chat endpoint).
CreateContainerBody
CreateContainerFileBody
CreateConversationRequest
Create a conversation
CreateEmbeddingRequest
CreateEmbeddingResponse
CreateEvalCompletionsRunDataSource
A CompletionsRunDataSource object describing a model sampling configuration.
CreateEvalCustomDataSourceConfig
A CustomDataSourceConfig object that defines the schema for the data source used for the evaluation runs. This schema is used to define the shape of the data that will be:
CreateEvalJsonlRunDataSource
A JsonlRunDataSource object with that specifies a JSONL file that matches the eval
CreateEvalLabelModelGrader
A LabelModelGrader object which uses a model to assign labels to each item in the evaluation.
CreateEvalLogsDataSourceConfig
A data source config which specifies the metadata property of your logs query. This is usually metadata like usecase=chatbot or prompt-version=v2, etc.
CreateEvalRequest
CreateEvalResponsesRunDataSource
A ResponsesRunDataSource object describing a model sampling configuration.
CreateEvalRunRequest
CreateEvalStoredCompletionsDataSourceConfig
Deprecated in favor of LogsDataSourceConfig.
CreateFileRequest
CreateFineTuningCheckpointPermissionRequest
CreateFineTuningJobRequest
CreateImageEditRequest
CreateImageRequest
CreateImageVariationRequest
CreateMessageRequest
CreateModelResponseProperties
CreateModerationRequest
CreateModerationResponse
Represents if a given text input is potentially harmful.
CreateResponse
CreateRunRequest
CreateRunRequestWithoutStream
CreateSpeechRequest
CreateThreadAndRunRequest
CreateThreadAndRunRequestWithoutStream
CreateThreadRequest
Options to create a new thread. If no thread is provided when running a request, an empty thread will be created.
CreateTranscriptionRequest
CreateTranscriptionResponseJson
Represents a transcription response returned by model, based on the provided input.
CreateTranscriptionResponseVerboseJson
Represents a verbose json transcription response returned by model, based on the provided input.
CreateTranslationRequest
CreateTranslationResponseJson
CreateTranslationResponseVerboseJson
CreateUploadRequest
CreateVectorStoreFileBatchRequest
CreateVectorStoreFileRequest
CreateVectorStoreRequest
CustomTool
A custom tool that processes input using a specified format. Learn more about custom tools.
CustomToolCall
A call to a custom tool created by the model.
CustomToolCallOutput
The output of a custom tool call from your code, being sent back to the model.
CustomToolChatCompletions
A custom tool that processes input using a specified format.
DeleteAssistantResponse
DeleteCertificateResponse
DeleteFileResponse
DeleteFineTuningCheckpointPermissionResponse
DeleteMessageResponse
DeleteModelResponse
DeleteThreadResponse
DeleteVectorStoreFileResponse
DeleteVectorStoreResponse
DeletedConversation
DeletedConversationResource
DoneEvent
Occurs when a stream ends.
DoubleClick
A double click action.
Drag
A drag action.
EasyInputMessage
A message input to the model with a role indicating instruction following hierarchy. Instructions given with the developer or system role take precedence over instructions given with the user role. Messages with the assistant role are presumed to have been generated by the model in previous interactions.
Embedding
Represents an embedding vector returned by embedding endpoint.
Error
ErrorEvent
Occurs when an error occurs. This can happen due to an internal server error or a timeout.
ErrorResponse
Eval
An Eval object with a data source config and testing criteria. An Eval represents a task to be done for your LLM integration. Like:
EvalApiError
An object representing an error response from the Eval API.
EvalCustomDataSourceConfig
A CustomDataSourceConfig which specifies the schema of your item and optionally sample namespaces. The response schema defines the shape of the data that will be:
EvalGraderLabelModel
EvalGraderPython
EvalGraderScoreModel
EvalGraderStringCheck
EvalGraderTextSimilarity
EvalItem
A message input to the model with a role indicating instruction following hierarchy. Instructions given with the developer or system role take precedence over instructions given with the user role. Messages with the assistant role are presumed to have been generated by the model in previous interactions.
EvalJsonlFileContentSource
EvalJsonlFileIdSource
EvalList
An object representing a list of evals.
EvalLogsDataSourceConfig
A LogsDataSourceConfig which specifies the metadata property of your logs query. This is usually metadata like usecase=chatbot or prompt-version=v2, etc. The schema returned by this data source config is used to defined what variables are available in your evals. item and sample are both defined when using this data source config.
EvalResponsesSource
A EvalResponsesSource object describing a run data source configuration.
EvalRun
A schema representing an evaluation run.
EvalRunList
An object representing a list of runs for an evaluation.
EvalRunOutputItem
A schema representing an evaluation run output item.
EvalRunOutputItemList
An object representing a list of output items for an evaluation run.
EvalStoredCompletionsDataSourceConfig
Deprecated in favor of LogsDataSourceConfig.
EvalStoredCompletionsSource
A StoredCompletionsRunDataSource configuration describing a set of filters
FileCitationBody
A citation to a file.
FileCitationBody2
FileExpirationAfter
The expiration policy for a file. By default, files with purpose=batch expire after 30 days and all other files are persisted until they are manually deleted.
FilePath
A path to a file.
FileSearchRankingOptions
The ranking options for the file search. If not specified, the file search tool will use the auto ranker and a score_threshold of 0.
FileSearchTool
A tool that searches for relevant content from uploaded files. Learn more about the file search tool.
FileSearchToolCall
The results of a file search tool call. See the file search guide for more information.
FineTuneChatCompletionRequestAssistantMessage
FineTuneChatRequestInput
The per-line training example of a fine-tuning input file for chat models using the supervised method. Input messages may contain text or image content only. Audio and file input messages are not currently supported for fine-tuning.
FineTuneDpoHyperparameters
The hyperparameters used for the DPO fine-tuning job.
FineTuneDpoMethod
Configuration for the DPO fine-tuning method.
FineTuneMethod
The method used for fine-tuning.
FineTunePreferenceRequestInput
The per-line training example of a fine-tuning input file for chat models using the dpo method. Input messages may contain text or image content only. Audio and file input messages are not currently supported for fine-tuning.
FineTuneReinforcementHyperparameters
The hyperparameters used for the reinforcement fine-tuning job.
FineTuneReinforcementMethod
Configuration for the reinforcement fine-tuning method.
FineTuneReinforcementRequestInput
Per-line training example for reinforcement fine-tuning. Note that messages and tools are the only reserved keywords. Any other arbitrary key-value data can be included on training datapoints and will be available to reference during grading under the {{ item.XXX }} template variable. Input messages may contain text or image content only. Audio and file input messages are not currently supported for fine-tuning.
FineTuneSupervisedHyperparameters
The hyperparameters used for the fine-tuning job.
FineTuneSupervisedMethod
Configuration for the supervised fine-tuning method.
FineTuningCheckpointPermission
The checkpoint.permission object represents a permission for a fine-tuned model checkpoint.
FineTuningIntegration
FineTuningJob
The fine_tuning.job object represents a fine-tuning job that has been created through the API.
FineTuningJobCheckpoint
The fine_tuning.job.checkpoint object represents a model checkpoint for a fine-tuning job that is ready to use.
FineTuningJobEvent
Fine-tuning job event object
FunctionCallOutputItemParam
The output of a function tool call.
FunctionObject
FunctionTool
Defines a function in your own code the model can choose to call. Learn more about function calling.
FunctionToolCall
A tool call to run a function. See the function calling guide for more information.
FunctionToolCallOutput
The output of a function tool call.
FunctionToolCallOutputResource
FunctionToolCallResource
GraderLabelModel
A LabelModelGrader object which uses a model to assign labels to each item in the evaluation.
GraderMulti
A MultiGrader object combines the output of multiple graders to produce a single score.
GraderPython
A PythonGrader object that runs a python script on the input.
GraderScoreModel
A ScoreModelGrader object that uses a model to assign a score to the input.
GraderStringCheck
A StringCheckGrader object that performs a string comparison between input and reference using a specified operation.
GraderTextSimilarity
A TextSimilarityGrader object which grades text based on similarity metrics.
Image
Represents the content or the URL of an image generated by the OpenAI API.
ImageEditCompletedEvent
Emitted when image editing has completed and the final image is available.
ImageEditPartialImageEvent
Emitted when a partial image is available during image editing streaming.
ImageGenCompletedEvent
Emitted when image generation has completed and the final image is available.
ImageGenInputUsageDetails
The input tokens detailed information for the image generation.
ImageGenPartialImageEvent
Emitted when a partial image is available during image generation streaming.
ImageGenTool
A tool that generates images using a model like gpt-image-1.
ImageGenToolCall
An image generation request made by the model.
ImageGenUsage
For gpt-image-1 only, the token usage information for the image generation.
ImagesResponse
The response from the image generation endpoint.
ImagesUsage
For gpt-image-1 only, the token usage information for the image generation.
InputAudio
An audio input to the model.
InputFileContent
A file input to the model.
InputFileContent2
InputImageContent
An image input to the model. Learn about image inputs.
InputImageContent2
InputMessage
A message input to the model with a role indicating instruction following hierarchy. Instructions given with the developer or system role take precedence over instructions given with the user role.
InputMessageResource
InputTextContent
A text input to the model.
InputTextContent2
Invite
Represents an individual invite to the organization.
InviteDeleteResponse
InviteListResponse
InviteRequest
ItemReferenceParam
An internal identifier for an item to reference.
KeyPress
A collection of keypresses the model would like to perform.
ListAssistantsResponse
ListAuditLogsResponse
ListBatchesResponse
ListCertificatesResponse
ListFilesResponse
ListFineTuningCheckpointPermissionResponse
ListFineTuningJobCheckpointsResponse
ListFineTuningJobEventsResponse
ListMessagesResponse
ListModelsResponse
ListPaginatedFineTuningJobsResponse
ListRunStepsResponse
ListRunsResponse
ListVectorStoreFilesResponse
ListVectorStoresResponse
LocalShellExecAction
Execute a shell command on the server.
LocalShellTool
A tool that allows the model to execute shell commands in a local environment.
LocalShellToolCall
A tool call to run a command on the local shell.
LocalShellToolCallOutput
The output of a local shell tool call.
LogProb
The log probability of a token.
LogProb2
LogProbProperties
A log probability object.
McpApprovalRequest
A request for human approval of a tool invocation.
McpApprovalResponse
A response to an MCP approval request.
McpApprovalResponseResource
A response to an MCP approval request.
McpListTools
A list of tools available on an MCP server.
McpListToolsTool
A tool available on an MCP server.
McpTool
Give the model access to additional tools via remote Model Context Protocol (MCP) servers. Learn more about MCP.
McpToolCall
An invocation of a tool on an MCP server.
McpToolFilter
A filter object to specify which tools are allowed.
Message
MessageContentImageFileObject
References an image File in the content of a message.
MessageContentImageUrlObject
References an image URL in the content of a message.
MessageContentRefusalObject
The refusal content generated by the assistant.
MessageContentTextAnnotationsFileCitationObject
A citation within the message that points to a specific quote from a specific File associated with the assistant or the message. Generated when the assistant uses the “file_search” tool to search files.
MessageContentTextAnnotationsFilePathObject
A URL for the file that’s generated when the assistant used the code_interpreter tool to generate a file.
MessageContentTextObject
The text content that is part of a message.
MessageDeltaContentImageFileObject
References an image File in the content of a message.
MessageDeltaContentImageUrlObject
References an image URL in the content of a message.
MessageDeltaContentRefusalObject
The refusal content that is part of a message.
MessageDeltaContentTextAnnotationsFileCitationObject
A citation within the message that points to a specific quote from a specific File associated with the assistant or the message. Generated when the assistant uses the “file_search” tool to search files.
MessageDeltaContentTextAnnotationsFilePathObject
A URL for the file that’s generated when the assistant used the code_interpreter tool to generate a file.
MessageDeltaContentTextObject
The text content that is part of a message.
MessageDeltaObject
Represents a message delta i.e. any changed fields on a message during streaming.
MessageObject
Represents a message within a thread.
MessageRequestContentTextObject
The text content that is part of a message.
Model
Describes an OpenAI model offering that can be used with the API.
ModelResponseProperties
ModerationImageUrlInput
An object describing an image to classify.
ModerationTextInput
An object describing text to classify.
ModifyAssistantRequest
ModifyCertificateRequest
ModifyMessageRequest
ModifyRunRequest
ModifyThreadRequest
Move
A mouse move action.
OpenAiFile
The File object represents a document that has been uploaded to OpenAI.
OtherChunkingStrategyResponseParam
This is returned when the chunking strategy is unknown. Typically, this is because the file was indexed before the chunking_strategy concept was introduced in the API.
OutputAudio
An audio output from the model.
OutputMessage
An output message from the model.
OutputTextContent
A text output from the model.
OutputTextContent2
PredictionContent
Static predicted output content, such as the content of a text file that is being regenerated.
Project
Represents an individual project.
ProjectApiKey
Represents an individual API key in a project.
ProjectApiKeyDeleteResponse
ProjectApiKeyListResponse
ProjectCreateRequest
ProjectListResponse
ProjectRateLimit
Represents a project rate limit config.
ProjectRateLimitListResponse
ProjectRateLimitUpdateRequest
ProjectServiceAccount
Represents an individual service account in a project.
ProjectServiceAccountApiKey
ProjectServiceAccountCreateRequest
ProjectServiceAccountCreateResponse
ProjectServiceAccountDeleteResponse
ProjectServiceAccountListResponse
ProjectUpdateRequest
ProjectUser
Represents an individual user in a project.
ProjectUserCreateRequest
ProjectUserDeleteResponse
ProjectUserListResponse
ProjectUserUpdateRequest
Prompt
Reference to a prompt template and its variables. Learn more.
RankingOptions
RealtimeClientEventConversationItemCreate
Add a new Item to the Conversation’s context, including messages, function calls, and function call responses. This event can be used both to populate a “history” of the conversation and to add new items mid-stream, but has the current limitation that it cannot populate assistant audio messages.
RealtimeClientEventConversationItemDelete
Send this event when you want to remove any item from the conversation history. The server will respond with a conversation.item.deleted event, unless the item does not exist in the conversation history, in which case the server will respond with an error.
RealtimeClientEventConversationItemRetrieve
Send this event when you want to retrieve the server’s representation of a specific item in the conversation history. This is useful, for example, to inspect user audio after noise cancellation and VAD. The server will respond with a conversation.item.retrieved event, unless the item does not exist in the conversation history, in which case the server will respond with an error.
RealtimeClientEventConversationItemTruncate
Send this event to truncate a previous assistant message’s audio. The server will produce audio faster than realtime, so this event is useful when the user interrupts to truncate audio that has already been sent to the client but not yet played. This will synchronize the server’s understanding of the audio with the client’s playback.
RealtimeClientEventInputAudioBufferAppend
Send this event to append audio bytes to the input audio buffer. The audio buffer is temporary storage you can write to and later commit. In Server VAD mode, the audio buffer is used to detect speech and the server will decide when to commit. When Server VAD is disabled, you must commit the audio buffer manually.
RealtimeClientEventInputAudioBufferClear
Send this event to clear the audio bytes in the buffer. The server will respond with an input_audio_buffer.cleared event.
RealtimeClientEventInputAudioBufferCommit
Send this event to commit the user input audio buffer, which will create a new user message item in the conversation. This event will produce an error if the input audio buffer is empty. When in Server VAD mode, the client does not need to send this event, the server will commit the audio buffer automatically.
RealtimeClientEventOutputAudioBufferClear
WebRTC Only: Emit to cut off the current audio response. This will trigger the server to stop generating audio and emit a output_audio_buffer.cleared event. This event should be preceded by a response.cancel client event to stop the generation of the current response. Learn more.
RealtimeClientEventResponseCancel
Send this event to cancel an in-progress response. The server will respond with a response.done event with a status of response.status=cancelled. If there is no response to cancel, the server will respond with an error.
RealtimeClientEventResponseCreate
This event instructs the server to create a Response, which means triggering model inference. When in Server VAD mode, the server will create Responses automatically.
RealtimeClientEventSessionUpdate
Send this event to update the session’s default configuration. The client may send this event at any time to update any field, except for voice. However, note that once a session has been initialized with a particular model, it can’t be changed to another model using session.update.
RealtimeClientEventTranscriptionSessionUpdate
Send this event to update a transcription session.
RealtimeConnectParams
RealtimeConversationItem
The item to add to the conversation.
RealtimeConversationItemContent
RealtimeConversationItemWithReference
The item to add to the conversation.
RealtimeResponse
The response resource.
RealtimeResponseCreateParams
Create a new Realtime response with these parameters
RealtimeServerEventConversationCreated
Returned when a conversation is created. Emitted right after session creation.
RealtimeServerEventConversationItemCreated
Returned when a conversation item is created. There are several scenarios that produce this event:
RealtimeServerEventConversationItemDeleted
Returned when an item in the conversation is deleted by the client with a conversation.item.delete event. This event is used to synchronize the server’s understanding of the conversation history with the client’s view.
RealtimeServerEventConversationItemInputAudioTranscriptionCompleted
This event is the output of audio transcription for user audio written to the user audio buffer. Transcription begins when the input audio buffer is committed by the client or server (in server_vad mode). Transcription runs asynchronously with Response creation, so this event may come before or after the Response events.
RealtimeServerEventConversationItemInputAudioTranscriptionDelta
Returned when the text value of an input audio transcription content part is updated.
RealtimeServerEventConversationItemInputAudioTranscriptionFailed
Returned when input audio transcription is configured, and a transcription request for a user message failed. These events are separate from other error events so that the client can identify the related Item.
RealtimeServerEventConversationItemRetrieved
Returned when a conversation item is retrieved with conversation.item.retrieve.
RealtimeServerEventConversationItemTruncated
Returned when an earlier assistant audio message item is truncated by the client with a conversation.item.truncate event. This event is used to synchronize the server’s understanding of the audio with the client’s playback.
RealtimeServerEventError
Returned when an error occurs, which could be a client problem or a server problem. Most errors are recoverable and the session will stay open, we recommend to implementors to monitor and log error messages by default.
RealtimeServerEventInputAudioBufferCleared
Returned when the input audio buffer is cleared by the client with a input_audio_buffer.clear event.
RealtimeServerEventInputAudioBufferCommitted
Returned when an input audio buffer is committed, either by the client or automatically in server VAD mode. The item_id property is the ID of the user message item that will be created, thus a conversation.item.created event will also be sent to the client.
RealtimeServerEventInputAudioBufferSpeechStarted
Sent by the server when in server_vad mode to indicate that speech has been detected in the audio buffer. This can happen any time audio is added to the buffer (unless speech is already detected). The client may want to use this event to interrupt audio playback or provide visual feedback to the user.
RealtimeServerEventInputAudioBufferSpeechStopped
Returned in server_vad mode when the server detects the end of speech in the audio buffer. The server will also send an conversation.item.created event with the user message item that is created from the audio buffer.
RealtimeServerEventOutputAudioBufferCleared
WebRTC Only: Emitted when the output audio buffer is cleared. This happens either in VAD mode when the user has interrupted (input_audio_buffer.speech_started), or when the client has emitted the output_audio_buffer.clear event to manually cut off the current audio response. Learn more.
RealtimeServerEventOutputAudioBufferStarted
WebRTC Only: Emitted when the server begins streaming audio to the client. This event is emitted after an audio content part has been added (response.content_part.added) to the response. Learn more.
RealtimeServerEventOutputAudioBufferStopped
WebRTC Only: Emitted when the output audio buffer has been completely drained on the server, and no more audio is forthcoming. This event is emitted after the full response data has been sent to the client (response.done). Learn more.
RealtimeServerEventRateLimitsUpdated
Emitted at the beginning of a Response to indicate the updated rate limits. When a Response is created some tokens will be “reserved” for the output tokens, the rate limits shown here reflect that reservation, which is then adjusted accordingly once the Response is completed.
RealtimeServerEventResponseAudioDelta
Returned when the model-generated audio is updated.
RealtimeServerEventResponseAudioDone
Returned when the model-generated audio is done. Also emitted when a Response is interrupted, incomplete, or cancelled.
RealtimeServerEventResponseAudioTranscriptDelta
Returned when the model-generated transcription of audio output is updated.
RealtimeServerEventResponseAudioTranscriptDone
Returned when the model-generated transcription of audio output is done streaming. Also emitted when a Response is interrupted, incomplete, or cancelled.
RealtimeServerEventResponseContentPartAdded
Returned when a new content part is added to an assistant message item during response generation.
RealtimeServerEventResponseContentPartDone
Returned when a content part is done streaming in an assistant message item. Also emitted when a Response is interrupted, incomplete, or cancelled.
RealtimeServerEventResponseCreated
Returned when a new Response is created. The first event of response creation, where the response is in an initial state of in_progress.
RealtimeServerEventResponseDone
Returned when a Response is done streaming. Always emitted, no matter the final state. The Response object included in the response.done event will include all output Items in the Response but will omit the raw audio data.
RealtimeServerEventResponseFunctionCallArgumentsDelta
Returned when the model-generated function call arguments are updated.
RealtimeServerEventResponseFunctionCallArgumentsDone
Returned when the model-generated function call arguments are done streaming. Also emitted when a Response is interrupted, incomplete, or cancelled.
RealtimeServerEventResponseOutputItemAdded
Returned when a new Item is created during Response generation.
RealtimeServerEventResponseOutputItemDone
Returned when an Item is done streaming. Also emitted when a Response is interrupted, incomplete, or cancelled.
RealtimeServerEventResponseTextDelta
Returned when the text value of a “text” content part is updated.
RealtimeServerEventResponseTextDone
Returned when the text value of a “text” content part is done streaming. Also emitted when a Response is interrupted, incomplete, or cancelled.
RealtimeServerEventSessionCreated
Returned when a Session is created. Emitted automatically when a new connection is established as the first server event. This event will contain the default Session configuration.
RealtimeServerEventSessionUpdated
Returned when a session is updated with a session.update event, unless there is an error.
RealtimeServerEventTranscriptionSessionUpdated
Returned when a transcription session is updated with a transcription_session.update event, unless there is an error.
RealtimeSession
Realtime session object configuration.
RealtimeSessionCreateRequest
Realtime session object configuration.
RealtimeSessionCreateResponse
A new Realtime session configuration, with an ephemeral key. Default TTL for keys is one minute.
RealtimeTranscriptionSessionCreateRequest
Realtime transcription session object configuration.
RealtimeTranscriptionSessionCreateResponse
A new Realtime transcription session configuration.
Reasoning
gpt-5 and o-series models only
ReasoningItem
A description of the chain of thought used by a reasoning model while generating a response. Be sure to include these items in your input to the Responses API for subsequent turns of a conversation if you are manually managing context.
RefusalContent
A refusal from the model.
RefusalContent2
Response
ResponseAudioDeltaEvent
Emitted when there is a partial audio response.
ResponseAudioDoneEvent
Emitted when the audio response is complete.
ResponseAudioTranscriptDeltaEvent
Emitted when there is a partial transcript of audio.
ResponseAudioTranscriptDoneEvent
Emitted when the full audio transcript is completed.
ResponseCodeInterpreterCallCodeDeltaEvent
Emitted when a partial code snippet is streamed by the code interpreter.
ResponseCodeInterpreterCallCodeDoneEvent
Emitted when the code snippet is finalized by the code interpreter.
ResponseCodeInterpreterCallCompletedEvent
Emitted when the code interpreter call is completed.
ResponseCodeInterpreterCallInProgressEvent
Emitted when a code interpreter call is in progress.
ResponseCodeInterpreterCallInterpretingEvent
Emitted when the code interpreter is actively interpreting the code snippet.
ResponseCompletedEvent
Emitted when the model response is complete.
ResponseContentPartAddedEvent
Emitted when a new content part is added.
ResponseContentPartDoneEvent
Emitted when a content part is done.
ResponseCreatedEvent
An event that is emitted when a response is created.
ResponseCustomToolCallInputDeltaEvent
Event representing a delta (partial update) to the input of a custom tool call.
ResponseCustomToolCallInputDoneEvent
Event indicating that input for a custom tool call is complete.
ResponseError
An error object returned when the model fails to generate a Response.
ResponseErrorEvent
Emitted when an error occurs.
ResponseFailedEvent
An event that is emitted when a response fails.
ResponseFileSearchCallCompletedEvent
Emitted when a file search call is completed (results found).
ResponseFileSearchCallInProgressEvent
Emitted when a file search call is initiated.
ResponseFileSearchCallSearchingEvent
Emitted when a file search is currently searching.
ResponseFormatJsonObject
JSON object response format. An older method of generating JSON responses. Using json_schema is recommended for models that support it. Note that the model will not generate JSON without a system or user message instructing it to do so.
ResponseFormatJsonSchema
JSON Schema response format. Used to generate structured JSON responses. Learn more about Structured Outputs.
ResponseFormatText
Default response format. Used to generate text responses.
ResponseFormatTextGrammar
A custom grammar for the model to follow when generating text. Learn more in the custom grammars guide.
ResponseFormatTextPython
Configure the model to generate valid Python code. See the custom grammars guide for more details.
ResponseFunctionCallArgumentsDeltaEvent
Emitted when there is a partial function-call arguments delta.
ResponseFunctionCallArgumentsDoneEvent
Emitted when function-call arguments are finalized.
ResponseImageGenCallCompletedEvent
Emitted when an image generation tool call has completed and the final image is available.
ResponseImageGenCallGeneratingEvent
Emitted when an image generation tool call is actively generating an image (intermediate state).
ResponseImageGenCallInProgressEvent
Emitted when an image generation tool call is in progress.
ResponseImageGenCallPartialImageEvent
Emitted when a partial image is available during image generation streaming.
ResponseInProgressEvent
Emitted when the response is in progress.
ResponseIncompleteEvent
An event that is emitted when a response finishes as incomplete.
ResponseItemList
A list of Response items.
ResponseLogProb
A logprob is the logarithmic probability that the model assigns to producing a particular token at a given position in the sequence. Less-negative (higher) logprob values indicate greater model confidence in that token choice.
ResponseMcpCallArgumentsDeltaEvent
Emitted when there is a delta (partial update) to the arguments of an MCP tool call.
ResponseMcpCallArgumentsDoneEvent
Emitted when the arguments for an MCP tool call are finalized.
ResponseMcpCallCompletedEvent
Emitted when an MCP tool call has completed successfully.
ResponseMcpCallFailedEvent
Emitted when an MCP tool call has failed.
ResponseMcpCallInProgressEvent
Emitted when an MCP tool call is in progress.
ResponseMcpListToolsCompletedEvent
Emitted when the list of available MCP tools has been successfully retrieved.
ResponseMcpListToolsFailedEvent
Emitted when the attempt to list available MCP tools has failed.
ResponseMcpListToolsInProgressEvent
Emitted when the system is in the process of retrieving the list of available MCP tools.
ResponseOutputItemAddedEvent
Emitted when a new output item is added.
ResponseOutputItemDoneEvent
Emitted when an output item is marked done.
ResponseOutputTextAnnotationAddedEvent
Emitted when an annotation is added to output text content.
ResponseProperties
ResponseQueuedEvent
Emitted when a response is queued and waiting to be processed.
ResponseReasoningSummaryPartAddedEvent
Emitted when a new reasoning summary part is added.
ResponseReasoningSummaryPartDoneEvent
Emitted when a reasoning summary part is completed.
ResponseReasoningSummaryTextDeltaEvent
Emitted when a delta is added to a reasoning summary text.
ResponseReasoningSummaryTextDoneEvent
Emitted when a reasoning summary text is completed.
ResponseReasoningTextDeltaEvent
Emitted when a delta is added to a reasoning text.
ResponseReasoningTextDoneEvent
Emitted when a reasoning text is completed.
ResponseRefusalDeltaEvent
Emitted when there is a partial refusal text.
ResponseRefusalDoneEvent
Emitted when refusal text is finalized.
ResponseStreamOptions
Options for streaming responses. Only set this when you set stream: true.
ResponseTextDeltaEvent
Emitted when there is an additional text delta.
ResponseTextDoneEvent
Emitted when text content is finalized.
ResponseUsage
Represents token usage details including input tokens, output tokens, a breakdown of output tokens, and the total tokens used.
ResponseWebSearchCallCompletedEvent
Emitted when a web search call is completed.
ResponseWebSearchCallInProgressEvent
Emitted when a web search call is initiated.
ResponseWebSearchCallSearchingEvent
Emitted when a web search call is executing.
RunCompletionUsage
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.).
RunGraderRequest
RunGraderResponse
RunObject
Represents an execution run on a thread.
RunStepCompletionUsage
Usage statistics related to the run step. This value will be null while the run step’s status is in_progress.
RunStepDeltaObject
Represents a run step delta i.e. any changed fields on a run step during streaming.
RunStepDeltaObjectDelta
The delta containing the fields that have changed on the run step.
RunStepDeltaStepDetailsMessageCreationObject
Details of the message creation by the run step.
RunStepDeltaStepDetailsToolCallsCodeObject
Details of the Code Interpreter tool call the run step was involved in.
RunStepDeltaStepDetailsToolCallsCodeOutputImageObject
RunStepDeltaStepDetailsToolCallsCodeOutputLogsObject
Text output from the Code Interpreter tool call as part of a run step.
RunStepDeltaStepDetailsToolCallsFileSearchObject
RunStepDeltaStepDetailsToolCallsFunctionObject
RunStepDeltaStepDetailsToolCallsObject
Details of the tool call.
RunStepDetailsMessageCreationObject
Details of the message creation by the run step.
RunStepDetailsToolCallsCodeObject
Details of the Code Interpreter tool call the run step was involved in.
RunStepDetailsToolCallsCodeOutputImageObject
RunStepDetailsToolCallsCodeOutputLogsObject
Text output from the Code Interpreter tool call as part of a run step.
RunStepDetailsToolCallsFileSearchObject
RunStepDetailsToolCallsFileSearchRankingOptionsObject
The ranking options for the file search.
RunStepDetailsToolCallsFileSearchResultObject
A result instance of the file search.
RunStepDetailsToolCallsFunctionObject
RunStepDetailsToolCallsObject
Details of the tool call.
RunStepObject
Represents a step in execution of a run.
RunToolCallObject
Tool call objects
Screenshot
A screenshot action.
Scroll
A scroll action.
SpeechAudioDeltaEvent
Emitted for each chunk of audio data generated during speech synthesis.
SpeechAudioDoneEvent
Emitted when the speech synthesis is complete and all audio has been streamed.
StaticChunkingStrategy
StaticChunkingStrategyRequestParam
Customize your own chunking strategy by setting chunk size and chunk overlap.
StaticChunkingStrategyResponseParam
SubmitToolOutputsRunRequest
SubmitToolOutputsRunRequestWithoutStream
SummaryTextContent
TextContent
TextResponseFormatJsonSchema
JSON Schema response format. Used to generate structured JSON responses. Learn more about Structured Outputs.
ThreadObject
Represents a thread that contains messages.
ToggleCertificatesRequest
ToolChoiceAllowed
Constrains the tools available to the model to a pre-defined set.
ToolChoiceCustom
Use this option to force the model to call a specific custom tool.
ToolChoiceFunction
Use this option to force the model to call a specific function.
ToolChoiceMcp
Use this option to force the model to call a specific tool on a remote MCP server.
ToolChoiceTypes
Indicates that the model should use a built-in tool to generate a response. Learn more about built-in tools.
TopLogProb
The top log probability of a token.
TopLogProb2
TranscriptTextDeltaEvent
Emitted when there is an additional text delta. This is also the first event emitted when the transcription starts. Only emitted when you create a transcription with the Stream parameter set to true.
TranscriptTextDoneEvent
Emitted when the transcription is complete. Contains the complete transcription text. Only emitted when you create a transcription with the Stream parameter set to true.
TranscriptTextUsageDuration
Usage statistics for models billed by audio input duration.
TranscriptTextUsageTokens
Usage statistics for models billed by token usage.
TranscriptionSegment
TranscriptionWord
TruncationObject
Controls for how a thread will be truncated prior to the run. Use this to control the initial context window of the run.
Type
An action to type in text.
UpdateConversationBody
UpdateVectorStoreFileAttributesRequest
UpdateVectorStoreRequest
Upload
The Upload object can accept byte chunks in the form of Parts.
UploadCertificateRequest
UploadPart
The upload Part represents a chunk of bytes we can add to an Upload object.
UrlCitationBody
A citation for a web resource used to generate a model response.
UrlCitationBody2
UsageAudioSpeechesResult
The aggregated audio speeches usage details of the specific time bucket.
UsageAudioTranscriptionsResult
The aggregated audio transcriptions usage details of the specific time bucket.
UsageCodeInterpreterSessionsResult
The aggregated code interpreter sessions usage details of the specific time bucket.
UsageCompletionsResult
The aggregated completions usage details of the specific time bucket.
UsageEmbeddingsResult
The aggregated embeddings usage details of the specific time bucket.
UsageImagesResult
The aggregated images usage details of the specific time bucket.
UsageModerationsResult
The aggregated moderations usage details of the specific time bucket.
UsageResponse
UsageTimeBucket
UsageVectorStoresResult
The aggregated vector stores usage details of the specific time bucket.
User
Represents an individual user within an organization.
UserDeleteResponse
UserListResponse
UserRoleUpdateRequest
VadConfig
ValidateGraderRequest
ValidateGraderResponse
VectorStoreExpirationAfter
The expiration policy for a vector store.
VectorStoreFileBatchObject
A batch of files attached to a vector store.
VectorStoreFileContentResponse
Represents the parsed content of a vector store file.
VectorStoreFileObject
A list of files attached to a vector store.
VectorStoreObject
A vector store is a collection of processed files can be used by the file_search tool.
VectorStoreSearchRequest
VectorStoreSearchResultContentObject
VectorStoreSearchResultItem
VectorStoreSearchResultsPage
Wait
A wait action.
WebSearchActionFind
Action type “find”: Searches for a pattern within a loaded page.
WebSearchActionOpenPage
Action type “open_page” - Opens a specific URL from search results.
WebSearchActionSearch
Action type “search” - Performs a web search query.
WebSearchLocation
Approximate location parameters for the search.
WebSearchPreviewTool
This tool searches the web for relevant results to use in a response. Learn more about the web search tool.
WebSearchToolCall
The results of a web search tool call. See the web search guide for more information.
WebhookBatchCancelled
Sent when a batch API request has been cancelled.
WebhookBatchCompleted
Sent when a batch API request has been completed.
WebhookBatchExpired
Sent when a batch API request has expired.
WebhookBatchFailed
Sent when a batch API request has failed.
WebhookEvalRunCanceled
Sent when an eval run has been canceled.
WebhookEvalRunFailed
Sent when an eval run has failed.
WebhookEvalRunSucceeded
Sent when an eval run has succeeded.
WebhookFineTuningJobCancelled
Sent when a fine-tuning job has been cancelled.
WebhookFineTuningJobFailed
Sent when a fine-tuning job has failed.
WebhookFineTuningJobSucceeded
Sent when a fine-tuning job has succeeded.
WebhookResponseCancelled
Sent when a background response has been cancelled.
WebhookResponseCompleted
Sent when a background response has been completed.
WebhookResponseFailed
Sent when a background response has failed.
WebhookResponseIncomplete
Sent when a background response has been interrupted.

Enums§

Annotation
Annotation2
AssistantStreamEvent
Represents an event emitted when streaming a Run.
AssistantSupportedModels
AssistantTool
AssistantsApiResponseFormatOption
Specifies the format that the model must output. Compatible with GPT-4o, GPT-4 Turbo, and all GPT-3.5 Turbo models since gpt-3.5-turbo-1106.
AssistantsApiToolChoiceOption
Controls which (if any) tool is called by the model. none means the model will not call any tools and instead generates a message. auto is the default value and 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. Specifying a particular tool like {"type": "file_search"} or {"type": "function", "function": {"name": "my_function"}} forces the model to call that tool.
AudioResponseFormat
The format of the output, in one of these options: json, text, srt, verbose_json, or vtt. For gpt-4o-transcribe and gpt-4o-mini-transcribe, the only supported format is json.
AuditLogEventType
The event type.
ChatCompletionRequestAssistantMessageContentPart
ChatCompletionRequestMessage
ChatCompletionRequestSystemMessageContentPart
ChatCompletionRequestToolMessageContentPart
ChatCompletionRequestUserMessageContentPart
ChatCompletionRole
The role of the author of a message
ChatCompletionToolChoiceOption
Controls which (if any) tool is called by the model. none means the model will not call any tool 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. Specifying a particular tool via {"type": "function", "function": {"name": "my_function"}} forces the model to call that tool.
ChatModel
ChunkingStrategyRequestParam
The chunking strategy used to chunk the file(s). If not set, will use the auto strategy. Only applicable if file_ids is non-empty.
ChunkingStrategyResponse
The strategy used to chunk the file.
ComputerAction
Content
Multi-modal input and output contents.
ConversationItem
A single item within a conversation. The set of possible types are the same as the output type of a Response object.
CreateEvalItem
A chat message that makes up the prompt or context. May include variable references to the item namespace, ie {{item.name}}.
CreateSpeechResponseStreamEvent
CreateTranscriptionResponseStreamEvent
FilePurpose
The intended purpose of the uploaded file. One of: - assistants: Used in the Assistants API - batch: Used in the Batch API - fine-tune: Used for fine-tuning - vision: Images used for vision fine-tuning - user_data: Flexible file type for any purpose - evals: Used for eval data sets
FileSearchRanker
The ranker to use for the file search. If not specified will use the auto ranker.
Filters
ImageEditStreamEvent
ImageGenStreamEvent
ImageInputFidelity
Control how much effort the model will exert to match the style and features, especially facial features, of input images. This parameter is only supported for gpt-image-1. Supports high and low. Defaults to low.
Includable
Specify additional output data to include in the model response. Currently supported values are:
InputContent
InputItem
Item
Content item used to generate a response.
ItemResource
Content item used to generate a response.
MessageContent
MessageContentDelta
MessageStreamEvent
ModelIds
ModelIdsResponses
ModelIdsShared
OutputContent
OutputItem
RealtimeClientEvent
A realtime client event.
RealtimeServerEvent
A realtime server event.
ReasoningEffort
Constrains effort on reasoning for reasoning models. Currently supported values are minimal, low, medium, and high. Reducing reasoning effort can result in faster responses and fewer tokens used on reasoning in a response.
ResponseErrorCode
The error code for the response.
ResponseStreamEvent
RunStatus
The status of the run, which can be either queued, in_progress, requires_action, cancelling, cancelled, failed, completed, incomplete, or expired.
RunStepDeltaStepDetailsToolCall
RunStepDetailsToolCall
RunStepStreamEvent
RunStreamEvent
ServiceTier
Specifies the processing type used for serving the request.
StopConfiguration
Not supported with latest reasoning models o3 and o4-mini.
TextAnnotation
TextAnnotationDelta
TextResponseFormatConfiguration
An object specifying the format that the model must output.
ThreadStreamEvent
Tool
A tool that can be used to generate a response.
ToolChoiceOptions
Controls which (if any) tool is called by the model.
TranscriptionChunkingStrategy
Controls how the audio is cut into chunks. When set to "auto", the server first normalizes loudness and then uses voice activity detection (VAD) to choose boundaries. server_vad object can be provided to tweak VAD detection parameters manually. If unset, the audio is transcribed as a single block.
TranscriptionInclude
Verbosity
Constrains the verbosity of the model’s response. Lower values will result in more concise responses, while higher values will result in more verbose responses. Currently supported values are low, medium, and high.
VoiceIdsShared
WebSearchContextSize
High level guidance for the amount of context window space to use for the search. One of low, medium, or high. medium is the default.

Type Aliases§

ChatCompletionMessageToolCalls
The tool calls generated by the model, such as function calls.
ChatCompletionModalities
Output types that you would like the model to generate for this request. Most models are capable of generating text, which is the default:
FunctionParameters
The parameters the functions accepts, described as a JSON Schema object. See the guide for examples, and the JSON Schema reference for documentation about the format.
InputMessageContentList
A list of one or many input items to the model, containing different content types.
Metadata
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.
MetadataParam
ParallelToolCalls
Whether to enable parallel function calling during tool use.
PartialImages
The number of partial images to generate. This parameter is used for streaming responses that return partial images. Value must be between 0 and 3. When set to 0, the response will be a single image sent in one streaming event.
ResponseFormatJsonSchemaSchema
The schema for the response format, described as a JSON Schema object. Learn how to build JSON schemas here.
ResponseModalities
Output types that you would like the model to generate. Most models are capable of generating text, which is the default:
ResponsePromptVariables
Optional map of values to substitute in for variables in your prompt. The substitution values can either be strings, or other Response input types like images or files.
VectorStoreFileAttributes
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, booleans, or numbers.