Note: You must contact Hive to have streams allocated to your project before you can use this feature.
post
https://api.thehive.ai/api/v2/stream/frame
This endpoint supports generating image frames out of a video stream.
By default frames are generated at 1 per second.
Submit your stream using the key below:
- Use url for the streaming URL for your media.
EXAMPLES
curl --request POST \
--url https://api.thehive.ai/api/v2/stream/frame \
--header 'accept: application/json' \
--header 'authorization: token <API_KEY>' \
--form 'url=<STREAMING URL>' \
--form 'callback_url=https://webhook.site/#!/3f2cca3e-d386-44d8-9548-63275021a443'
var request = require("request");
var options = {
method: 'POST',
url: 'https://api.thehive.ai/api/v2/stream/frame',
headers: {
accept: 'application/json',
authorization: 'token <API_KEY>'
},
form: {url:"<STREAMING URL>",
callback_url:"https://webhook.site/#!/3f2cca3e-d386-44d8-9548-63275021a443"}
};
request(options, function (error, response, body) {
if (error) throw new Error(error);
console.log(body);
});
import requests
url = 'https://api.thehive.ai/api/v2/stream/frame'
headers = {"authorization": "token <API_KEY>", "accept": "application/json"}
data = {'url': '<STREAMING URL>', 'callback_url': 'https://webhook.site/#!/3f2cca3e-d386-44d8-9548-63275021a443'}
response = session.post("https://api.thehive.ai/api/v2/stream/frame", headers = headers, data = data)
RESULTS
{
"stream_id": "3faed5c0-2328-11ed-95cc-936b55ae22dc",
"message": "ok"
}
{
"return_code": 400,
"message": "Invalid stream url: https://not_a_real_url"
}
{
"return_code": 429,
"message": "You can not have more than 0 streams active"
}