PvcVoiceService
Train a PVC voice
Start training a professional voice clone (PVC) from its uploaded samples, then poll the voice to track progress.
/voices/v1/pvcVoices/{pvcVoiceId}:trainThis endpoint does not return an Operation. There is no separate operation ID to look up. Poll Get a PVC voice directly.
Training requires at least 600 seconds (10 minutes) of sample audio in total, measured after any trims.
Your plan limits how often you can start training. Exceeding that rate returns 429, with an error message that names the limit. Wait before trying again rather than retrying in a loop. See Plan limits for each plan's allowance.
A voice in PVC_VOICE_STATE_READY cannot be trained again. The request returns 409. To retrain, create a new PVC voice. See Retrain or remove a trained voice.
How long training takes
Training time depends on how much audio you uploaded, not how many samples it is split across. As a rough guide, an hour of audio takes about 10-30 minutes to train. It may take longer under heavy platform demand.
Model training is capped at roughly 2800 seconds of audio and 1000 MB of source data per run. Audio beyond the cap is silently truncated rather than rejected. Keep total sample audio comfortably below the cap when uploading long recordings.
PVC voice ID, derived from displayName at creation time. Use this value as {pvcVoiceId} on every other PVC endpoint. It is not the voice ID used for synthesis; see customVoice.
Legacy enum form of the voice's language, such as EN_US. Returned alongside languageCode. Immutable after creation.
Available options:EN_USZH_CNKO_KRJA_JPRU_RUAUTOIT_ITES_ESPT_BRDE_DEFR_FRAR_SAPL_PLNL_NLHI_INHE_IL
The voice's language as a BCP-47-shaped locale string, e.g. en-US. Immutable after creation.
Lifecycle state of a PVC voice.
PVC_VOICE_STATE_DRAFT: Editable. Samples can be added, trimmed, or removed, and metadata can be updated.PVC_VOICE_STATE_QUEUED: Training requested; waiting for a training slot.PVC_VOICE_STATE_TRAINING: Actively training.PVC_VOICE_STATE_READY: Training succeeded. Usable for TTS synthesis. It's permanent and cannot be deleted through this API.PVC_VOICE_STATE_FAILED: Training failed. Editing the voice (e.g. renaming it, or adding/removing a sample) returns it toPVC_VOICE_STATE_DRAFTwith its remaining samples intact.
Available options:PVC_VOICE_STATE_UNSPECIFIEDPVC_VOICE_STATE_DRAFTPVC_VOICE_STATE_QUEUEDPVC_VOICE_STATE_TRAININGPVC_VOICE_STATE_READYPVC_VOICE_STATE_FAILED
Populated on a PVC voice when its state is PVC_VOICE_STATE_FAILED.
Show child attributes
Machine-readable failure code, such as PVC_VOICE_FAILURE_REASON_INVALID_SAMPLES. New values may be added over time, so don't validate against a hardcoded list. Fall back to displaying message for codes you don't recognize.
Resource name of the trained voice, in the format workspaces/{workspace}/voices/{voice}. Set once the voice is PVC_VOICE_STATE_READY. Manage and use the trained voice through the Voices API.
Audio samples currently attached to the voice.
Show child attributes
Size of the uploaded file, in bytes. Encoded as a string, like other 64-bit integers in this API.
Detected audio format, sniffed from the file's byte content.
Available options:audio/wavaudio/webmaudio/mpeg
Base64-encoded MD5 of the stored object, for verifying upload integrity against the source file.
Whether background-noise removal is applied to this sample during training, as set by remove_background_noise on upload.
How the sample is used in training. PVC_SAMPLE_ROLE_UNSPECIFIED is treated as PVC_SAMPLE_ROLE_TRAINING (ordinary training material). PVC_SAMPLE_ROLE_GOLDEN marks a positive reference whose character training should prefer; PVC_SAMPLE_ROLE_AVOID marks an advisory negative reference. New values may be added over time.
Available options:PVC_SAMPLE_ROLE_UNSPECIFIEDPVC_SAMPLE_ROLE_TRAININGPVC_SAMPLE_ROLE_GOLDENPVC_SAMPLE_ROLE_AVOID