一次上传（不超过 100MB）

下方的接口说明（参数、请求和响应）是英文原文，字段名与接口完全一致。

Request Body

multipart/form-dataRequired

file

Required

File

purposePurpose

Default: "media_input"Value in: "media_input" | "reference_audio" | "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.

curl -X POST "https://api.beatra.cn/v1/uploads" \
  -H "Authorization: string" \
  -H "X-Request-Id: string" \
  -F file="string" \
  -F purpose="media_input" \
  -F media_type="image" \
  -F metadata="string"

Content already exists; returns existing artifact