Upload a file
Upload a file (multipart/form-data) and get back a file_<id>. The id can be passed as the image/video/reference_images source on POST /v3/videos. purpose defaults to reference_media (accepts common image/video types). The MIME type is detected from the bytes; size and per-org quota are enforced. Files are permanent until deleted; pass ttl_seconds to schedule an expiry.
file_<id> you can pass as a media source on later calls. See the Files guide.Authorizations
API key authentication. Pass your API key as a Bearer token.
Body
The file bytes.
Optional advisory filename (defaults to the upload's filename).
Intended use; gates the accepted MIME types.
Optional lifetime in seconds; omit for a permanent file. Can be changed later via PATCH /v3/files/{id}.