start_training
Submit a training job for a reference set: a LoRA, or a voice on a voice model.
A voice is cloned from the set's audio clips, designed from a prompt, or imported from an existing
ElevenLabs voice ID (voice-import). An import's run makes one test generation in the voice, and a
voice ID ElevenLabs does not serve fails the run. A finished ElevenLabs voice is bound to every
ElevenLabs model that speaks a voice; generate with it by passing the reference set in
reference_sets.
Asynchronous: returns a training_run_id immediately. Errors: invalid-dataset
(too few images / missing captions / no voice_id on an import), unknown-base-model (id not trainable),
unsupported-training-framework (framework not available for this base model),
unsupported-training-parameter (a training_parameters field the framework does not take),
invalid-training-parameter (a training_parameters value the model's trainer does not accept),
model-disabled (base model disabled for this workspace), insufficient-balance
(not enough Creative Units), and internal errors when the run fails to start.
Other coded errors propagate unchanged.
IMPORTANT: Call tool `get_instructions` first for general platform guidance.
Parameters
| Parameter | Type | Default | Description |
|---|---|---|---|
reference_set_idrequired | string (uuid) | — | The reference set (Style) to train a LoRA or a voice for. |
base_model_idrequired | string | — | Base model identifier from recommend_training_models_for_reference_sets. |
primary_audio_file_id | string (uuid) | — | The attached audio file to clone for a single-sample voice model such as Qwen 3 TTS or Seed Audio. Omit for other training models and when the reference set has only one audio clip. If it has multiple audio clips, ask the user which clip to use and pass that clip's file ID; never choose arbitrarily. |
training_framework | enum | — | Training framework. OMIT this field for normal training — the server picks the correct default. Do NOT set it based on quality, speed, or 'best model' requests. Set 'ai-toolkit' ONLY if the user explicitly names ai-toolkit; in that case you MUST also set base_model_id to one of: 'flux-2-klein-4b', 'flux-2-klein-4b-edit', 'qwen-image', 'qwen-image-edit-2511', 'qwen-image-2512'. Never pass 'ai-toolkit' with any other base model. For a voice, pick by what the user has: 'voice-clone' (the default) clones the set's audio clips; 'voice-design' designs a voice from training_parameters.training_prompt; 'voice-import' adopts an existing ElevenLabs voice from training_parameters.voice_id, on base_model_id one of: 'eleven-labs-tts-v3', 'eleven-labs-tts-v4', 'eleven-labs-tts-v4-turbo'. One of: fal, ai-toolkit, voice-clone, voice-design, voice-import |
training_parameters | TrainingOverrides | — | Settings for this run in place of the reference set's saved ones. Omit unless the user asks for specific values, or the voice framework needs one (voice_id for voice-import, training_prompt for voice-design). Each applies only where the run's framework offers it (repeats: kohya and ai-toolkit only); one the framework does not take is refused with unsupported-training-parameter, and a value outside what the model's trainer accepts with invalid-training-parameter. |
epochs | integer1–300 | — | Number of passes over the training images. |
repeats | integer1–50 | — | Times each image is seen within one epoch, so one epoch is (images x repeats) steps. Offered by the kohya and ai-toolkit frameworks only. |
learning_rate | number≤0.01, >0 | — | Optimizer learning rate. |
lora_rank | integer1–128 | — | LoRA rank (network dimension). |
training_prompt | string1–1000 chars | — | A description of the voice to design: age, accent, tone, pacing. Offered by the voice-design framework only. |
voice_id | string1–64 chars | — | The ElevenLabs voice ID to import: a voice from the public ElevenLabs voice library, or one made on Layer. A voice private to another ElevenLabs account can't be reached, and a voice ID that can't be used fails the run. Offered by the voice-import framework only. |
loudness | number-1–1 | — | Loudness of the designed voice. Offered by ElevenLabs voice-design only. |
guidance_scale | number0–100 | — | How closely the designed voice follows the prompt. Offered by ElevenLabs voice-design only. |
prompt_strength | number0–1 | — | Weight of the prompt against a reference clip, when the reference set holds one. Offered by ElevenLabs voice-design only. |
workspace_idrequired | string (uuid) | — | The user's workspace ID. |
project_id | string (uuid) | — | Optional project to train in; use list_projects to find project ids. The run follows that project's AI policy and the reference set is added to the project. |