Sign in
Public API v1

Upload a reference audio file

Upload an audio file (WAV, MP3, OGG, FLAC) to S3 storage. Returns a fileId you can use as refFileId in voice-clone TTS requests. Max file size: 10 MB. The presigned download URL is valid for 24 hours.

post/api/v1/upload

Response

The stored file. Pass fileId as refFileId to POST /api/v1/clone.

fileIdstring required

Unique file identifier (S3 key). Pass this as refFileId in future voice-clone requests.

fileNamestring required
mimeTypestring required
sizenumber required

File size in bytes.

urlstring required

Presigned S3 download URL. Valid for 24 hours.

urlExpiresInnumber required
uploadedAtstring required

Example response

{
  "fileId": "uploads/user-123/1716000000000_abc123.wav",
  "fileName": "my-voice.wav",
  "mimeType": "audio/wav",
  "size": 204800,
  "url": "https://s3.amazonaws.com/bucket/uploads/user-123/…?X-Amz-Expires=86400",
  "urlExpiresIn": 86400,
  "uploadedAt": "2026-05-17T10:00:00.000Z"
}

Changes

No recorded changes to this endpoint across all 1 revision of this API.