api.md

Shared Types

from openai.types import ErrorObject, FunctionDefinition, FunctionParameters

Completions

Types:

from openai.types import Completion, CompletionChoice, CompletionUsage

Methods:

• client.completions.create(**params) -> Completion

Chat

Completions

Types:

from openai.types.chat import (
    ChatCompletion,
    ChatCompletionAssistantMessageParam,
    ChatCompletionChunk,
    ChatCompletionContentPart,
    ChatCompletionContentPartImage,
    ChatCompletionContentPartText,
    ChatCompletionFunctionCallOption,
    ChatCompletionFunctionMessageParam,
    ChatCompletionMessage,
    ChatCompletionMessageParam,
    ChatCompletionMessageToolCall,
    ChatCompletionNamedToolChoice,
    ChatCompletionRole,
    ChatCompletionSystemMessageParam,
    ChatCompletionTokenLogprob,
    ChatCompletionTool,
    ChatCompletionToolChoiceOption,
    ChatCompletionToolMessageParam,
    ChatCompletionUserMessageParam,
)

Methods:

• client.chat.completions.create(**params) -> ChatCompletion

Embeddings

Types:

from openai.types import CreateEmbeddingResponse, Embedding

Methods:

• client.embeddings.create(**params) -> CreateEmbeddingResponse

Files

Types:

from openai.types import FileContent, FileDeleted, FileObject

Methods:

• client.files.create(**params) -> FileObject
• client.files.retrieve(file_id) -> FileObject
• client.files.list(**params) -> SyncPage[FileObject]
• client.files.delete(file_id) -> FileDeleted
• client.files.content(file_id) -> HttpxBinaryResponseContent
• client.files.retrieve_content(file_id) -> str
• client.files.wait_for_processing(*args) -> FileObject

Images

Types:

from openai.types import Image, ImagesResponse

Methods:

• client.images.create_variation(**params) -> ImagesResponse
• client.images.edit(**params) -> ImagesResponse
• client.images.generate(**params) -> ImagesResponse

Audio

Transcriptions

Types:

from openai.types.audio import Transcription

Methods:

• client.audio.transcriptions.create(**params) -> Transcription

Translations

Types:

from openai.types.audio import Translation

Methods:

• client.audio.translations.create(**params) -> Translation

Speech

Methods:

• client.audio.speech.create(**params) -> HttpxBinaryResponseContent

Moderations

Types:

from openai.types import Moderation, ModerationCreateResponse

Methods:

• client.moderations.create(**params) -> ModerationCreateResponse

Models

Types:

from openai.types import Model, ModelDeleted

Methods:

• client.models.retrieve(model) -> Model
• client.models.list() -> SyncPage[Model]
• client.models.delete(model) -> ModelDeleted

FineTuning

Jobs

Types:

from openai.types.fine_tuning import FineTuningJob, FineTuningJobEvent

Methods:

• client.fine_tuning.jobs.create(**params) -> FineTuningJob
• client.fine_tuning.jobs.retrieve(fine_tuning_job_id) -> FineTuningJob
• client.fine_tuning.jobs.list(**params) -> SyncCursorPage[FineTuningJob]
• client.fine_tuning.jobs.cancel(fine_tuning_job_id) -> FineTuningJob
• client.fine_tuning.jobs.list_events(fine_tuning_job_id, **params) -> SyncCursorPage[FineTuningJobEvent]

Beta

Assistants

Types:

from openai.types.beta import (
    Assistant,
    AssistantDeleted,
    AssistantStreamEvent,
    AssistantTool,
    CodeInterpreterTool,
    FunctionTool,
    MessageStreamEvent,
    RetrievalTool,
    RunStepStreamEvent,
    RunStreamEvent,
    ThreadStreamEvent,
)

Methods:

• client.beta.assistants.create(**params) -> Assistant
• client.beta.assistants.retrieve(assistant_id) -> Assistant
• client.beta.assistants.update(assistant_id, **params) -> Assistant
• client.beta.assistants.list(**params) -> SyncCursorPage[Assistant]
• client.beta.assistants.delete(assistant_id) -> AssistantDeleted

Files

Types:

from openai.types.beta.assistants import AssistantFile, FileDeleteResponse

Methods:

• client.beta.assistants.files.create(assistant_id, **params) -> AssistantFile
• client.beta.assistants.files.retrieve(file_id, *, assistant_id) -> AssistantFile
• client.beta.assistants.files.list(assistant_id, **params) -> SyncCursorPage[AssistantFile]
• client.beta.assistants.files.delete(file_id, *, assistant_id) -> FileDeleteResponse

Threads

Types:

from openai.types.beta import Thread, ThreadDeleted

Methods:

• client.beta.threads.create(**params) -> Thread
• client.beta.threads.retrieve(thread_id) -> Thread
• client.beta.threads.update(thread_id, **params) -> Thread
• client.beta.threads.delete(thread_id) -> ThreadDeleted
• client.beta.threads.create_and_run(**params) -> Run
• client.beta.threads.create_and_run_stream(*args) -> AssistantStreamManager[AssistantEventHandler] | AssistantStreamManager[AssistantEventHandlerT]

Runs

Types:

from openai.types.beta.threads import RequiredActionFunctionToolCall, Run, RunStatus

Methods:

• client.beta.threads.runs.create(thread_id, **params) -> Run
• client.beta.threads.runs.retrieve(run_id, *, thread_id) -> Run
• client.beta.threads.runs.update(run_id, *, thread_id, **params) -> Run
• client.beta.threads.runs.list(thread_id, **params) -> SyncCursorPage[Run]
• client.beta.threads.runs.cancel(run_id, *, thread_id) -> Run
• client.beta.threads.runs.submit_tool_outputs(run_id, *, thread_id, **params) -> Run
• client.beta.threads.runs.create_and_stream(*args) -> AssistantStreamManager[AssistantEventHandler] | AssistantStreamManager[AssistantEventHandlerT]
• client.beta.threads.runs.submit_tool_outputs_stream(*args) -> AssistantStreamManager[AssistantEventHandler] | AssistantStreamManager[AssistantEventHandlerT]

Steps

Types:

from openai.types.beta.threads.runs import (
    CodeInterpreterLogs,
    CodeInterpreterOutputImage,
    CodeInterpreterToolCall,
    CodeInterpreterToolCallDelta,
    FunctionToolCall,
    FunctionToolCallDelta,
    MessageCreationStepDetails,
    RetrievalToolCall,
    RetrievalToolCallDelta,
    RunStep,
    RunStepDelta,
    RunStepDeltaEvent,
    RunStepDeltaMessageDelta,
    ToolCall,
    ToolCallDelta,
    ToolCallDeltaObject,
    ToolCallsStepDetails,
)

Methods:

• client.beta.threads.runs.steps.retrieve(step_id, *, thread_id, run_id) -> RunStep
• client.beta.threads.runs.steps.list(run_id, *, thread_id, **params) -> SyncCursorPage[RunStep]

Messages

Types:

from openai.types.beta.threads import (
    Annotation,
    AnnotationDelta,
    FileCitationAnnotation,
    FileCitationDeltaAnnotation,
    FilePathAnnotation,
    FilePathDeltaAnnotation,
    ImageFile,
    ImageFileContentBlock,
    ImageFileDelta,
    ImageFileDeltaBlock,
    Message,
    MessageContent,
    MessageContentDelta,
    MessageDeleted,
    MessageDelta,
    MessageDeltaEvent,
    Text,
    TextContentBlock,
    TextDelta,
    TextDeltaBlock,
)

Methods:

• client.beta.threads.messages.create(thread_id, **params) -> Message
• client.beta.threads.messages.retrieve(message_id, *, thread_id) -> Message
• client.beta.threads.messages.update(message_id, *, thread_id, **params) -> Message
• client.beta.threads.messages.list(thread_id, **params) -> SyncCursorPage[Message]

Files

Types:

from openai.types.beta.threads.messages import MessageFile

Methods:

• client.beta.threads.messages.files.retrieve(file_id, *, thread_id, message_id) -> MessageFile
• client.beta.threads.messages.files.list(message_id, *, thread_id, **params) -> SyncCursorPage[MessageFile]