v1

latestOpenAPI 3.0.02026-07-26117076.0 KB

File Upload

Upload File Stream

Upload files using multipart/form-data format. Supports image uploads and video uploads. Videos are stored under the temp/videos prefix by default, are limited to 100MB, and expire after 24 hours.

post/api/common/upload/stream

Response

File uploaded successfully

successboolean required

Indicates whether the upload was successful

codeinteger required

HTTP status code

msgstring required

Response message

Example response

{
  "success": true,
  "code": 200,
  "msg": "File uploaded successfully",
  "data": {
    "file_id": "1bdfdbac6ebc2228d0b398d728bf4699",
    "file_name": "test-image.png",
    "original_name": "image-from-url.png",
    "file_size": 1419815,
    "mime_type": "image/png",
    "upload_path": "temp/test-uploads",
    "file_url": "https://storage.poyo.ai/temp/test-uploads/test-image.png",
    "download_url": "https://storage.poyo.ai/temp/test-uploads/test-image.png",
    "upload_time": "2025-12-29T13:08:57.673515",
    "expires_at": "2026-01-01T13:08:57.673515"
  }
}