Skip to main content
POST
AI Talking Avatar

Headers

Authorization
string

Body

application/json
model
enum<string>
required

Model name. Must be ai-talking-avatar.

Available options:
ai-talking-avatar
image_url
string<uri>
required

Portrait image of the speaker (up to 10MB). Required. The face must be clearly visible, unobstructed and roughly front-facing.

audio_url
string<uri>
required

Speech audio to lip-sync to (up to 50MB). Required. 3-60 seconds, unless duration is set — then the audio only needs to be at least duration seconds long. Its measured duration sets the output length and the price when duration is not set.

prompt
string
default:person talking

Optional description of the desired performance, e.g. a woman speaking calmly to the camera.

resolution
enum<string>
default:540p

Output resolution. 720p costs twice as much per second as 540p.

Available options:
540p,
720p
duration
integer

Optional. Output length in whole seconds (3-60). Only the first duration seconds of the audio are used, and you are billed for duration seconds. Must not exceed the audio length. Omit it to use the full audio.

Required range: 3 <= x <= 60
Example:

15

custom_callback_url
string<uri>

Optional. A publicly accessible HTTPS URL. When the task status changes (processing / success / failed), GoEnhance sends a POST request to this URL. The request body is identical to the response of GET /api/v1/jobs/detail. If your server does not respond with HTTP 200, the notification is retried up to 3 times, with a 3-second timeout per attempt.

Example:

"https://your-server.com/goenhance/callback"

Response

code
integer
required
msg
string
required
data
object
required