VEED
Search…
Creating an asset
You can store and process your videos, images & audio as Assets, in our API.
Uploading a new asset
To create a place for your new asset you will need to send a
POST /assets request to our API:REQUEST
1
curl \
2
-X POST \
3
--header "Authorization: veed_test_oEnZhnd3vg0LEoTs6Z9Ij" \
4
https://api.veed.dev/assets
Copied!
RESPONSE
1
{
2
"id": "28a510a8-6690-4cdc-b319-e0e02ebf1a2e",
3
"type": "video",
4
"url": "https://cdn.veed.dev/380rreVE_9uhiksitOGIW.mp4"
5
}
Copied!
You can then use the
url returned (in the response) as the destination for uploading your asset:REQUEST
1
curl \
2
--upload-file video.mp4 \
3
https://cdn.veed.dev/380rreVE_9uhiksitOGIW.mp4
Copied!
Using the asset
Now you have uploaded your video, audio or image, as an asset, you can use the API to make changes to it.
First, you need to construct a
render object (you can read more about that here, under 'Constructing the render object')When constructing the
render object, you can now use the asset id as a source (instead of a public url). The elements being used must match that type of asset (in this case, video).RENDER OBJECT w/ url sro
1
{
2
"elements": [
3
{
4
"type": "video",
5
"params": {
6
"source": {
7
"url": "https://cdn.veed.dev/380rreVE_9uhiksitOGIW.mp4"
8
},
9
"trim": {
10
"from": 2.0,
11
"to": 5.0
12
}
13
}
14
}
15
]
16
}
Copied!
Now, we are going to use the asset
id instead of the url . The request looks like this:1
{
2
"elements": [
3
{
4
"type": "video",
5
"params": {
6
"source": {
7
"asset_id": "28a510a8-6690-4cdc-b319-e0e02ebf1a2e"
8
},
9
"trim": {
10
"from": 2.0,
11
"to": 5.0
12
}
13
}
14
}
15
]
16
}
Copied!
Processing
Here are 2 operations you can perform on your video and audio assets - cleaning and transcribing. The first is used to clean the audio of background noise. The second is used to transcribe speech into text.
Cleaning
When creating an asset, you can pass in a
clean: true field into the body of the request, and your file will be cleaned from all background noise, as soon as it's uploaded:1
curl \
2
--request POST \
3
--header "Content-Type: application/json" \
4
--data '{ "clean": true } ' \
5
https://api.veed.dev/assets
6
​
Copied!
Transcribing
You can also pass in a
transcribe: true field into the body of the request when creating an asset, and any speech that is detected will be transcribed into text, as soon as it's uploaded. The text will be stored in the transcription field of the asset object once finished:1
curl \
2
--request POST \
3
--header "Content-Type: application/json" \
4
--data '{ "transcribe": true } ' \
5
https://api.veed.dev/assets
Copied!
An asset object once transcription is done
1
{
2
"id": "28a510a8-6690-4cdc-b319-e0e02ebf1a2e",
3
"type": "video",
4
"url": "https://cdn.veed.dev/380rreVE_9uhiksitOGIW.mp4",
5
"trancription": [
6
{ "value": "Hey, how are you?", "from": "1.54", "to": "3.34" },
7
{ "value": "This is an example of transcription feature", "from": "3.73", "to": "5.26"},
8
]
9
}
Copied!
Last modified 1yr ago
Copy link