Upload a file for workflow inputs

Use file upload when your images, videos, audio, or subtitle files are not already hosted at public HTTPS URLs. The returned HTTPS URL can be used directly in `images`, `reference_videos`, `audio_url`, or `srt_url`. Limits: - Images, audio, and subtitles: maximum 50 MB. - Motion videos: maximum 100 MB. - Images: `png`, `jpg`, `jpeg`, `webp` (`image/png`, `image/jpeg`, `image/webp`). - Audio: `mp3`, `wav`, `aac`, `m4a` (`audio/mpeg`, `audio/wav`, `audio/aac`, `audio/mp4`). - Audio uploads must be 10-300 seconds. The selected Music Video tier applies its own task limit: Standard 10-180 seconds; Premium 10-300 seconds. - Motion videos: `mp4`, `mov` (`video/mp4`, `video/quicktime`), 3-30 seconds. Duration and dimensions are detected during upload. - Subtitles: `srt` (`application/x-subrip`; multipart uploads may use `text/plain` only when the filename ends in `.srt`). - PDF, generic text files, octet-stream uploads, Matroska videos, and zip files are not supported for launch. - Send either multipart form-data with a `file` field, or send the raw file body with the asset `Content-Type`. - `Content-Length` is required and is validated before BeatAPI buffers the request body; chunked uploads without a declared length are rejected. - Returned URLs are HTTPS and long-lived for launch. - Uploaded audio files are duration-checked during upload. The response includes `audio_duration_seconds` when the uploaded asset is audio. - Uploaded videos are signature-, duration-, and dimension-checked. The response includes `video_duration_seconds`, `width`, and `height`. - Workflow task inputs still require public HTTPS URLs. Localhost, private network URLs, and data URLs are not accepted.

身份验证

AuthorizationBearer

Send your API key as Authorization: Bearer <BEATAPI_API_KEY>.

请求

This endpoint expects a multipart form containing a file.
filefile必需
purposeenum可选
允许的值:

响应

File uploaded
dataobject
Uploaded file metadata and the public HTTPS URL to use in later requests.

错误

400
Bad Request Error
401
Unauthorized Error
429
Too Many Requests Error
500
Internal Server Error