Skip to main content
POST
Make a talking avatar video
Animates a portrait so it speaks. Send either a transcript (read in voice_id) or an audio_url; either way the speech can be up to 20 seconds. Costs 10 credits. voice_id takes a MiniMax preset, an Eleven v3 voice or one of your cloned voices; see List voices you can use. Poll Poll video status with generation.id.

Authorizations

Authorization
string
header
required

An Unsora API key (uns_…). A Clerk session token also works.

Body

application/json
image_url
string<uri>

Portrait image. Send this or image_asset_id.

image_asset_id
string

An IMAGE asset of yours (e.g. from POST /uploads) instead of image_url.

transcript
string

What the avatar says, read in voice_id. Send this or audio_url; it must fit in 20 seconds of speech.

Maximum string length: 2000
audio_url
string<uri>

Speech audio (MP3, WAV or M4A) up to 20 seconds, instead of transcript.

voice_id
string
default:Friendly_Person

Voice for transcript: a MiniMax preset, an Eleven v3 voice, or one of your cloned voices (see GET /voice-clones).

emotion
enum<string>
default:neutral
Available options:
happy,
sad,
angry,
fearful,
disgusted,
surprised,
neutral
prompt
string

Optional direction for the performance.

resolution
enum<string>
default:720p
Available options:
480p,
720p
model
enum<string>
default:skyreels-v3
Available options:
skyreels-v3

Response

Job queued

success
boolean
required
generation
object
required
creditsDeducted
integer
creditsRemaining
integer