POST
/
project
/
assets
/
generate_video_from_audio
/
curl --request POST \
  --url https://api.deepreel.com/project/assets/generate_video_from_audio/ \
  --header 'Content-Type: application/json' \
  --header 'X-API-KEY: <api-key>' \
  --data '{
  "avatar_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "background_color": "<string>",
  "background_image": "<string>",
  "aspect_ratio": "16:9",
  "title": "<string>",
  "audio_url": "<string>"
}'
{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "estimated_completion_time": 123,
  "message": "<string>"
}

Authorizations

X-API-KEY
string
headerrequired

Your API key with the prefix: dr_. This is required by all endpoints to access our API programatically. You can view your API Key by navigating to the account settings panel (In the bottom left corner click on your Account → profile)

Body

avatar_id
string
required

The avatar to be used to generate the video

background_color
string
default: #3D3D3D

The background color video. A six-bit hex color code starts with #. (e.g. #DRDRDR) NOTE: The background_image will get preference over background_color if both are specified.

background_image
string | null

A public HTTPS link of an image (jpg/jpeg/png).

aspect_ratio
enum<string>
required

Aspect ratio of the video.

  • 16:9 - 16:9 - Standard widescreen
  • 9:16 - 9:16 - Vertical
  • 4:3 - 4:3 - Traditional TV format
  • 1:1 - 1:1 - Square
Available options:
16:9,
9:16,
4:3,
1:1
title
string | null

Title of the video. Length should be less than 100 characters.

audio_url
string
required

A public HTTPS link of an audio file (mp3).

Response

200 - application/json
id
string
required

Unique Identifier of the video.

estimated_completion_time
integer

Video generation estimated completion time in seconds.

message
string

Extra detail.

Create Video from TextGet list of Videos generated