openai-python API reference
400 public APIs from openai-python (openai/openai-python) — 346 classes, 16 functions, 38 methods. Signatures extracted by static analysis of the actual source.
Repository: openai/openai-python
| Kind | Count |
|---|---|
| Classes | 346 |
| Functions | 16 |
| Methods | 38 |
API list
class
src.openai._base_client.BasePageDefines the core interface for pagination.
method
src.openai._client.OpenAI.conversations() -> ConversationsManage conversations and conversation items.
method
src.openai._client.OpenAI.evals() -> EvalsManage and run evals in the OpenAI platform.
method
src.openai._client.OpenAI.models() -> ModelsList and describe the various models available in the API.
method
src.openai._client.OpenAI.uploads() -> UploadsUse Uploads to upload large files in multiple parts.
class
src.openai._event_handler.EventHandlerRegistryThread-safe (optional) registry of event handlers.
func
src.openai._files.deepcopy_with_paths(item:_T, paths:Sequence[Sequence[str]]) -> _TCopy only the containers along the given paths.
func
src.openai._models.build(base_model_cls:Callable[P, _BaseModelT], *args:P.args, **kwargs:P.kwargs) -> _BaseModelTConstruct a BaseModel class without validation.
func
src.openai._models.set_pydantic_config(typ:Any, config:pydantic.ConfigDict) -> NoneAdd a pydantic config for the given type.
func
src.openai._models.validate_type(*type_:type[_T], *value:object) -> _TStrict validation that the given value matches the expected type
class
src.openai._send_queue.SendQueueBounded byte-size queue for outgoing WebSocket messages.
method
src.openai._send_queue.SendQueue.drain() -> list[str]Remove and return all queued messages.
method
src.openai._send_queue.SendQueue.enqueue(data:str) -> NoneAppend *data* to the queue.
method
src.openai._send_queue.SendQueue.flush_async(send:typing.Callable[[str], typing.Awaitable[object]]) -> NoneAsync variant of :meth:`flush_sync`.
method
src.openai._send_queue.SendQueue.flush_sync(send:typing.Callable[[str], object]) -> NoneSend every queued message via *send*.
method
src.openai._streaming.Stream.close() -> NoneClose the response and release the connection.
func
src.openai._utils._datetime_parse.parse_date(value:Union[date, StrBytesIntFloat]) -> dateParse a date/int/float/string and return a datetime.date.
func
src.openai._utils._json.openapi_dumps(obj:Any) -> bytesSerialize an object to UTF-8 encoded JSON bytes.
func
src.openai._utils._path.path_template(template:str, **kwargs:Any) -> strInterpolate {name} placeholders in `template` from keyword arguments.
class
src.openai._utils._resources_proxy.ResourcesProxyA proxy for the `openai.resources` module.
func
src.openai._utils._transform.async_maybe_transform(data:object, expected_type:object) -> Any | NoneWrapper over `async_transform()` that allows `None` to be passed.
func
src.openai._utils._transform.maybe_transform(data:object, expected_type:object) -> Any | NoneWrapper over `transform()` that allows `None` to be passed.
func
src.openai._utils._typing.is_iterable_type(typ:type) -> boolIf the given type is `typing.Iterable[T]`
func
src.openai._utils._utils.quote(string:str) -> strAdd single quotation marks around the given string.
func
src.openai._utils._utils.removeprefix(string:str, prefix:str) -> strRemove a prefix from a string.
func
src.openai._utils._utils.removesuffix(string:str, suffix:str) -> strRemove a suffix from a string.
class
src.openai.auth._workload.WorkloadIdentityIdentity provider resource id in WIFAPI.
func
src.openai.lib._pydantic.is_dataclass_like_type(typ:type) -> boolReturns True if the given type likely used `@pydantic.dataclass`
func
src.openai.lib._validators.estimate_fine_tuning_time(df:pd.DataFrame) -> NoneEstimate the time it'll take to fine-tune the dataset
func
src.openai.lib._validators.infer_task_type(df:pd.DataFrame) -> strInfer the likely fine-tuning task type from the data
method
src.openai.resources.audio.audio.Audio.speech() -> SpeechTurn audio into text or text into audio.
method
src.openai.resources.audio.audio.Audio.transcriptions() -> TranscriptionsTurn audio into text or text into audio.
method
src.openai.resources.audio.audio.Audio.translations() -> TranslationsTurn audio into text or text into audio.
class
src.openai.resources.audio.speech.AsyncSpeechTurn audio into text or text into audio.
class
src.openai.resources.audio.speech.SpeechTurn audio into text or text into audio.
class
src.openai.resources.audio.transcriptions.AsyncTranscriptionsTurn audio into text or text into audio.
class
src.openai.resources.audio.transcriptions.TranscriptionsTurn audio into text or text into audio.
class
src.openai.resources.audio.translations.AsyncTranslationsTurn audio into text or text into audio.
class
src.openai.resources.audio.translations.TranslationsTurn audio into text or text into audio.
method
src.openai.resources.batches.AsyncBatches.retrieve(batch_id:str, *extra_headers:Headers | None=None, *extra_query:Query | None=None, *extra_body:Body | None=None, *timeout:float | httpx.Timeout | None | NotGiven=not_given) -> BatchRetrieves a batch.
class
src.openai.resources.batches.BatchesCreate large batches of API requests to run asynchronously.
method
src.openai.resources.batches.Batches.retrieve(batch_id:str, *extra_headers:Headers | None=None, *extra_query:Query | None=None, *extra_body:Body | None=None, *timeout:float | httpx.Timeout | None | NotGiven=not_given) -> BatchRetrieves a batch.
class
src.openai.resources.beta.assistants.AssistantsBuild Assistants that can call models and use tools.
method
src.openai.resources.beta.assistants.Assistants.delete(assistant_id:str, *extra_headers:Headers | None=None, *extra_query:Query | None=None, *extra_body:Body | None=None, *timeout:float | httpx.Timeout | None | NotGiven=not_given) -> AssistantDeletedDelete an assistant.
class
src.openai.resources.beta.assistants.AsyncAssistantsBuild Assistants that can call models and use tools.
method
src.openai.resources.beta.beta.Beta.assistants() -> AssistantsBuild Assistants that can call models and use tools.
method
src.openai.resources.beta.beta.Beta.threads() -> ThreadsBuild Assistants that can call models and use tools.
class
src.openai.resources.beta.threads.messages.AsyncMessagesBuild Assistants that can call models and use tools.
class
src.openai.resources.beta.threads.messages.MessagesBuild Assistants that can call models and use tools.
class
src.openai.resources.beta.threads.runs.runs.AsyncRunsBuild Assistants that can call models and use tools.
method
src.openai.resources.beta.threads.runs.runs.AsyncRuns.retrieve(run_id:str, *thread_id:str, *extra_headers:Headers | None=None, *extra_query:Query | None=None, *extra_body:Body | None=None, *timeout:float | httpx.Timeout | None | NotGiven=not_given) -> RunRetrieves a run.
class
src.openai.resources.beta.threads.runs.runs.RunsBuild Assistants that can call models and use tools.
method
src.openai.resources.beta.threads.runs.runs.Runs.retrieve(run_id:str, *thread_id:str, *extra_headers:Headers | None=None, *extra_query:Query | None=None, *extra_body:Body | None=None, *timeout:float | httpx.Timeout | None | NotGiven=not_given) -> RunRetrieves a run.
class
src.openai.resources.beta.threads.runs.steps.AsyncStepsBuild Assistants that can call models and use tools.
class
src.openai.resources.beta.threads.runs.steps.StepsBuild Assistants that can call models and use tools.
class
src.openai.resources.beta.threads.threads.AsyncThreadsBuild Assistants that can call models and use tools.
method
src.openai.resources.beta.threads.threads.AsyncThreads.delete(thread_id:str, *extra_headers:Headers | None=None, *extra_query:Query | None=None, *extra_body:Body | None=None, *timeout:float | httpx.Timeout | None | NotGiven=not_given) -> ThreadDeletedDelete a thread.
method
src.openai.resources.beta.threads.threads.AsyncThreads.retrieve(thread_id:str, *extra_headers:Headers | None=None, *extra_query:Query | None=None, *extra_body:Body | None=None, *timeout:float | httpx.Timeout | None | NotGiven=not_given) -> ThreadRetrieves a thread.
class
src.openai.resources.beta.threads.threads.ThreadsBuild Assistants that can call models and use tools.
method
src.openai.resources.beta.threads.threads.Threads.delete(thread_id:str, *extra_headers:Headers | None=None, *extra_query:Query | None=None, *extra_body:Body | None=None, *timeout:float | httpx.Timeout | None | NotGiven=not_given) -> ThreadDeletedDelete a thread.
method
src.openai.resources.beta.threads.threads.Threads.retrieve(thread_id:str, *extra_headers:Headers | None=None, *extra_query:Query | None=None, *extra_body:Body | None=None, *timeout:float | httpx.Timeout | None | NotGiven=not_given) -> ThreadRetrieves a thread.
class
src.openai.resources.conversations.conversations.AsyncConversationsManage conversations and conversation items.
class
src.openai.resources.conversations.conversations.ConversationsManage conversations and conversation items.
method
src.openai.resources.conversations.conversations.Conversations.items() -> ItemsManage conversations and conversation items.
class
src.openai.resources.conversations.items.AsyncItemsManage conversations and conversation items.
class
src.openai.resources.conversations.items.ItemsManage conversations and conversation items.
class
src.openai.resources.evals.evals.AsyncEvalsManage and run evals in the OpenAI platform.
method
src.openai.resources.evals.evals.AsyncEvals.delete(eval_id:str, *extra_headers:Headers | None=None, *extra_query:Query | None=None, *extra_body:Body | None=None, *timeout:float | httpx.Timeout | None | NotGiven=not_given) -> EvalDeleteResponseDelete an evaluation.
method
src.openai.resources.evals.evals.AsyncEvals.runs() -> AsyncRunsManage and run evals in the OpenAI platform.
class
src.openai.resources.evals.evals.EvalsManage and run evals in the OpenAI platform.
method
src.openai.resources.evals.evals.Evals.delete(eval_id:str, *extra_headers:Headers | None=None, *extra_query:Query | None=None, *extra_body:Body | None=None, *timeout:float | httpx.Timeout | None | NotGiven=not_given) -> EvalDeleteResponseDelete an evaluation.
method
src.openai.resources.evals.evals.Evals.runs() -> RunsManage and run evals in the OpenAI platform.
class
src.openai.resources.evals.runs.output_items.AsyncOutputItemsManage and run evals in the OpenAI platform.
class
src.openai.resources.evals.runs.output_items.OutputItemsManage and run evals in the OpenAI platform.
class
src.openai.resources.evals.runs.runs.AsyncRunsManage and run evals in the OpenAI platform.
method
src.openai.resources.evals.runs.runs.AsyncRuns.output_items() -> AsyncOutputItemsManage and run evals in the OpenAI platform.
class
src.openai.resources.evals.runs.runs.RunsManage and run evals in the OpenAI platform.
method
src.openai.resources.evals.runs.runs.Runs.delete(run_id:str, *eval_id:str, *extra_headers:Headers | None=None, *extra_query:Query | None=None, *extra_body:Body | None=None, *timeout:float | httpx.Timeout | None | NotGiven=not_given) -> RunDeleteResponseDelete an eval run.
method
src.openai.resources.evals.runs.runs.Runs.output_items() -> OutputItemsManage and run evals in the OpenAI platform.
class
src.openai.resources.models.ModelsList and describe the various models available in the API.
method
src.openai.resources.models.Models.delete(model:str, *extra_headers:Headers | None=None, *extra_query:Query | None=None, *extra_body:Body | None=None, *timeout:float | httpx.Timeout | None | NotGiven=not_given) -> ModelDeletedDelete a fine-tuned model.
method
src.openai.resources.realtime.realtime.RealtimeConnection.off(event_type:str, handler:Callable[..., Any]) -> RealtimeConnectionRemove a previously registered event handler.
method
src.openai.resources.skills.skills.AsyncSkills.retrieve(skill_id:str, *extra_headers:Headers | None=None, *extra_query:Query | None=None, *extra_body:Body | None=None, *timeout:float | httpx.Timeout | None | NotGiven=not_given) -> SkillGet a skill by its ID.
method
src.openai.resources.skills.skills.Skills.retrieve(skill_id:str, *extra_headers:Headers | None=None, *extra_query:Query | None=None, *extra_body:Body | None=None, *timeout:float | httpx.Timeout | None | NotGiven=not_given) -> SkillGet a skill by its ID.
class
src.openai.resources.uploads.parts.AsyncPartsUse Uploads to upload large files in multiple parts.
class
src.openai.resources.uploads.parts.PartsUse Uploads to upload large files in multiple parts.
class
src.openai.resources.uploads.uploads.AsyncUploadsUse Uploads to upload large files in multiple parts.
method
src.openai.resources.uploads.uploads.AsyncUploads.cancel(upload_id:str, *extra_headers:Headers | None=None, *extra_query:Query | None=None, *extra_body:Body | None=None, *timeout:float | httpx.Timeout | None | NotGiven=not_given) -> UploadCancels the Upload.
class
src.openai.resources.uploads.uploads.UploadsUse Uploads to upload large files in multiple parts.
method
src.openai.resources.uploads.uploads.Uploads.cancel(upload_id:str, *extra_headers:Headers | None=None, *extra_query:Query | None=None, *extra_body:Body | None=None, *timeout:float | httpx.Timeout | None | NotGiven=not_given) -> UploadCancels the Upload.
method
src.openai.resources.uploads.uploads.Uploads.parts() -> PartsUse Uploads to upload large files in multiple parts.
class
src.openai.types.admin.organization.admin_api_key.AdminAPIKeyRepresents an individual Admin API key in an org.
class
src.openai.types.admin.organization.audit_log_list_response.APIKeyCreatedThe details for events with this `type`.
class
src.openai.types.admin.organization.audit_log_list_response.APIKeyCreatedDataThe payload used to create the API key.
class
src.openai.types.admin.organization.audit_log_list_response.APIKeyDeletedThe details for events with this `type`.
class
src.openai.types.admin.organization.audit_log_list_response.APIKeyUpdatedThe details for events with this `type`.
class
src.openai.types.admin.organization.audit_log_list_response.APIKeyUpdatedChangesRequestedThe payload used to update the API key.
class
src.openai.types.admin.organization.audit_log_list_response.ActorThe actor who performed the audit logged action.
class
src.openai.types.admin.organization.audit_log_list_response.CertificateCreatedThe details for events with this `type`.
class
src.openai.types.admin.organization.audit_log_list_response.CertificateDeletedThe details for events with this `type`.
class
src.openai.types.admin.organization.audit_log_list_response.CertificateUpdatedThe details for events with this `type`.
class
src.openai.types.admin.organization.audit_log_list_response.CertificatesActivatedThe details for events with this `type`.
class
src.openai.types.admin.organization.audit_log_list_response.CertificatesDeactivatedThe details for events with this `type`.
class
src.openai.types.admin.organization.audit_log_list_response.CheckpointPermissionDeletedThe details for events with this `type`.
class
src.openai.types.admin.organization.audit_log_list_response.ExternalKeyRegisteredThe details for events with this `type`.
class
src.openai.types.admin.organization.audit_log_list_response.ExternalKeyRemovedThe details for events with this `type`.
class
src.openai.types.admin.organization.audit_log_list_response.GroupCreatedThe details for events with this `type`.
class
src.openai.types.admin.organization.audit_log_list_response.GroupCreatedDataInformation about the created group.
class
src.openai.types.admin.organization.audit_log_list_response.GroupDeletedThe details for events with this `type`.
class
src.openai.types.admin.organization.audit_log_list_response.GroupUpdatedThe details for events with this `type`.
class
src.openai.types.admin.organization.audit_log_list_response.GroupUpdatedChangesRequestedThe payload used to update the group.
class
src.openai.types.admin.organization.audit_log_list_response.IPAllowlistConfigActivatedThe details for events with this `type`.
class
src.openai.types.admin.organization.audit_log_list_response.IPAllowlistConfigDeactivatedThe details for events with this `type`.
class
src.openai.types.admin.organization.audit_log_list_response.IPAllowlistCreatedThe details for events with this `type`.
class
src.openai.types.admin.organization.audit_log_list_response.IPAllowlistDeletedThe details for events with this `type`.
class
src.openai.types.admin.organization.audit_log_list_response.IPAllowlistUpdatedThe details for events with this `type`.
class
src.openai.types.admin.organization.audit_log_list_response.InviteAcceptedThe details for events with this `type`.
class
src.openai.types.admin.organization.audit_log_list_response.InviteDeletedThe details for events with this `type`.
class
src.openai.types.admin.organization.audit_log_list_response.InviteSentThe details for events with this `type`.
class
src.openai.types.admin.organization.audit_log_list_response.InviteSentDataThe payload used to create the invite.
class
src.openai.types.admin.organization.audit_log_list_response.LoginFailedThe details for events with this `type`.
class
src.openai.types.admin.organization.audit_log_list_response.LogoutFailedThe details for events with this `type`.
class
src.openai.types.admin.organization.audit_log_list_response.OrganizationUpdatedThe details for events with this `type`.
class
src.openai.types.admin.organization.audit_log_list_response.ProjectThe project that the action was scoped to.
class
src.openai.types.admin.organization.audit_log_list_response.ProjectArchivedThe details for events with this `type`.
class
src.openai.types.admin.organization.audit_log_list_response.ProjectCreatedThe details for events with this `type`.
class
src.openai.types.admin.organization.audit_log_list_response.ProjectCreatedDataThe payload used to create the project.
class
src.openai.types.admin.organization.audit_log_list_response.ProjectDeletedThe details for events with this `type`.
class
src.openai.types.admin.organization.audit_log_list_response.ProjectUpdatedThe details for events with this `type`.
class
src.openai.types.admin.organization.audit_log_list_response.ProjectUpdatedChangesRequestedThe payload used to update the project.
class
src.openai.types.admin.organization.audit_log_list_response.RateLimitDeletedThe details for events with this `type`.
class
src.openai.types.admin.organization.audit_log_list_response.RateLimitUpdatedThe details for events with this `type`.
class
src.openai.types.admin.organization.audit_log_list_response.RoleAssignmentCreatedThe details for events with this `type`.
class
src.openai.types.admin.organization.audit_log_list_response.RoleAssignmentDeletedThe details for events with this `type`.
class
src.openai.types.admin.organization.audit_log_list_response.RoleBoundToResourceThe details for events with this `type`.
class
src.openai.types.admin.organization.audit_log_list_response.RoleCreatedThe details for events with this `type`.
class
src.openai.types.admin.organization.audit_log_list_response.RoleDeletedThe details for events with this `type`.
class
src.openai.types.admin.organization.audit_log_list_response.RoleUnboundFromResourceThe details for events with this `type`.
class
src.openai.types.admin.organization.audit_log_list_response.RoleUpdatedThe details for events with this `type`.
class
src.openai.types.admin.organization.audit_log_list_response.RoleUpdatedChangesRequestedThe payload used to update the role.
class
src.openai.types.admin.organization.audit_log_list_response.ScimDisabledThe details for events with this `type`.
class
src.openai.types.admin.organization.audit_log_list_response.ScimEnabledThe details for events with this `type`.
class
src.openai.types.admin.organization.audit_log_list_response.ServiceAccountCreatedThe details for events with this `type`.
class
src.openai.types.admin.organization.audit_log_list_response.ServiceAccountDeletedThe details for events with this `type`.
class
src.openai.types.admin.organization.audit_log_list_response.ServiceAccountUpdatedThe details for events with this `type`.
class
src.openai.types.admin.organization.audit_log_list_response.UserAddedThe details for events with this `type`.
class
src.openai.types.admin.organization.audit_log_list_response.UserDeletedThe details for events with this `type`.
class
src.openai.types.admin.organization.audit_log_list_response.UserUpdatedThe details for events with this `type`.
class
src.openai.types.admin.organization.audit_log_list_response.UserUpdatedChangesRequestedThe payload used to update the user.
class
src.openai.types.admin.organization.group.GroupDetails about an organization group.
class
src.openai.types.admin.organization.group_update_response.GroupUpdateResponseResponse returned after updating a group.
class
src.openai.types.admin.organization.groups.role_create_response.RoleCreateResponseRole assignment linking a group to a role.
class
src.openai.types.admin.organization.invite.InviteRepresents an individual `invite` to the organization.
class
src.openai.types.admin.organization.organization_user.ProjectsProjects associated with the user, if included.
class
src.openai.types.admin.organization.organization_user.UserNested user details.
class
src.openai.types.admin.organization.project.ProjectRepresents an individual project.
class
src.openai.types.admin.organization.projects.hosted_tool_permission_update_params.FileSearchThe file search permission update.
class
src.openai.types.admin.organization.projects.hosted_tool_permission_update_params.McpThe MCP permission update.
class
src.openai.types.admin.organization.projects.hosted_tool_permission_update_params.WebSearchThe web search permission update.
class
src.openai.types.admin.organization.projects.project_api_key.OwnerUserThe user that owns a project API key.
class
src.openai.types.admin.organization.projects.project_rate_limit.ProjectRateLimitRepresents a project rate limit config.
class
src.openai.types.admin.organization.projects.project_user.ProjectUserRepresents an individual user in a project.
class
src.openai.types.admin.organization.users.role_create_response.RoleCreateResponseRole assignment linking a user to a role.
class
src.openai.types.audio.speech_create_params.VoiceIDCustom voice reference.
class
src.openai.types.audio.transcription.UsageTokensUsage statistics for models billed by token usage.
class
src.openai.types.audio.transcription_diarized.UsageTokensUsage statistics for models billed by token usage.
class
src.openai.types.audio.transcription_language.TranscriptionLanguageA language detected in transcribed audio.
class
src.openai.types.audio.transcription_text_done_event.TranscriptionTextDoneEventEmitted when the transcription is complete.
class
src.openai.types.audio.transcription_text_done_event.UsageUsage statistics for models billed by token usage.
class
src.openai.types.auto_file_chunking_strategy_param.AutoFileChunkingStrategyParamThe default strategy.
class
src.openai.types.batch_usage.InputTokensDetailsA detailed breakdown of the input tokens.
class
src.openai.types.batch_usage.OutputTokensDetailsA detailed breakdown of the output tokens.
class
src.openai.types.beta.assistant_create_params.ToolResourcesFileSearchVectorStoreChunkingStrategyAutoThe default strategy.
class
src.openai.types.beta.assistant_tool_choice.AssistantToolChoiceSpecifies a tool the model should use.
class
src.openai.types.beta.assistant_tool_choice_param.AssistantToolChoiceParamSpecifies a tool the model should use.
class
src.openai.types.beta.beta_computer_action.ClickA click action.
class
src.openai.types.beta.beta_computer_action.DoubleClickA double click action.
class
src.openai.types.beta.beta_computer_action.DragA drag action.
class
src.openai.types.beta.beta_computer_action.DragPathAn x/y coordinate pair, e.g.
class
src.openai.types.beta.beta_computer_action.MoveA mouse move action.
class
src.openai.types.beta.beta_computer_action.ScreenshotA screenshot action.
class
src.openai.types.beta.beta_computer_action.ScrollA scroll action.
class
src.openai.types.beta.beta_computer_action.TypeAn action to type in text.
class
src.openai.types.beta.beta_computer_action.WaitA wait action.
class
src.openai.types.beta.beta_computer_action_list_param.ClickA click action.
class
src.openai.types.beta.beta_computer_action_list_param.DoubleClickA double click action.
class
src.openai.types.beta.beta_computer_action_list_param.DragA drag action.
class
src.openai.types.beta.beta_computer_action_list_param.DragPathAn x/y coordinate pair, e.g.
class
src.openai.types.beta.beta_computer_action_list_param.MoveA mouse move action.
class
src.openai.types.beta.beta_computer_action_list_param.ScreenshotA screenshot action.
class
src.openai.types.beta.beta_computer_action_list_param.ScrollA scroll action.
class
src.openai.types.beta.beta_computer_action_list_param.TypeAn action to type in text.
class
src.openai.types.beta.beta_computer_action_list_param.WaitA wait action.
class
src.openai.types.beta.beta_computer_action_param.ClickA click action.
class
src.openai.types.beta.beta_computer_action_param.DoubleClickA double click action.
class
src.openai.types.beta.beta_computer_action_param.DragA drag action.
class
src.openai.types.beta.beta_computer_action_param.DragPathAn x/y coordinate pair, e.g.
class
src.openai.types.beta.beta_computer_action_param.MoveA mouse move action.
class
src.openai.types.beta.beta_computer_action_param.ScreenshotA screenshot action.
class
src.openai.types.beta.beta_computer_action_param.ScrollA scroll action.
class
src.openai.types.beta.beta_computer_action_param.TypeAn action to type in text.
class
src.openai.types.beta.beta_computer_action_param.WaitA wait action.
class
src.openai.types.beta.beta_computer_tool.BetaComputerToolA tool that controls a virtual computer.
class
src.openai.types.beta.beta_computer_tool_param.BetaComputerToolParamA tool that controls a virtual computer.
class
src.openai.types.beta.beta_computer_use_preview_tool.BetaComputerUsePreviewToolA tool that controls a virtual computer.
class
src.openai.types.beta.beta_custom_tool.FormatGrammarA grammar defined by the user.
class
src.openai.types.beta.beta_custom_tool.FormatTextUnconstrained free-form text.
class
src.openai.types.beta.beta_custom_tool_param.FormatGrammarA grammar defined by the user.
class
src.openai.types.beta.beta_custom_tool_param.FormatTextUnconstrained free-form text.
class
src.openai.types.beta.beta_file_search_tool.FiltersCompoundFilterCombine multiple filters using `and` or `or`.
class
src.openai.types.beta.beta_file_search_tool.RankingOptionsRanking options for search.
class
src.openai.types.beta.beta_file_search_tool_param.FiltersCompoundFilterCombine multiple filters using `and` or `or`.
class
src.openai.types.beta.beta_file_search_tool_param.RankingOptionsRanking options for search.
class
src.openai.types.beta.beta_inline_skill_source.BetaInlineSkillSourceInline skill payload
class
src.openai.types.beta.beta_inline_skill_source_param.BetaInlineSkillSourceParamInline skill payload
class
src.openai.types.beta.beta_response.ConversationThe conversation that this response belonged to.
class
src.openai.types.beta.beta_response.IncompleteDetailsDetails about why the response is incomplete.
class
src.openai.types.beta.beta_response_apply_patch_tool_call.AgentThe agent that produced this item.
class
src.openai.types.beta.beta_response_apply_patch_tool_call_output.AgentThe agent that produced this item.
class
src.openai.types.beta.beta_response_code_interpreter_tool_call.AgentThe agent that produced this item.
class
src.openai.types.beta.beta_response_code_interpreter_tool_call.BetaResponseCodeInterpreterToolCallA tool call to run code.
class
src.openai.types.beta.beta_response_code_interpreter_tool_call.OutputImageThe image output from the code interpreter.
class
src.openai.types.beta.beta_response_code_interpreter_tool_call.OutputLogsThe logs output from the code interpreter.
class
src.openai.types.beta.beta_response_code_interpreter_tool_call_param.AgentThe agent that produced this item.
class
src.openai.types.beta.beta_response_code_interpreter_tool_call_param.BetaResponseCodeInterpreterToolCallParamA tool call to run code.
class
src.openai.types.beta.beta_response_code_interpreter_tool_call_param.OutputImageThe image output from the code interpreter.
class
src.openai.types.beta.beta_response_code_interpreter_tool_call_param.OutputLogsThe logs output from the code interpreter.
class
src.openai.types.beta.beta_response_compaction_item.AgentThe agent that produced this item.
class
src.openai.types.beta.beta_response_compaction_item_param.AgentThe agent that produced this item.
class
src.openai.types.beta.beta_response_compaction_item_param_param.AgentThe agent that produced this item.
class
src.openai.types.beta.beta_response_completed_event.BetaResponseCompletedEventEmitted when the model response is complete.
class
src.openai.types.beta.beta_response_computer_tool_call.AgentThe agent that produced this item.
class
src.openai.types.beta.beta_response_computer_tool_call.BetaResponseComputerToolCallA tool call to a computer use tool.
class
src.openai.types.beta.beta_response_computer_tool_call.PendingSafetyCheckA pending safety check for the computer call.
class
src.openai.types.beta.beta_response_computer_tool_call_output_item.AgentThe agent that produced this item.
class
src.openai.types.beta.beta_response_computer_tool_call_param.AgentThe agent that produced this item.
class
src.openai.types.beta.beta_response_computer_tool_call_param.BetaResponseComputerToolCallParamA tool call to a computer use tool.
class
src.openai.types.beta.beta_response_content_part_added_event.PartReasoningTextReasoning text from the model.
class
src.openai.types.beta.beta_response_content_part_done_event.BetaResponseContentPartDoneEventEmitted when a content part is done.
class
src.openai.types.beta.beta_response_content_part_done_event.PartReasoningTextReasoning text from the model.
class
src.openai.types.beta.beta_response_custom_tool_call.AgentThe agent that produced this item.
class
src.openai.types.beta.beta_response_custom_tool_call_output.AgentThe agent that produced this item.
class
src.openai.types.beta.beta_response_custom_tool_call_output_param.AgentThe agent that produced this item.
class
src.openai.types.beta.beta_response_custom_tool_call_param.AgentThe agent that produced this item.
class
src.openai.types.beta.beta_response_error_event.BetaResponseErrorEventEmitted when an error occurs.
class
src.openai.types.beta.beta_response_file_search_tool_call.AgentThe agent that produced this item.
class
src.openai.types.beta.beta_response_file_search_tool_call.BetaResponseFileSearchToolCallThe results of a file search tool call.
class
src.openai.types.beta.beta_response_file_search_tool_call_param.AgentThe agent that produced this item.
class
src.openai.types.beta.beta_response_format_text_config.JSONObjectJSON object response format.
class
src.openai.types.beta.beta_response_format_text_config.TextDefault response format.
class
src.openai.types.beta.beta_response_format_text_config_param.JSONObjectJSON object response format.
class
src.openai.types.beta.beta_response_format_text_config_param.TextDefault response format.
class
src.openai.types.beta.beta_response_format_text_json_schema_config.BetaResponseFormatTextJSONSchemaConfigJSON Schema response format.
class
src.openai.types.beta.beta_response_format_text_json_schema_config_param.BetaResponseFormatTextJSONSchemaConfigParamJSON Schema response format.
class
src.openai.types.beta.beta_response_function_shell_tool_call.AgentThe agent that produced this item.
class
src.openai.types.beta.beta_response_function_shell_tool_call_output.AgentThe agent that produced this item.
class
src.openai.types.beta.beta_response_function_tool_call.AgentThe agent that produced this item.
class
src.openai.types.beta.beta_response_function_tool_call.BetaResponseFunctionToolCallA tool call to run a function.
class
src.openai.types.beta.beta_response_function_tool_call_item.BetaResponseFunctionToolCallItemA tool call to run a function.
class
src.openai.types.beta.beta_response_function_tool_call_output_item.AgentThe agent that produced this item.
class
src.openai.types.beta.beta_response_function_tool_call_param.AgentThe agent that produced this item.
class
src.openai.types.beta.beta_response_function_tool_call_param.BetaResponseFunctionToolCallParamA tool call to run a function.
class
src.openai.types.beta.beta_response_function_web_search.ActionSearchSourceA source used in the search.
class
src.openai.types.beta.beta_response_function_web_search.AgentThe agent that produced this item.
class
src.openai.types.beta.beta_response_function_web_search.BetaResponseFunctionWebSearchThe results of a web search tool call.
class
src.openai.types.beta.beta_response_function_web_search_param.ActionSearchSourceA source used in the search.
class
src.openai.types.beta.beta_response_function_web_search_param.AgentThe agent that produced this item.
class
src.openai.types.beta.beta_response_in_progress_event.BetaResponseInProgressEventEmitted when the response is in progress.
class
src.openai.types.beta.beta_response_inject_failed_event.ErrorInformation about why the input was not committed.
class
src.openai.types.beta.beta_response_input_file.BetaResponseInputFileA file input to the model.
class
src.openai.types.beta.beta_response_input_file_content.BetaResponseInputFileContentA file input to the model.
class
src.openai.types.beta.beta_response_input_file_content_param.BetaResponseInputFileContentParamA file input to the model.
class
src.openai.types.beta.beta_response_input_file_param.BetaResponseInputFileParamA file input to the model.
class
src.openai.types.beta.beta_response_input_image.BetaResponseInputImageAn image input to the model.
class
src.openai.types.beta.beta_response_input_image_content.BetaResponseInputImageContentAn image input to the model.
class
src.openai.types.beta.beta_response_input_image_content_param.BetaResponseInputImageContentParamAn image input to the model.
class
src.openai.types.beta.beta_response_input_image_param.BetaResponseInputImageParamAn image input to the model.
class
src.openai.types.beta.beta_response_input_item.AdditionalToolsAgentThe agent that produced this item.
class
src.openai.types.beta.beta_response_input_item.AgentMessageA message routed between agents.
class
src.openai.types.beta.beta_response_input_item.AgentMessageAgentThe agent that produced this item.
class
src.openai.types.beta.beta_response_input_item.ApplyPatchCallAgentThe agent that produced this item.
class
src.openai.types.beta.beta_response_input_item.ApplyPatchCallOutputAgentThe agent that produced this item.
class
src.openai.types.beta.beta_response_input_item.CompactionTriggerCompacts the current context.
class
src.openai.types.beta.beta_response_input_item.CompactionTriggerAgentThe agent that produced this item.
class
src.openai.types.beta.beta_response_input_item.ComputerCallOutputThe output of a computer tool call.
class
src.openai.types.beta.beta_response_input_item.ComputerCallOutputAgentThe agent that produced this item.
class
src.openai.types.beta.beta_response_input_item.FunctionCallOutputThe output of a function tool call.
class
src.openai.types.beta.beta_response_input_item.FunctionCallOutputAgentThe agent that produced this item.
class
src.openai.types.beta.beta_response_input_item.ImageGenerationCallAn image generation request made by the model.
class
src.openai.types.beta.beta_response_input_item.ImageGenerationCallAgentThe agent that produced this item.
class
src.openai.types.beta.beta_response_input_item.ItemReferenceAn internal identifier for an item to reference.
class
src.openai.types.beta.beta_response_input_item.ItemReferenceAgentThe agent that produced this item.
class
src.openai.types.beta.beta_response_input_item.LocalShellCallA tool call to run a command on the local shell.
class
src.openai.types.beta.beta_response_input_item.LocalShellCallActionExecute a shell command on the server.
class
src.openai.types.beta.beta_response_input_item.LocalShellCallAgentThe agent that produced this item.
class
src.openai.types.beta.beta_response_input_item.LocalShellCallOutputThe output of a local shell tool call.
class
src.openai.types.beta.beta_response_input_item.LocalShellCallOutputAgentThe agent that produced this item.
class
src.openai.types.beta.beta_response_input_item.McpApprovalRequestAgentThe agent that produced this item.
class
src.openai.types.beta.beta_response_input_item.McpApprovalResponseA response to an MCP approval request.
class
src.openai.types.beta.beta_response_input_item.McpApprovalResponseAgentThe agent that produced this item.
class
src.openai.types.beta.beta_response_input_item.McpCallAn invocation of a tool on an MCP server.
class
src.openai.types.beta.beta_response_input_item.McpCallAgentThe agent that produced this item.
class
src.openai.types.beta.beta_response_input_item.McpListToolsA list of tools available on an MCP server.
class
src.openai.types.beta.beta_response_input_item.McpListToolsAgentThe agent that produced this item.
class
src.openai.types.beta.beta_response_input_item.McpListToolsToolA tool available on an MCP server.
class
src.openai.types.beta.beta_response_input_item.MessageAgentThe agent that produced this item.
class
src.openai.types.beta.beta_response_input_item.MultiAgentCallAgentThe agent that produced this item.
class
src.openai.types.beta.beta_response_input_item.MultiAgentCallOutputAgentThe agent that produced this item.
class
src.openai.types.beta.beta_response_input_item.ProgramAgentThe agent that produced this item.
class
src.openai.types.beta.beta_response_input_item.ProgramOutputAgentThe agent that produced this item.
class
src.openai.types.beta.beta_response_input_item.ShellCallAgentThe agent that produced this item.
class
src.openai.types.beta.beta_response_input_item.ShellCallOutputAgentThe agent that produced this item.
class
src.openai.types.beta.beta_response_input_item.ToolSearchCallAgentThe agent that produced this item.
class
src.openai.types.beta.beta_response_input_item_param.AdditionalToolsAgentThe agent that produced this item.
class
src.openai.types.beta.beta_response_input_item_param.AgentMessageA message routed between agents.
class
src.openai.types.beta.beta_response_input_item_param.AgentMessageAgentThe agent that produced this item.
class
src.openai.types.beta.beta_response_input_item_param.ApplyPatchCallAgentThe agent that produced this item.
class
src.openai.types.beta.beta_response_input_item_param.ApplyPatchCallOutputAgentThe agent that produced this item.
class
src.openai.types.beta.beta_response_input_item_param.CompactionTriggerCompacts the current context.
class
src.openai.types.beta.beta_response_input_item_param.CompactionTriggerAgentThe agent that produced this item.
class
src.openai.types.beta.beta_response_input_item_param.ComputerCallOutputThe output of a computer tool call.
class
src.openai.types.beta.beta_response_input_item_param.ComputerCallOutputAgentThe agent that produced this item.
class
src.openai.types.beta.beta_response_input_item_param.FunctionCallOutputThe output of a function tool call.
class
src.openai.types.beta.beta_response_input_item_param.FunctionCallOutputAgentThe agent that produced this item.
class
src.openai.types.beta.beta_response_input_item_param.ImageGenerationCallAn image generation request made by the model.
class
src.openai.types.beta.beta_response_input_item_param.ImageGenerationCallAgentThe agent that produced this item.
class
src.openai.types.beta.beta_response_input_item_param.ItemReferenceAn internal identifier for an item to reference.
class
src.openai.types.beta.beta_response_input_item_param.ItemReferenceAgentThe agent that produced this item.
class
src.openai.types.beta.beta_response_input_item_param.LocalShellCallA tool call to run a command on the local shell.
class
src.openai.types.beta.beta_response_input_item_param.LocalShellCallActionExecute a shell command on the server.
class
src.openai.types.beta.beta_response_input_item_param.LocalShellCallAgentThe agent that produced this item.
class
src.openai.types.beta.beta_response_input_item_param.LocalShellCallOutputThe output of a local shell tool call.
class
src.openai.types.beta.beta_response_input_item_param.LocalShellCallOutputAgentThe agent that produced this item.
class
src.openai.types.beta.beta_response_input_item_param.McpApprovalRequestAgentThe agent that produced this item.
class
src.openai.types.beta.beta_response_input_item_param.McpApprovalResponseA response to an MCP approval request.
class
src.openai.types.beta.beta_response_input_item_param.McpApprovalResponseAgentThe agent that produced this item.
class
src.openai.types.beta.beta_response_input_item_param.McpCallAn invocation of a tool on an MCP server.
class
src.openai.types.beta.beta_response_input_item_param.McpCallAgentThe agent that produced this item.
class
src.openai.types.beta.beta_response_input_item_param.McpListToolsA list of tools available on an MCP server.
class
src.openai.types.beta.beta_response_input_item_param.McpListToolsAgentThe agent that produced this item.
class
src.openai.types.beta.beta_response_input_item_param.McpListToolsToolA tool available on an MCP server.
class
src.openai.types.beta.beta_response_input_item_param.MessageAgentThe agent that produced this item.
class
src.openai.types.beta.beta_response_input_item_param.MultiAgentCallAgentThe agent that produced this item.
class
src.openai.types.beta.beta_response_input_item_param.MultiAgentCallOutputAgentThe agent that produced this item.
class
src.openai.types.beta.beta_response_input_item_param.ProgramAgentThe agent that produced this item.
class
src.openai.types.beta.beta_response_input_item_param.ProgramOutputAgentThe agent that produced this item.
class
src.openai.types.beta.beta_response_input_item_param.ShellCallAgentThe agent that produced this item.
class
src.openai.types.beta.beta_response_input_item_param.ShellCallOutputAgentThe agent that produced this item.
class
src.openai.types.beta.beta_response_input_item_param.ToolSearchCallAgentThe agent that produced this item.
class
src.openai.types.beta.beta_response_input_message_item.AgentThe agent that produced this item.
class
src.openai.types.beta.beta_response_input_param.AdditionalToolsAgentThe agent that produced this item.
class
src.openai.types.beta.beta_response_input_param.AgentMessageA message routed between agents.
class
src.openai.types.beta.beta_response_input_param.AgentMessageAgentThe agent that produced this item.
class
src.openai.types.beta.beta_response_input_param.ApplyPatchCallAgentThe agent that produced this item.
class
src.openai.types.beta.beta_response_input_param.ApplyPatchCallOutputAgentThe agent that produced this item.
class
src.openai.types.beta.beta_response_input_param.CompactionTriggerCompacts the current context.
class
src.openai.types.beta.beta_response_input_param.CompactionTriggerAgentThe agent that produced this item.
class
src.openai.types.beta.beta_response_input_param.ComputerCallOutputThe output of a computer tool call.
class
src.openai.types.beta.beta_response_input_param.ComputerCallOutputAgentThe agent that produced this item.
class
src.openai.types.beta.beta_response_input_param.FunctionCallOutputThe output of a function tool call.
class
src.openai.types.beta.beta_response_input_param.FunctionCallOutputAgentThe agent that produced this item.
class
src.openai.types.beta.beta_response_input_param.ImageGenerationCallAn image generation request made by the model.
class
src.openai.types.beta.beta_response_input_param.ImageGenerationCallAgentThe agent that produced this item.
class
src.openai.types.beta.beta_response_input_param.ItemReferenceAn internal identifier for an item to reference.
class
src.openai.types.beta.beta_response_input_param.ItemReferenceAgentThe agent that produced this item.
class
src.openai.types.beta.beta_response_input_param.LocalShellCallA tool call to run a command on the local shell.
class
src.openai.types.beta.beta_response_input_param.LocalShellCallActionExecute a shell command on the server.
class
src.openai.types.beta.beta_response_input_param.LocalShellCallAgentThe agent that produced this item.
class
src.openai.types.beta.beta_response_input_param.LocalShellCallOutputThe output of a local shell tool call.
class
src.openai.types.beta.beta_response_input_param.LocalShellCallOutputAgentThe agent that produced this item.
class
src.openai.types.beta.beta_response_input_param.McpApprovalRequestAgentThe agent that produced this item.
class
src.openai.types.beta.beta_response_input_param.McpApprovalResponseA response to an MCP approval request.
class
src.openai.types.beta.beta_response_input_param.McpApprovalResponseAgentThe agent that produced this item.
class
src.openai.types.beta.beta_response_input_param.McpCallAn invocation of a tool on an MCP server.
class
src.openai.types.beta.beta_response_input_param.McpCallAgentThe agent that produced this item.
class
src.openai.types.beta.beta_response_input_param.McpListToolsA list of tools available on an MCP server.
class
src.openai.types.beta.beta_response_input_param.McpListToolsAgentThe agent that produced this item.
class
src.openai.types.beta.beta_response_input_param.McpListToolsToolA tool available on an MCP server.
class
src.openai.types.beta.beta_response_input_param.MessageAgentThe agent that produced this item.
class
src.openai.types.beta.beta_response_input_param.MultiAgentCallAgentThe agent that produced this item.
class
src.openai.types.beta.beta_response_input_param.MultiAgentCallOutputAgentThe agent that produced this item.
class
src.openai.types.beta.beta_response_input_param.ProgramAgentThe agent that produced this item.
class
src.openai.types.beta.beta_response_input_param.ProgramOutputAgentThe agent that produced this item.
class
src.openai.types.beta.beta_response_input_param.ShellCallAgentThe agent that produced this item.
class
src.openai.types.beta.beta_response_input_param.ShellCallOutputAgentThe agent that produced this item.
class
src.openai.types.beta.beta_response_input_param.ToolSearchCallAgentThe agent that produced this item.
class
src.openai.types.beta.beta_response_input_text.BetaResponseInputTextA text input to the model.
class
src.openai.types.beta.beta_response_input_text_content.BetaResponseInputTextContentA text input to the model.
class
src.openai.types.beta.beta_response_input_text_content_param.BetaResponseInputTextContentParamA text input to the model.
class
src.openai.types.beta.beta_response_input_text_param.BetaResponseInputTextParamA text input to the model.
class
src.openai.types.beta.beta_response_item.AdditionalToolsAgentThe agent that produced this item.
class
src.openai.types.beta.beta_response_item.AgentMessageAgentThe agent that produced this item.
class
src.openai.types.beta.beta_response_item.AgentMessageContentComputerScreenshotA screenshot of a computer.
class
src.openai.types.beta.beta_response_item.AgentMessageContentReasoningTextReasoning text from the model.
class
src.openai.types.beta.beta_response_item.AgentMessageContentSummaryTextA summary text from the model.
class
src.openai.types.beta.beta_response_item.AgentMessageContentTextA text content.
class
src.openai.types.beta.beta_response_item.ImageGenerationCallAn image generation request made by the model.
class
src.openai.types.beta.beta_response_item.ImageGenerationCallAgentThe agent that produced this item.
class
src.openai.types.beta.beta_response_item.LocalShellCallA tool call to run a command on the local shell.
class
src.openai.types.beta.beta_response_item.LocalShellCallActionExecute a shell command on the server.
About this data
These signatures were extracted from the public source of openai/openai-python
using Python's ast module. Argument names, default values,
type annotations and return types are taken verbatim from the code.
Implementation bodies are never stored. See
how it works for details.