beatra

Single-shot upload (≤100MB)

POST
/v1/uploads

Request Body

multipart/form-dataRequired
file
Required
File
purposePurpose
Default: "media_input"Value in: "media_input" | "reference_audio" | "transcription_input" | "voice_clone_source"
media_typeMedia Type
metadataMetadata

Header Parameters

Authorization
Required
string

Bearer API key.

X-Request-Idstring

Optional client request id echoed in the response.

Idempotency-Keystring

Optional idempotency key for safe retries of mutating requests.

curl -X POST "https://example.com/v1/uploads" \
  -H "Authorization: string" \
  -H "X-Request-Id: string" \
  -H "Idempotency-Key: string" \
  -F file="string" \
  -F purpose="media_input" \
  -F media_type="image" \
  -F metadata="string"

Content already exists; returns existing artifact