Skip to main content

Creating a lyric video

Once you have a song with vocals, you can create a lyrics video that animates a user's picture. This requires two steps: uploading a profile picture and generating the lyric video.

Upload a profile picture​

For this step, upload a headshot with a plain background as possible.

Full API reference

Upload a profile picture
POST /recordings/{recordingSessionId}/videoImage/{userId} HTTP/1.1
Host: example.com
Content-Type: multipart/form-data; boundary=boundary-example
{
  file: image.jpg
}

Generate a video​

After uploading the profile picture, call this endpoint to generate the lyric video.

Full API reference

Generate a video
POST /recordings/{recordingSessionId}/video/{userId} HTTP/1.1
Host: example.com
Content-Type: multipart/form-data; boundary=boundary-example
{
  userId: integer
}

You'll receive an MP4 file back, which can be played directly in your web browser or saved for later use.