Understanding Media Uploads
On the Indee platform, you can upload media such as videos, audio, and images for various entities like Video and Project. Indee offers two upload methods:
- Indee Downloaded (ID) Media: You provide a URL, and Indee downloads the media.
- Customer Uploaded (CU) Media: You receive a URL to upload media directly.
You can choose the appropriate method based on your specific use case.
Customer Uploaded (CU) Media
In this flow, you are provided with a URL as part of the media creation API response. This URL can be used to upload the media to Indee. The mechanism of upload is determined by the technology choices being made. For security reasons, the URL will be available for upload for a fixed period (typically 2 hours), after which it will be disabled.
Request and Response for the poster section will look like:
Request:
{
"upload_type": "CU",
"filename": "name.ext",
"filesize": 100,
"md5_hash": "as6789kcks67fufksjkjkjfskjkfsjfk"(optional param(character--32 length))
}
Response:
{
"url": "https://media.devtest.indee.tv/2582/2582_poster_1908335069.jpg?Expires=1708433103&Signature=SLya1ftOiEMsr1-3Ud5t3ufOcTORgU0aLMZoRxUb1TpjMKcPYQJXlrXSt8DgpLo87HjKtvkOY6kw5sylAjUY5P~hMbvr7S5Ow9Wog3Il2fzOZVVbYv8kKrkD8RUjKmPYL1k0e8D0M~npByY~hQq0RxmSyfEi~bNuOSn~jjr7BbU4pvp58Kp4EOv4iJxjYseSF~Ft8bpbNONpSeehRNRLTfL19YYOp5xwXkqcp2~LnfoKyQ9nyWktsDqXF29rnQUgV0D83VucpvE-fp-CAsPZzxuy0qskaq-o2qdB1ikJ3ruWf8vmAvXi8BDM8iSRmxTh3nwkVIlC3e3L15fDeoK4pw__&Key-Pair-Id=K2NTQVU4FZL5P0",
"status_code": "A3133",
"status_message": "Video poster added successfully"
},
Request for video param will look like:
{
"upload_type": "CU",
"filename": "name.ext",
"filesize": 150,(size of the file in bytes(int))
"md5_hash": "hash",(optional param(character--32 length))
}
Request and Response for the subtitle/audio_track section will look like:
Request:
{
"upload_type": "CU",
"language/track_name": "English",
"filename": "name.ext",
"filesize": 150,(size of the file in bytes(int))
"md5_hash": "hash",(optional param)
"default": true
}
Response:
{
"key": "sub-01xcv6t70xedtepht8b196krfg",
"kind": "captions",
"default": false,
"language": "English",
"url": "https://media-20220224063945059100000003.s3.amazonaws.com/2582/video/2582_60384_cdfeffc3-f174-47e7-8010-996747ebca6d_Aany1LnGDXgP9Pr.vtt?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=ASIAVH3HWP7HZ6SO6UHS%2F20240220%2Fus-west-1%2Fs3%2Faws4_request&X-Amz-Date=20240220T054503Z&X-Amz-Expires=36000&X-Amz-SignedHeaders=host&X-Amz-Security-Token=IQoJb3JpZ2luX2VjED0aCXVzLWVhc3QtMSJIMEYCIQCNsuml%2BdSiyDQhoa8GYbJ2LDXWE%2FpNHeldMGnx8MZKsQIhAPC3P2lbGG5jI3%2BMMGkDyHWjrQ4F38U%2FcXwX7Et5a8NXKu0DCCUQAhoMMzYwNDU3ODYzMTE5IgzN5S03kiTboN1z3JQqygMzpjwmC1x5M4ns3ivFTCDoTQjFYxOxCakaaFULJISD0CKR49S%2BhTv0lGOXE%2FWuLHMrIRA17yRWOaEVHeXmo%2FEuFXW7%2Feg%2Foaf5kdTFCAwIzbOZcyI%2FDzyWkrYd1Dm9YQda79YG3iCDPq9UT87o7W2nw8s99aFEjBmCY8FgVQs3GsR0q71An7dGZCmF5nU3CVH06Xk%2B6IsOoc48UrJihz0FPcpb1czW4MDlrb0vuUtYHHsNd1yzLXWC%2Fcsi047LYudgJYwoyw%2BXmn6vCnfvqGBszODhYybzaJChGOR4eBpBpkcYCowNgahDCZnj5%2BZwtidDLJZrTogEiKPF5bnUiBKgFeBVCgq8rkhC%2BzdMs%2B%2BD%2FGocQ6Ngd%2FAJu3ivVysoOuc2KHeCDQ9HIieIelpoaiuz6deAmuU7%2BBSaneyN2k3lnOEerx7v9m1iQgfxkHZ8hh2K5N3J5nymhsO5sjlJ4JHhWPxVIhrPT2Oud4lVeXky0Fif0SmDtUwwkhXPCZLfiSL7GaSD78ZHiFLZdsMyn%2FADMkYvvX1TJQruLo3dSPXN%2FpPtScIleVUGu0HLWpm2MKJFl7XXfok3%2BVyQgti6a5CV0GpbmvovcBrMqDDOztCuBjqkAfKj78akJCPFvA%2BjWvbkdNMly%2Bcxby2HGhg2zaRApx8tLIKks9WQw%2BzJR8o6kKYaEmB80jAY%2F8vsJnIYLcv5NmKs4tW2kipZx8EAI807wRaTYZcNX2%2Fu0y1MnMAQUsdfhgh0iWn6DvLzF8bprBu7fxXbHZ7Wl0976wSj4gESpc%2FKxtbJTKe5xA4SbjxxIljKDrxfm7T%2F%2FPYmVhp6C%2BefsJw45yoJ&X-Amz-Signature=4a0fd3736a4bca6222252727c51a65c56859469fd44b4f369b16e07a9c9b928b",
"status_code": "A3112",
"status_message": "Subtitle file uploaded successfully"
}
Indee Downloaded (ID) media
In this flow, you are provided with a media URL pointing to your storage location. Indee then initiates an HTTP request to download and process the media. The download is conducted from Indee's North American servers on AWS, requiring the URL to remain active for at least 2 hours.
Request and Response for the poster section will look like:
Request:
{
"upload_type": "ID",
"url": "https://media.indee.tv/video/poster/url.png"
}
Response:
{
"url": "https://media.devtest.indee.tv/2582/2582_poster_1908335069.jpg?Expires=1708433103&Signature=SLya1ftOiEMsr1-3Ud5t3ufOcTORgU0aLMZoRxUb1TpjMKcPYQJXlrXSt8DgpLo87HjKtvkOY6kw5sylAjUY5P~hMbvr7S5Ow9Wog3Il2fzOZVVbYv8kKrkD8RUjKmPYL1k0e8D0M~npByY~hQq0RxmSyfEi~bNuOSn~jjr7BbU4pvp58Kp4EOv4iJxjYseSF~Ft8bpbNONpSeehRNRLTfL19YYOp5xwXkqcp2~LnfoKyQ9nyWktsDqXF29rnQUgV0D83VucpvE-fp-CAsPZzxuy0qskaq-o2qdB1ikJ3ruWf8vmAvXi8BDM8iSRmxTh3nwkVIlC3e3L15fDeoK4pw__&Key-Pair-Id=K2NTQVU4FZL5P0",
"status_code": "A3133",
"status_message": "Video poster added successfully"
},
Request and Response for the subtitle/audio_track section will look like:
Request:
{
"upload_type": "ID",
"language": "English",
"url": "https://media.indee.tv/video/subtitle/url.vtt"
}
Response:
{
"key": "sub-01xcv6t70xedtepht8b196krfg",
"kind": "captions",
"default": false,
"language": "English",
"status_code": "A3112",
"status_message": "Subtitle file uploaded successfully"
}