api.md

Shared

Types:

• ChatModel
• ComparisonFilter
• CompoundFilter
• ErrorObject
• FunctionDefinition
• FunctionParameters
• Metadata
• Reasoning
• ReasoningEffort
• ResponseFormatJSONObject
• ResponseFormatJSONSchema
• ResponseFormatText

Completions

Types:

• Completion
• CompletionChoice
• CompletionUsage

Methods:

• client.completions.create({ ...params }) -> Completion

Chat

Types:

• ChatModel

Completions

Types:

• ChatCompletion
• ChatCompletionAssistantMessageParam
• ChatCompletionAudio
• ChatCompletionAudioParam
• ChatCompletionChunk
• ChatCompletionContentPart
• ChatCompletionContentPartImage
• ChatCompletionContentPartInputAudio
• ChatCompletionContentPartRefusal
• ChatCompletionContentPartText
• ChatCompletionDeleted
• ChatCompletionDeveloperMessageParam
• ChatCompletionFunctionCallOption
• ChatCompletionFunctionMessageParam
• ChatCompletionMessage
• ChatCompletionMessageParam
• ChatCompletionMessageToolCall
• ChatCompletionModality
• ChatCompletionNamedToolChoice
• ChatCompletionPredictionContent
• ChatCompletionRole
• ChatCompletionStoreMessage
• ChatCompletionStreamOptions
• ChatCompletionSystemMessageParam
• ChatCompletionTokenLogprob
• ChatCompletionTool
• ChatCompletionToolChoiceOption
• ChatCompletionToolMessageParam
• ChatCompletionUserMessageParam
• CreateChatCompletionRequestMessage
• ChatCompletionReasoningEffort

Methods:

• client.chat.completions.create({ ...params }) -> ChatCompletion
• client.chat.completions.retrieve(completionId) -> ChatCompletion
• client.chat.completions.update(completionId, { ...params }) -> ChatCompletion
• client.chat.completions.list({ ...params }) -> ChatCompletionsPage
• client.chat.completions.del(completionId) -> ChatCompletionDeleted

Messages

Methods:

• client.chat.completions.messages.list(completionId, { ...params }) -> ChatCompletionStoreMessagesPage

Embeddings

Types:

• CreateEmbeddingResponse
• Embedding
• EmbeddingModel

Methods:

• client.embeddings.create({ ...params }) -> CreateEmbeddingResponse

Files

Types:

• FileContent
• FileDeleted
• FileObject
• FilePurpose

Methods:

• client.files.create({ ...params }) -> FileObject
• client.files.retrieve(fileId) -> FileObject
• client.files.list({ ...params }) -> FileObjectsPage
• client.files.del(fileId) -> FileDeleted
• client.files.content(fileId) -> Response
• client.files.retrieveContent(fileId) -> string

Images

Types:

• Image
• ImageModel
• ImagesResponse

Methods:

• client.images.createVariation({ ...params }) -> ImagesResponse
• client.images.edit({ ...params }) -> ImagesResponse
• client.images.generate({ ...params }) -> ImagesResponse

Audio

Types:

• AudioModel
• AudioResponseFormat

Transcriptions

Types:

• Transcription
• TranscriptionSegment
• TranscriptionVerbose
• TranscriptionWord
• TranscriptionCreateResponse

Methods:

• client.audio.transcriptions.create({ ...params }) -> TranscriptionCreateResponse

Translations

Types:

• Translation
• TranslationVerbose
• TranslationCreateResponse

Methods:

• client.audio.translations.create({ ...params }) -> TranslationCreateResponse

Speech

Types:

• SpeechModel

Methods:

• client.audio.speech.create({ ...params }) -> Response

Moderations

Types:

• Moderation
• ModerationImageURLInput
• ModerationModel
• ModerationMultiModalInput
• ModerationTextInput
• ModerationCreateResponse

Methods:

• client.moderations.create({ ...params }) -> ModerationCreateResponse

Models

Types:

• Model
• ModelDeleted

Methods:

• client.models.retrieve(model) -> Model
• client.models.list() -> ModelsPage
• client.models.del(model) -> ModelDeleted

FineTuning

Jobs

Types:

• FineTuningJob
• FineTuningJobEvent
• FineTuningJobWandbIntegration
• FineTuningJobWandbIntegrationObject
• FineTuningJobIntegration

Methods:

• client.fineTuning.jobs.create({ ...params }) -> FineTuningJob
• client.fineTuning.jobs.retrieve(fineTuningJobId) -> FineTuningJob
• client.fineTuning.jobs.list({ ...params }) -> FineTuningJobsPage
• client.fineTuning.jobs.cancel(fineTuningJobId) -> FineTuningJob
• client.fineTuning.jobs.listEvents(fineTuningJobId, { ...params }) -> FineTuningJobEventsPage

Checkpoints

Types:

• FineTuningJobCheckpoint

Methods:

• client.fineTuning.jobs.checkpoints.list(fineTuningJobId, { ...params }) -> FineTuningJobCheckpointsPage

VectorStores

Types:

• AutoFileChunkingStrategyParam
• FileChunkingStrategy
• FileChunkingStrategyParam
• OtherFileChunkingStrategyObject
• StaticFileChunkingStrategy
• StaticFileChunkingStrategyObject
• StaticFileChunkingStrategyObjectParam
• VectorStore
• VectorStoreDeleted
• VectorStoreSearchResponse

Methods:

• client.vectorStores.create({ ...params }) -> VectorStore
• client.vectorStores.retrieve(vectorStoreId) -> VectorStore
• client.vectorStores.update(vectorStoreId, { ...params }) -> VectorStore
• client.vectorStores.list({ ...params }) -> VectorStoresPage
• client.vectorStores.del(vectorStoreId) -> VectorStoreDeleted
• client.vectorStores.search(vectorStoreId, { ...params }) -> VectorStoreSearchResponsesPage

Files

Types:

• VectorStoreFile
• VectorStoreFileDeleted
• FileContentResponse

Methods:

• client.vectorStores.files.create(vectorStoreId, { ...params }) -> VectorStoreFile
• client.vectorStores.files.retrieve(vectorStoreId, fileId) -> VectorStoreFile
• client.vectorStores.files.update(vectorStoreId, fileId, { ...params }) -> VectorStoreFile
• client.vectorStores.files.list(vectorStoreId, { ...params }) -> VectorStoreFilesPage
• client.vectorStores.files.del(vectorStoreId, fileId) -> VectorStoreFileDeleted
• client.vectorStores.files.content(vectorStoreId, fileId) -> FileContentResponsesPage

FileBatches

Types:

• VectorStoreFileBatch

Methods:

• client.vectorStores.fileBatches.create(vectorStoreId, { ...params }) -> VectorStoreFileBatch
• client.vectorStores.fileBatches.retrieve(vectorStoreId, batchId) -> VectorStoreFileBatch
• client.vectorStores.fileBatches.cancel(vectorStoreId, batchId) -> VectorStoreFileBatch
• client.vectorStores.fileBatches.listFiles(vectorStoreId, batchId, { ...params }) -> VectorStoreFilesPage

Beta

Realtime

Types:

• ConversationCreatedEvent
• ConversationItem
• ConversationItemContent
• ConversationItemCreateEvent
• ConversationItemCreatedEvent
• ConversationItemDeleteEvent
• ConversationItemDeletedEvent
• ConversationItemInputAudioTranscriptionCompletedEvent
• ConversationItemInputAudioTranscriptionFailedEvent
• ConversationItemTruncateEvent
• ConversationItemTruncatedEvent
• ConversationItemWithReference
• ErrorEvent
• InputAudioBufferAppendEvent
• InputAudioBufferClearEvent
• InputAudioBufferClearedEvent
• InputAudioBufferCommitEvent
• InputAudioBufferCommittedEvent
• InputAudioBufferSpeechStartedEvent
• InputAudioBufferSpeechStoppedEvent
• RateLimitsUpdatedEvent
• RealtimeClientEvent
• RealtimeResponse
• RealtimeResponseStatus
• RealtimeResponseUsage
• RealtimeServerEvent
• ResponseAudioDeltaEvent
• ResponseAudioDoneEvent
• ResponseAudioTranscriptDeltaEvent
• ResponseAudioTranscriptDoneEvent
• ResponseCancelEvent
• ResponseContentPartAddedEvent
• ResponseContentPartDoneEvent
• ResponseCreateEvent
• ResponseCreatedEvent
• ResponseDoneEvent
• ResponseFunctionCallArgumentsDeltaEvent
• ResponseFunctionCallArgumentsDoneEvent
• ResponseOutputItemAddedEvent
• ResponseOutputItemDoneEvent
• ResponseTextDeltaEvent
• ResponseTextDoneEvent
• SessionCreatedEvent
• SessionUpdateEvent
• SessionUpdatedEvent

Sessions

Types:

• Session
• SessionCreateResponse

Methods:

• client.beta.realtime.sessions.create({ ...params }) -> SessionCreateResponse

Assistants

Types:

• Assistant
• AssistantDeleted
• AssistantStreamEvent
• AssistantTool
• CodeInterpreterTool
• FileSearchTool
• FunctionTool
• MessageStreamEvent
• RunStepStreamEvent
• RunStreamEvent
• ThreadStreamEvent

Methods:

• client.beta.assistants.create({ ...params }) -> Assistant
• client.beta.assistants.retrieve(assistantId) -> Assistant
• client.beta.assistants.update(assistantId, { ...params }) -> Assistant
• client.beta.assistants.list({ ...params }) -> AssistantsPage
• client.beta.assistants.del(assistantId) -> AssistantDeleted

Threads

Types:

• AssistantResponseFormatOption
• AssistantToolChoice
• AssistantToolChoiceFunction
• AssistantToolChoiceOption
• Thread
• ThreadDeleted

Methods:

• client.beta.threads.create({ ...params }) -> Thread
• client.beta.threads.retrieve(threadId) -> Thread
• client.beta.threads.update(threadId, { ...params }) -> Thread
• client.beta.threads.del(threadId) -> ThreadDeleted
• client.beta.threads.createAndRun({ ...params }) -> Run

Runs

Types:

• RequiredActionFunctionToolCall
• Run
• RunStatus

Methods:

• client.beta.threads.runs.create(threadId, { ...params }) -> Run
• client.beta.threads.runs.retrieve(threadId, runId) -> Run
• client.beta.threads.runs.update(threadId, runId, { ...params }) -> Run
• client.beta.threads.runs.list(threadId, { ...params }) -> RunsPage
• client.beta.threads.runs.cancel(threadId, runId) -> Run
• client.beta.threads.runs.submitToolOutputs(threadId, runId, { ...params }) -> Run

Steps

Types:

• CodeInterpreterLogs
• CodeInterpreterOutputImage
• CodeInterpreterToolCall
• CodeInterpreterToolCallDelta
• FileSearchToolCall
• FileSearchToolCallDelta
• FunctionToolCall
• FunctionToolCallDelta
• MessageCreationStepDetails
• RunStep
• RunStepDelta
• RunStepDeltaEvent
• RunStepDeltaMessageDelta
• RunStepInclude
• ToolCall
• ToolCallDelta
• ToolCallDeltaObject
• ToolCallsStepDetails

Methods:

• client.beta.threads.runs.steps.retrieve(threadId, runId, stepId, { ...params }) -> RunStep
• client.beta.threads.runs.steps.list(threadId, runId, { ...params }) -> RunStepsPage

Messages

Types:

• Annotation
• AnnotationDelta
• FileCitationAnnotation
• FileCitationDeltaAnnotation
• FilePathAnnotation
• FilePathDeltaAnnotation
• ImageFile
• ImageFileContentBlock
• ImageFileDelta
• ImageFileDeltaBlock
• ImageURL
• ImageURLContentBlock
• ImageURLDelta
• ImageURLDeltaBlock
• Message
• MessageContent
• MessageContentDelta
• MessageContentPartParam
• MessageDeleted
• MessageDelta
• MessageDeltaEvent
• RefusalContentBlock
• RefusalDeltaBlock
• Text
• TextContentBlock
• TextContentBlockParam
• TextDelta
• TextDeltaBlock

Methods:

• client.beta.threads.messages.create(threadId, { ...params }) -> Message
• client.beta.threads.messages.retrieve(threadId, messageId) -> Message
• client.beta.threads.messages.update(threadId, messageId, { ...params }) -> Message
• client.beta.threads.messages.list(threadId, { ...params }) -> MessagesPage
• client.beta.threads.messages.del(threadId, messageId) -> MessageDeleted

Batches

Types:

• Batch
• BatchError
• BatchRequestCounts

Methods:

• client.batches.create({ ...params }) -> Batch
• client.batches.retrieve(batchId) -> Batch
• client.batches.list({ ...params }) -> BatchesPage
• client.batches.cancel(batchId) -> Batch

Uploads

Types:

• Upload

Methods:

• client.uploads.create({ ...params }) -> Upload
• client.uploads.cancel(uploadId) -> Upload
• client.uploads.complete(uploadId, { ...params }) -> Upload

Parts

Types:

• UploadPart

Methods:

• client.uploads.parts.create(uploadId, { ...params }) -> UploadPart

Responses

Types:

• ComputerTool
• EasyInputMessage
• FileSearchTool
• FunctionTool
• Response
• ResponseAudioDeltaEvent
• ResponseAudioDoneEvent
• ResponseAudioTranscriptDeltaEvent
• ResponseAudioTranscriptDoneEvent
• ResponseCodeInterpreterCallCodeDeltaEvent
• ResponseCodeInterpreterCallCodeDoneEvent
• ResponseCodeInterpreterCallCompletedEvent
• ResponseCodeInterpreterCallInProgressEvent
• ResponseCodeInterpreterCallInterpretingEvent
• ResponseCodeInterpreterToolCall
• ResponseCompletedEvent
• ResponseComputerToolCall
• ResponseContent
• ResponseContentPartAddedEvent
• ResponseContentPartDoneEvent
• ResponseCreatedEvent
• ResponseError
• ResponseErrorEvent
• ResponseFailedEvent
• ResponseFileSearchCallCompletedEvent
• ResponseFileSearchCallInProgressEvent
• ResponseFileSearchCallSearchingEvent
• ResponseFileSearchToolCall
• ResponseFormatTextConfig
• ResponseFormatTextJSONSchemaConfig
• ResponseFunctionCallArgumentsDeltaEvent
• ResponseFunctionCallArgumentsDoneEvent
• ResponseFunctionToolCall
• ResponseFunctionWebSearch
• ResponseInProgressEvent
• ResponseIncludable
• ResponseIncompleteEvent
• ResponseInput
• ResponseInputAudio
• ResponseInputContent
• ResponseInputFile
• ResponseInputImage
• ResponseInputItem
• ResponseInputMessageContentList
• ResponseInputText
• ResponseOutputAudio
• ResponseOutputItem
• ResponseOutputItemAddedEvent
• ResponseOutputItemDoneEvent
• ResponseOutputMessage
• ResponseOutputRefusal
• ResponseOutputText
• ResponseReasoningItem
• ResponseRefusalDeltaEvent
• ResponseRefusalDoneEvent
• ResponseStatus
• ResponseStreamEvent
• ResponseTextAnnotationDeltaEvent
• ResponseTextConfig
• ResponseTextDeltaEvent
• ResponseTextDoneEvent
• ResponseUsage
• ResponseWebSearchCallCompletedEvent
• ResponseWebSearchCallInProgressEvent
• ResponseWebSearchCallSearchingEvent
• Tool
• ToolChoiceFunction
• ToolChoiceOptions
• ToolChoiceTypes
• WebSearchTool

Methods:

• client.responses.create({ ...params }) -> Response
• client.responses.retrieve(responseId, { ...params }) -> Response
• client.responses.del(responseId) -> void

InputItems

Types:

• ResponseItemList

Methods:

• client.responses.inputItems.list(responseId, { ...params }) -> ResponseItemListDataPage