v4

latestOpenAPI 3.1.02026-08-086635375.7 KB

Voices

create voice presigned upload

Request a presigned URL for uploading a voice-clone audio clip directly to storage. Use this for clips larger than the ~4.5MB request-body limit of the multipart POST /v1/voices endpoint. Flow: (1) call this endpoint to get an uploadUrl and audioKey; (2) PUT the raw audio bytes to uploadUrl with the same Content-Type; (3) call POST /v1/voices with a JSON body referencing the audioKey to perform the clone.

post/v1/voices/presigned-upload

Request body

filenamestring required

Original filename of the audio clip (used to derive the storage key).

contentTypestring required

Audio MIME type (must start with audio/, e.g. audio/wav). The subsequent PUT must use the same value.

fileSizeinteger required

Size of the file in bytes. Required and must not exceed 50MB (52428800).

Response

Presigned upload URL generated

uploadUrlstring

Presigned URL to PUT the audio bytes to (valid for 1 hour).

audioKeystring

Opaque storage key to pass back to POST /v1/voices.