Crate openai_openapi_types    Copy item path  Source  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   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. 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. 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.