POST
/
{path}
?endpoint_id=
{endpoint_id}

# Download audio file
curl -L -o "audio.flac" "https://tinyurl.com/4997djsh"

# Make request
curl -X POST "https://audio-batch.link.fireworks.ai/v1/audio/transcriptions?endpoint_id=audio-prod" \
-H "Authorization: <FIREWORKS_API_KEY>" \
-F "file=@audio.flac"

Headers

Authorization
string
required

Your Fireworks API key, e.g. Authorization=FIREWORKS_API_KEY. Alternatively, can be provided as a query param.

Path Parameters

path
string
required

The relative route of the target API operation (e.g. "v1/audio/transcriptions", "v1/audio/translations"). This should correspond to a valid route supported by the backend service.

Query Parameters

endpoint_id
string
required

Identifies the target backend service or model to handle the request. Currently supported:

Body

Request body fields vary depending on the selected endpoint_id and path.

The request body must conform to the schema defined by the corresponding synchronous API.
For example, transcription requests typically accept fields such as model, diarize, and response_format.
Refer to the relevant synchronous API for required fields:

Response

status
string
required

The status of the batch request submission.
A value of "submitted" indicates the batch request was accepted and queued for processing.

batch_id
string
required

A unique identifier assigned to the batch job. This ID can be used to check job status or retrieve results later.

account_id
string
required

The unique identifier of the account associated with the batch job.

endpoint_id
string
required

The backend service selected to process the request.
This typically matches the endpoint_id used during submission.

message
string

A human-readable message describing the result of the submission.
Typically "Request submitted successfully" if accepted.


# Download audio file
curl -L -o "audio.flac" "https://tinyurl.com/4997djsh"

# Make request
curl -X POST "https://audio-batch.link.fireworks.ai/v1/audio/transcriptions?endpoint_id=audio-prod" \
-H "Authorization: <FIREWORKS_API_KEY>" \
-F "file=@audio.flac"

To check the status of your batch request, use the Check Batch Status endpoint with the returned batch_id.