OpenAI API

Upload

object

The Upload object can accept byte chunks in the form of Parts.

idstringrequired

The Upload unique identifier, which can be referenced in API endpoints.

created_atintegerrequired

The Unix timestamp (in seconds) for when the Upload was created.

filenamestringrequired

The name of the file to be uploaded.

bytesintegerrequired

The intended number of bytes to be uploaded.

purposestringrequired

The intended purpose of the file. Please refer here for acceptable values.

statusstringrequired

The status of the Upload.

Allowed values:pendingcompletedcancelledexpired

expires_atintegerrequired

The Unix timestamp (in seconds) for when the Upload was created.

objectstring

The object type, which is always “upload”.

Allowed values:upload

file

The ready File object after the Upload is completed.

Show Child Parameters
Example

UploadPart

object

The upload Part represents a chunk of bytes we can add to an Upload object.

idstringrequired

The upload Part unique identifier, which can be referenced in API endpoints.

created_atintegerrequired

The Unix timestamp (in seconds) for when the Part was created.

upload_idstringrequired

The ID of the Upload object that this Part was added to.

objectstringrequired

The object type, which is always upload.part.

Allowed values:upload.part

Example

UsageAudioSpeechesResult

object

The aggregated audio speeches usage details of the specific time bucket.

objectstringrequired

Allowed values:organization.usage.audio_speeches.result

charactersintegerrequired

The number of characters processed.

num_model_requestsintegerrequired

The count of requests made to the model.

project_idstring

When group_by=project_id, this field provides the project ID of the grouped usage result.

user_idstring

When group_by=user_id, this field provides the user ID of the grouped usage result.

api_key_idstring

When group_by=api_key_id, this field provides the API key ID of the grouped usage result.

modelstring

When group_by=model, this field provides the model name of the grouped usage result.

Example

UsageAudioTranscriptionsResult

object

The aggregated audio transcriptions usage details of the specific time bucket.

objectstringrequired

Allowed values:organization.usage.audio_transcriptions.result

secondsintegerrequired

The number of seconds processed.

num_model_requestsintegerrequired

The count of requests made to the model.

project_idstring

When group_by=project_id, this field provides the project ID of the grouped usage result.

user_idstring

When group_by=user_id, this field provides the user ID of the grouped usage result.

api_key_idstring

When group_by=api_key_id, this field provides the API key ID of the grouped usage result.

modelstring

When group_by=model, this field provides the model name of the grouped usage result.

Example

UsageCodeInterpreterSessionsResult

object

The aggregated code interpreter sessions usage details of the specific time bucket.

objectstringrequired

Allowed values:organization.usage.code_interpreter_sessions.result

num_sessionsinteger

The number of code interpreter sessions.

project_idstring

When group_by=project_id, this field provides the project ID of the grouped usage result.

Example