SpyBara
Go Premium

java/resources/uploads/subresources/parts/index.md 2026-07-10 23:02 UTC to 2026-07-12 06:58 UTC

5 added, 1 removed.

2026
Wed 15 02:58 Tue 14 06:58 Mon 13 15:59 Sun 12 06:58 Fri 10 23:02 Thu 9 20:58 Tue 7 08:02

Parts

Add upload part

UploadPart uploads().parts().create(PartCreateParamsparams, RequestOptionsrequestOptions = RequestOptions.none())

post /uploads/{upload_id}/parts

Adds a Part to an Upload object. A Part represents a chunk of bytes from the file you are trying to upload.

Each Part can be at most 64 MB, and you can add Parts until you hit the Upload maximum of 8 GB.

It is possible to add multiple Parts in parallel. You can decide the intended order of the Parts when you complete the Upload.

Parameters

  • PartCreateParams params

    • Optional<String> uploadId

    • String data

      The chunk of bytes for this Part.

Returns

  • class UploadPart:

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

    • String id

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

    • long createdAt

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

    • JsonValue; object_ "upload.part"constant

      The object type, which is always upload.part.

      • UPLOAD_PART("upload.part")
    • String uploadId

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

Example

package com.openai.example;

import com.openai.client.OpenAIClient;
import com.openai.client.okhttp.OpenAIOkHttpClient;
import com.openai.models.uploads.parts.PartCreateParams;
import com.openai.models.uploads.parts.UploadPart;
import java.io.ByteArrayInputStream;

public final class Main {
    private Main() {}

    public static void main(String[] args) {
        OpenAIClient client = OpenAIOkHttpClient.fromEnv();

        PartCreateParams params = PartCreateParams.builder()
            .uploadId("upload_abc123")
            .data(new ByteArrayInputStream("Example data".getBytes()))
            .build();
        UploadPart uploadPart = client.uploads().parts().create(params);
    }
}

Response

{
  "id": "id",
  "created_at": 0,
  "object": "upload.part",
  "upload_id": "upload_id"
}

Domain Types

Upload Part

  • class UploadPart:

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

    • String id

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

    • long createdAt

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

    • JsonValue; object_ "upload.part"constant

      The object type, which is always upload.part.

      • UPLOAD_PART("upload.part")
    • String uploadId

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