Get a presigned URL for direct file upload to cloud storage

POST 
/v2/{media_type}/upload-url

Returns a signed URL that allows the client to upload a file directly to cloud storage via HTTP PUT. This avoids sending the file through the backend, eliminating upload timeouts for large files.

Flow:

1. Call this endpoint to get a signed upload URL
2. PUT the file directly to the signed URL with the required headers
3. Call the regular POST /v2/videos or /v2/audios endpoint with the returned public_url

public_url is a reference to submit in step 3, not a guaranteed-readable URL: media may be stored privately. To play media back, call GET /v2/videos/{video_id}/playback-url or GET /v2/audios/{audio_id}/playback-url.

Request

Responses

200

Successful Response

402

Refused before the URL is issued. Either the payer's balance is non-positive, or a plan usage window (daily / weekly / monthly) is exhausted. Not an affordability check: admission is balance > 0, not balance >= cost, so an account holding fewer credits than this upload will cost still receives a URL and goes into debt when the media is submitted. Credits are deducted at submit time (step 3), never here.

422

Validation Error