Upload a original video

First of all, upload a original video to request SR(super-resolution).

request a uploading video#

bash
curl -X POST \
"https://develop.kokoon.cloud/kokoon/api/sr/v4.1/video" \
  -H 'Authorization:eyJraWQiOiJPMGs5...eyJzdWIiOiIzN2U3NzYxM' \
  -F "file=@original.mp4"

request body parameter#

body format : multipart/form-data

field	type
file	original binary file to upload.

Restriction
- Input File’s Limits
  - Container : mp4, mkv, mov
  - Codec : h264, h265
  - Resolution : 160x160 ~ 3840x2160 (2160x3840)
    - Both width and height must independently satisfy the minimum and maximum limits.
    - When requesting an upscaled model, the original file size is limited to a maximum of 2560x1440 (1440x2560).
  - Frame : 20 frames or more
  - Duration : No limits
  - Size: 2GB or less

response#

json
{
  "uid": "539e3480-929a-11ee-ada2-51e4bfe11414",
  "vid": "de5e9990-c0fb-11ee-961f-d12490e606ad",
  "pid": "00000000-0000-0000-0000-000000000000",
  "tid": "00000000-0000-0000-0000-000000000000",
  "created_time": "2024-02-01T12:17:32.699Z",
  "filename": "original.mp4",
  "size": 939073,
  "codec_name": "h264",
  "fps": "30/1",
  "duration": "10.000000",
  "nb_frames": "300",
  "bitrate": "739484",
  "width": 640,
  "height": 360,
  "download_cnt": 0,
  "expired_time": "2024-02-15T12:17:32.699Z",
  "state": "completed",
  "url": "https://sr-inner-api-storage-local.s3.amazonaws.com/video/539e3480-929a-11ee-ada2-51e4bfe11414/...",
  "thumb_url": "https://sr-inner-api-storage-local.s3.amazonaws.com/video/539e3480-929a-11ee-ada2-51e4bfe11414/...",
  "is_rotated": false,
  "is_interlaced": false
}

response body field#

field	type	description
uid	string	user's unique id
vid	string	video unique id
pid	string	parent_id : if video file is original, parent_id is '00000000-0000-0000-0000-000000000000'. if video file is SR result, parent_id is original file's vid used when SR is requested.
tid	string	SR task_id : if video file is original, task_id is '00000000-0000-0000-0000-000000000000'. if video file is SR result, task_id is a unique task-id recevied when SR is requested.
created_time	string	original video's uploading completion time.
filename	string	original video's filename.
size	int	original video's filesize.
codec_name	string	original video's codec_name.
fps	string	original video's fps(frame per second).
duration	string	original video's duration.(seconds)
nb_frames	string	original video's number of total frames.
bitrate	string	original video's bitrate.(bits per second)
width	int	original video's width.
height	int	original video's height.
download_cnt	int	original video's downloding count. We cannot figure out that a user really downloaded a original file with url. But we can provide a download-inc-count API. After a user really download a file with url, if call download-inc-count API, download_cnt will be increased.
expired_time	string	original videos' expired time. original video will be expired after 14day later from created_time.
state	string	original videos' state. In case of original file, state is always 'completed'. state : pending : SR video creation is requested. processing : SR video creation is in processing. completed : SR video creation is completed. error : SR video creation is failed.
url	url	original video's url.
thumb_url	url	original video's thumbnail url.
is_rotated	boolean	when true, it indicates that original video is rotated with +90 degree or -90 degree.
is_interlaced	boolean	when true, it indicates that original video is interlaced.

error response#

timeout error