Skip to main content
POST
Start a new Whisper training job

Authorizations

Authorization
string
header
required

JWT token for authentication

Headers

Authorization
string
required

Bearer token for authentication and authorization.

Body

multipart/form-data
org
string
required

Organization UUID the job belongs to.

Example:

"your_org_uuid"

experiment_name
string
required

Name for this training run. A short random suffix is appended automatically, and it must be unique (after suffixing) within the org.

Example:

"whisper-hindi-run"

train_type
string
required

Training methodology.

Example:

"finetune"

language
enum<string>
required

Spoken language of the audio.

Available options:
English,
Hindi,
Bengali,
Marathi,
Telugu,
Tamil,
Gujarati,
Urdu,
Kannada,
Malayalam,
Punjabi,
Sanskrit,
Assamese
Example:

"Hindi"

task
enum<string>
required
Available options:
transcribe,
translate
Example:

"transcribe"

num_train_epochs
integer
required

Number of training epochs.

Example:

3

learning_rate
number
required

Learning rate.

Example:

0.0001

per_device_train_batch_size
integer
required

Training batch size per device.

Example:

8

per_device_eval_batch_size
integer
required

Evaluation batch size per device.

Example:

8

gradient_accumulation_steps
integer
required

Gradient accumulation steps.

Example:

1

model_details
object
required

Model configuration. Sent as a JSON-encoded string within the multipart body.

infrastructure_configurations
object
required

Infrastructure configuration for the training job. Sent as a JSON-encoded string within the multipart body.

dataset_details
object
required

Describes the dataset to create for this job. Sent as a JSON-encoded string within the multipart body.

dataset_file
file

The dataset file itself. Required when dataset_details.datasource is "File Upload", and must be omitted for any other datasource.

train_split
string

Hugging Face split expression for the training set. Only meaningful when the dataset source is Hugging Face. Never send together with split_type/train_split_ratio/eval_split_ratio.

Example:

"\"test.clean\""

eval_split
string

Hugging Face split expression for the eval set. Same rule as train_split.

Example:

"\"test.other\""

split_type
enum<string>

Required when the dataset source is AWS S3 or File Upload. Must not be sent for Hugging Face datasets.

Available options:
random,
stratified
train_split_ratio
number

Fraction of data used for training. Required together with split_type/eval_split_ratio for AWS S3/File Upload datasets. train_split_ratio + eval_split_ratio must equal 1.

Example:

0.9

eval_split_ratio
number

Fraction of data used for evaluation. Same rule as train_split_ratio. 0 is a valid value — send it explicitly, don't omit the field.

Example:

0.1

Response

Whisper training job created successfully.

experiment_name
string

Training experiment name (including the auto-appended suffix).

request_id
string

Job's unique identifier.

language
string

Spoken language of the audio.

status
enum<string>
Available options:
queued,
initializing,
running,
succeeded,
failed,
cancelled
created_at
string<date-time>