uploadOpenAIFiles

suspend fun uploadOpenAIFiles(requests: List<OpenAIUploadFileRequest>, maxConcurrency: Int = 5, onProgress: UploadFileProgressListener<MultiFileProgress>? = null): List<UploadFileResult>

Uploads multiple files to the OpenAI Files API with controlled concurrency.

Each file upload is independent; failures are captured per file in UploadFileResult.

Return

A list of UploadFileResult objects (one per request).

Parameters

requests

The list of upload requests.

maxConcurrency

Maximum number of concurrent uploads. Defaults to 5.

onProgress

Optional listener for per-file upload progress.

See also

Throws

if requests list is empty.

Samples

val requests = listOf(
    OpenAIUploadFileRequest(file = KoryFile.fromPath("path/to/file1.ext"), purpose = OpenAIFilePurpose.FINE_TUNE),
    OpenAIUploadFileRequest(file = KoryFile.fromPath("path/to/file2.ext"), purpose = OpenAIFilePurpose.FINE_TUNE)
)

val result = client.uploadOpenAIFiles(
    requests = requests,
    // You can set a max concurrency using filed: `maxConcurrency`, example: maxConcurrency = 2
) { progress ->
    println("Uploading file with name ${progress.fileName}, progress: ${progress.percentage}%")
}

println(result.joinToString("\n") { it.printableOutput() })

suspend fun uploadOpenAIFiles(maxConcurrency: Int = 5, onProgress: UploadFileProgressListener<MultiFileProgress>? = null, requests: OpenAIUploadFilesBuilder.() -> Unit): List<UploadFileResult>

Uploads multiple files to the OpenAI Files API using the DSL.

Return

A list of UploadFileResult objects (one per request).

Parameters

maxConcurrency

Maximum number of concurrent uploads. Defaults to 5.

onProgress

Optional listener for per-file upload progress.

requests

DSL builder for configuring the upload requests.

See also

Samples

val result = client.uploadOpenAIFiles(
    onProgress = { progress ->
        println("Uploading file with name ${progress.fileName}, progress: ${progress.percentage}%")
    }
) {
    // You can set default purpose, it will be used in all requests in this dsl, example: defaultPurpose = OpenAIFilePurpose.ASSISTANTS
    fileFromPath(
        path = "path/to/file1.ext"
        // You can set a purpose for this file using field `purpose`, example: purpose = OpenAIFilePurpose.ASSISTANTS
    )
    fileFromPath("path/to/file2.ext")
}

println(result.joinToString("\n") { it.printableOutput() })