Endpoints
Uploads
Send a local image, video or audio file to a video job, past the request size limit.
Upload a local file once, then use its id in any media field of POST /v1/videos. The file goes straight into private storage, so it can be far larger than a request body (up to 200MB for a video).
https://api.roteo.ai/v1/uploadshttps://api.roteo.ai/v1/uploads/{id}Three calls
- Ask for an upload link:
POST /v1/uploadswith the file'scontent_type. - Upload the file with a plain
PUTto the returnedupload_url, sending the samecontent-type. - Use the
idinreference_videos,reference_audios,input_reference/reference_imagesorlast_reference, or inupscaleto sharpen it to 1080p (Upscale), with"consent": true.
Create an upload link
content_typestringrequiredvideo/mp4 or video/quicktime (MOV) for a video; image/png, image/jpeg or image/webp for an image; audio/mpeg (MP3) or audio/wav for audio.
The response (201):
PUT the file to upload_url with the headers shown. The link works once, until expires_at.
Rules
Delete an upload
DELETE /v1/uploads/{id} removes one of your uploads right away, without waiting for a job or the hourly cleanup. It returns { "id": "...", "object": "upload", "deleted": true }, or 404 when there is nothing of yours under that id.