文件上传

使用 POST /api/open/v1/uploads 上传本地音频、图片或视频，再把响应中的 URL 传给其他公开 API 工作流。

请求

使用 Kitta API Key 认证，并发送 multipart 表单。type 必须与文件 MIME 类型一致，可选值为 audio、image 或 video。

curl https://fishaudio.org/api/open/v1/uploads \
  -H "Authorization: Bearer $FISHAUDIO_API_KEY" \
  -F "type=audio" \
  -F "file=@sample.wav"

响应包含 success、requestId，以及含存储媒体 URL 的上传数据。仅在下游工作流需要时保留该 URL；上传媒体仍受产品数据保留策略约束。

每个已认证用户每分钟最多请求 30 次，同时受系统 multipart 请求体大小限制。媒体类型无效、MIME 类型不匹配、请求体过大或存储失败时，接口会返回稳定错误码和 requestId。

上传本身不会启动生成任务。请将返回的 URL 传给声音克隆、图片编辑、口型同步、视频配音或其他兼容接口。