SadTalkerSlowHigh

SadTalker

Talking-head video from a single photo and an audio track — animates the face with natural head motion and eye blinks, with optional GFPGAN face enhancement.

91 credits

per run (runtime grows with audio length)

One photo + audio → talking-head video

Natural head motion and eye blinks

Still mode for subtle motion

Optional GFPGAN face enhancement

Pose style and expression scale controls

Run it right now

Test this model instantly in the Console Playground — no code required

Use with AI Assistant

Copy usage instructions for Claude, ChatGPT, or other AI

llms.txtllms.txt ↗

Quick Start

curl -X POST "https://api.core.today/v1/predictions" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: cdt_your_api_key" \
  -d '{
  "model": "cjwbw/sadtalker",
  "input": {
    "source_image": "https://example.com/portrait.jpg",
    "driven_audio": "https://example.com/narration.wav",
    "preprocess": "full",
    "still_mode": true,
    "use_enhancer": true
  }
}'

Parameters

Parameter	Type	Required	Default	Description
`source_image`	string	Yes	-	Source face image (png/jpg, or a video)
`driven_audio`	string	Yes	-	Driving audio (.wav or .mp4)
`use_enhancer`	boolean	No	false	Use GFPGAN as face enhancer
`pose_style`	integer	No	0	Pose style
`expression_scale`	number	No	1	Larger values make expression motion stronger
`use_eyeblink`	boolean	No	true	Add natural eye blinks
`preprocess`	string	No	crop	How to preprocess the image (crop/resize/full/extcrop/extfull) cropresizefullextcropextfull
`size_of_image`	integer	No	256	Face model resolution 256512
`facerender`	string	No	facevid2vid	Choose face render facevid2vidpirender
`still_mode`	boolean	No	true	Fewer head motions (works with preprocess 'full')

How to Provide File Input

There are 3 ways to provide files for the source_imagedriven_audio parameters:

Recommended

Direct Upload (Multipart)

Attach files directly to POST /v1/predictions/upload. No separate upload step needed.

curl -X POST "https://api.core.today/v1/predictions/upload" \
  -H "X-API-Key: cdt_your_api_key" \
  -F "model=cjwbw/sadtalker" \
  -F 'input={"prompt":"your prompt here"}' \
  -F "file:source_image=@your_file.png"

Image URL

Pass a publicly accessible URL directly. You can also use file_url from the Storage API.

{
  "model": "cjwbw/sadtalker",
  "input": {
    "prompt": "your prompt here",
    "source_image": "https://example.com/image.jpg"
  }
}

See the File Upload docs for more upload methods including Presigned URLs.

Common Parameters

Common parameters used when calling POST /v1/predictions.

Parameter	Type	Required	Default	Description
`model`	string	Yes	-	Model identifier
`input`	object	Yes	-	Object containing the model-specific parameters from the table above
`output_folder`	string	No	-	Folder path for output files (max 256 chars, '..' not allowed)
`webhook_url`	string	No	-	Webhook URL to call on completion
`is_public`	boolean	No	false	If true, output files are also available via permanent public URLs

Examples

Photo Avatar Narration

Animate a portrait to speak a voiceover

curl -X POST "https://api.core.today/v1/predictions" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: cdt_your_api_key" \
  -d '{
  "model": "cjwbw/sadtalker",
  "input": {
    "source_image": "https://example.com/portrait.jpg",
    "driven_audio": "https://example.com/narration.wav",
    "preprocess": "full",
    "still_mode": true,
    "use_enhancer": true
  }
}'