Media

Create a presigned image upload ticket

The server generates the object key. Upload the exact declared number of bytes with PUT and copy every returned header. Supported media types are JPEG, PNG, WebP and GIF images (10 MiB), or MP4/WebM video and MP3/WAV audio (90 MiB, at most 600 seconds). Audio/video commit verifies format and measurable duration; it does not apply a platform content filter. LoRA weights are uploaded as application/octet-stream (a .safetensors file, up to 2 GiB; the ticket stays valid for 2 hours); commit checks that it is a complete safetensors file, and the returned URI goes in loras[].path. After PUT, call the file commit endpoint and use its spicy:// URI in task input.

post/api/v1/common/upload-url

Request

  • Base URL: https://api.spicyapi.ai
  • URL: https://api.spicyapi.ai/api/v1/common/upload-url
  • Auth: HTTP bearer

Request body

contentType'image/jpeg' | 'image/png' | 'image/webp' | 'image/gif' | 'video/mp4' | 'video/webm' | 'audio/mpeg' | 'audio/wav' | 'application/pdf' | 'application/msword' | 'application/vnd.openxmlformats-officedocument.wordprocessingml.document' | 'application/vnd.ms-excel' | 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet' | 'application/vnd.ms-powerpoint' | 'application/vnd.openxmlformats-officedocument.presentationml.presentation' | 'application/vnd.apple.keynote' | 'application/vnd.apple.pages' | 'application/vnd.apple.numbers' | 'text/plain' | 'text/markdown' | 'application/octet-stream' required
bytesinteger required

Images are limited to 10 MiB; supported audio/video and documents to 90 MiB; LoRA weights (application/octet-stream, a .safetensors file) to 2 GiB.

Response

Presigned upload ticket.

code200 required
msg'success' required
request_idstring required

Correlation identifier. Include it in support requests.

Changes

No recorded changes to this operation across all 1 revision of this API.