TsgcHTTP_API_OpenAIMethods › CreateUpload

CreateUpload Method

Initiates a multipart upload session for transferring a large file to OpenAI in parts

Syntax

function CreateUpload(const aRequest: TsgcOpenAIClass_Request_Upload) : TsgcOpenAIClass_Response_Upload;

Parameters

NameTypeDescription
aRequestconst TsgcOpenAIClass_Request_UploadUpload request with the target filename, total bytes, purpose and MIME type

Return Value

Upload session metadata including the upload id and status (TsgcOpenAIClass_Response_Upload)

Remarks

Calls the POST /v1/uploads endpoint. Use the multipart Uploads API for files larger than 512MB or when network resiliency matters. After creating the upload, call AddUploadPart for each chunk and finish with CompleteUpload or abort with CancelUpload. The upload expires automatically if not completed in time.

Example

oRequest := TsgcOpenAIClass_Request_Upload.Create;
oRequest.Filename := 'training-large.jsonl';
oRequest.Bytes := 2147483648;
oRequest.Purpose := 'fine-tune';
oRequest.MimeType := 'application/jsonl';
oResponse := oAPI.CreateUpload(oRequest);
ShowMessage('Upload id: ' + oResponse.Id);

Back to Methods