Implementation:Groq Groq python Files Create

Knowledge Sources	Groq Python SDK
Domains	Batch_Processing, File_Handling
Last Updated	2026-02-15 16:00 GMT

Overview

Concrete tool for uploading files to the Groq API provided by the Groq Python SDK.

Description

The Files.create() method uploads a file to /openai/v1/files as multipart/form-data. It returns a FileCreateResponse with the file id, filename, bytes, and created_at. The purpose parameter must be "batch" for batch processing files.

Usage

Access via client.files.create(). Pass the JSONL file and purpose="batch".

Code Reference

Source Location

• Repository: groq-python
• File: src/groq/resources/files.py
• Lines: L58-111 (sync), L253-306 (async)

Signature

class Files(SyncAPIResource):
    def create(
        self,
        *,
        file: FileTypes,
        purpose: Literal["batch"],
    ) -> FileCreateResponse:

Import

from groq import Groq
# Access via: client.files.create(...)

I/O Contract

Inputs

Name	Type	Required	Description
file	FileTypes	Yes	JSONL file to upload (path, bytes, or file object)
purpose	Literal["batch"]	Yes	Must be "batch"

Outputs

Name	Type	Description
(return)	FileCreateResponse	Object with id, filename, bytes, created_at, purpose fields

Usage Examples

from groq import Groq

client = Groq()

file_response = client.files.create(
    file=open("batch_input.jsonl", "rb"),
    purpose="batch",
)

print(f"File ID: {file_response.id}")
print(f"Size: {file_response.bytes} bytes")

Related Pages

Implements Principle

• Principle:Groq_Groq_python_File_Upload

Requires Environment

• Environment:Groq_Groq_python_Python_Groq_SDK