HeyGen

Mode: video · Models: 1

Official API docs: developers.heygen.com

HeyGen Talking Photo turns a single portrait image into a lip-synced talking avatar that speaks a script you write, using a HeyGen voice. The script is read aloud via text-to-speech and the face is animated to match. Generation is asynchronous, and output runs up to 1080p in landscape or vertical.

Models

id	Name	Input type
heygen-talking-photo	HeyGen Talking Photo	i2v

CLI

# animate a portrait into a talking avatar (script must be at least 20 chars)
gen-ai generate -m heygen-talking-photo \
  -i ./portrait.jpg \
  -p "Hi there! Welcome to Picsart, where you can create anything you imagine." \
  --voice <voice-id> \
  --ar 16:9 -r 720p

# vertical short
gen-ai generate -m heygen-talking-photo \
  -i ./portrait.jpg \
  -p "Three quick tips to level up your edits — let's dive in." \
  --voice <voice-id> --ar 9:16 -r 1080p

MCP

{ "name": "picsart_generate",
  "arguments": {
    "model": "heygen-talking-photo",
    "prompt": "Hi there! Welcome to Picsart, where you can create anything you imagine.",
    "imageUrls": ["https://example.com/portrait.jpg"],
    "voiceId": "<voice-id>",
    "aspectRatio": "16:9",
    "resolution": "720p"
  } }

Parameters

Full parameter surface for every model, sourced from gen-ai models info <id> --json. CLI flags show the primary short form; the canonical --kebab-case long form always works too.

heygen-talking-photo — HeyGen Talking Photo

Try heygen-talking-photo in Playground ↗

Input type: i2v

Param	CLI flag	Type	Values
imageUrls	-i	file	required image (up to 1)
resolution	-r	enum	1080p · 720p (default 720p)
aspectRatio	--ar	enum	16:9 · 9:16 (default 16:9)
voiceId	--voice	enum	required
prompt	-p	text	required (≤1500 chars)

Notes: Voice ids are dynamic — list them at runtime rather than hard-coding. Generation is asynchronous; the result URL is polled in the background.

Pricing

gen-ai pricing heygen-talking-photo -r 720p

Cost scales with resolution and the length of the generated video (driven by your script). Trial/free credits burn a HeyGen watermark into the output and may cap resolution — production videos require paid credits.