Skip to content

Live Portrait · Image

Integrate

Model id live-portrait/image
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/live-portrait/image?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Up to $1.125 per run charged by actual usage, the rest is refunded Run it on this page

Get API key
Kuaishou Image Editing #expression#animation

Edits a single portrait's expression and head pose using sliders, outputting a still image

Kuaishou · Image

Your first result goes here

Build a request below and run it with your API key. Outputs are copied to our storage, kept forever or 7 days for free.

Build a request

Controls are generated from the model schema. The code and the price update as you change them.

•required image_url
Drop a file, or

Image URL for animation.

Advanced output_format · blink · eyebrow · wink · pupil_x · pupil_y · aaa · eee · woo · smile · rotate_pitch · rotate_yaw · rotate_roll · dsize · scale · vx_ratio · vy_ratio · flag_pasteback · flag_do_crop · flag_do_rot · flag_lip_zero · enable_safety_checker
output_format default jpeg

Format used for output.

default 0
default 0

Degree of eyebrow raising or lowering.

default 0

Degree of winking.

default 0

Horizontal pupil movement amount.

default 0

Vertical pupil movement amount.

default 0

Degree of mouth opening into the 'aaa' shape.

default 0

Degree of mouth shaping into the 'eee' position.

default 0

Degree of mouth shaping into the 'woo' position.

default 0

Degree of smiling.

default 0

Face rotation amount along the pitch axis.

default 0

Face rotation amount along the yaw axis.

default 0

Face rotation amount along the roll axis.

default 512

Dimensions of the resulting image.

default 2.3

Scale multiplier applied to the face crop.

default 0

Ratio controlling the face crop's horizontal offset.

default -0.125

Face-crop vertical positioning ratio: the sign determines direction, upward for positive values and downward for negative values.

POST /run/live-portrait/image?wait=20 quote → $1.125
# Run the model; wait up to 20 s for the finished result in the same call
curl -X POST "https://api.doitong.com/v1/run/live-portrait/image?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "image": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  }'

# Still "queued" or "running"? Poll with the id from the response:
curl "https://api.doitong.com/v1/requests/REQUEST_ID?wait=20" \
  -H "Authorization: Bearer $DOITONG_API_KEY"

Run this request

Your key stays in this browser: it is sent only to the Doitong API and saved (localStorage) only if you tick Remember. Get an API key

About Live Portrait · Image

Adjusts the face in one portrait photo without any driving video. Sliders cover blink, eyebrow, wink, pupil position, mouth shapes (aaa, eee, woo), smile and head rotation (pitch, yaw, roll). Crop options such as `flag_do_crop` and `scale`, plus `dsize` (default 512), control the face crop. Output is jpeg by default, or png.

Parameters

Send either the canonical name or the native name, not both. Canonical names

NameType DefaultAllowed Description
image_urlrequired image
Typeurl · image
Image URL for animation.
eyebrowoptional
Typenumber
Default0
-30 – 30
Degree of eyebrow raising or lowering.
winkoptional
Typenumber
Default0
0 – 25
Degree of winking.
pupil_xoptional
Typenumber
Default0
-45 – 45
Horizontal pupil movement amount.
pupil_yoptional
Typenumber
Default0
-45 – 45
Vertical pupil movement amount.
aaaoptional
Typenumber
Default0
-200 – 200
Degree of mouth opening into the 'aaa' shape.
eeeoptional
Typenumber
Default0
-40 – 40
Degree of mouth shaping into the 'eee' position.
woooptional
Typenumber
Default0
-100 – 100
Degree of mouth shaping into the 'woo' position.
smileoptional
Typenumber
Default0
-2 – 2
Degree of smiling.
rotate_pitchoptional
Typenumber
Default0
-45 – 45
Face rotation amount along the pitch axis.
rotate_yawoptional
Typenumber
Default0
-45 – 45
Face rotation amount along the yaw axis.
rotate_rolloptional
Typenumber
Default0
-45 – 45
Face rotation amount along the roll axis.
flag_pastebackoptional
Typeboolean
Defaulttrue
Paste-back/stitching option that places the animated face crop into the original image, mapping it out of face-crop coordinates.
flag_do_cropoptional
Typeboolean
Defaulttrue
Controls whether the source portrait is cropped into the face-crop coordinate space.
flag_do_rotoptional
Typeboolean
Defaulttrue
Controls whether rotation is performed when flag_do_crop is true.
flag_lip_zerooptional
Typeboolean
Defaulttrue
Pre-animation lip closure, applicable only with both flag_eye_retargeting and flag_lip_retargeting set to False.
dsizeoptional
Typeinteger
Default512
Dimensions of the resulting image.
scaleoptional
Typenumber
Default2.3
Scale multiplier applied to the face crop.
vx_ratiooptional
Typenumber
Default0
Ratio controlling the face crop's horizontal offset.
vy_ratiooptional
Typenumber
Default-0.125
Face-crop vertical positioning ratio: the sign determines direction, upward for positive values and downward for negative values.
enable_safety_checkeroptional
Typeboolean
Defaultfalse
Controls whether safety checking is enabled. When active, the checker processes the input image to verify that it contains a face before model processing.
output_formatoptional
Typeenum
Defaultjpeg
jpegpng
Format used for output.
required Canonical name, also accepted

File parameters take a public https:// URL, a data: URI up to 10 MB, or the file_url of an upload. Files

Output

GET /requests/req_8k2m4q7x1z9c3v5b6n0p2r4t
{
  "id": "req_8k2m4q7x1z9c3v5b6n0p2r4t",
  "object": "request",
  "model": "live-portrait/image",
  "status": "succeeded",
  "created_at": "2026-10-20T12:00:00Z",
  "started_at": "2026-10-20T12:00:02Z",
  "completed_at": "2026-10-20T12:00:09Z",
  "queue_position": null,
  "cost": {
    "credits": 1125,
    "usd": "1.125",
    "charged": 1125,
    "refunded": 0
  },
  "input": {
    "image_url": "https://content.doitong.com/images/showcase/v3/gen_fox_cartoon.jpg"
  },
  "output": {
    "image": {
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
      "content_type": "image/jpeg",
      "file_name": "0-output.jpeg",
      "file_size": 1843200,
      "width": 1024,
      "height": 768
    }
  },
  "outputs": [
    {
      "type": "image",
      "url": "https://content.doitong.com/dev-api/2026/10/20/req_8k2m4q7x1z9c3v5b6n0p2r4t/0-output.jpeg",
      "content_type": "image/jpeg",
      "file_size": 1843200,
      "width": 1024,
      "height": 768,
      "stored": true
    }
  ],
  "error": null,
  "metrics": {
    "inference_seconds": 6.8
  },
  "urls": {
    "self": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t",
    "cancel": "https://api.doitong.com/v1/requests/req_8k2m4q7x1z9c3v5b6n0p2r4t/cancel"
  }
}
Your files, your choiceEvery outputs[].url is a copy on our storage: kept forever (paid per GB-month) or 7 days for free, by your account setting or ?storage=.
Same shape on every modeltype, url, content_type, width, height and duration, for images, video and audio alike. output is the model’s own result object.
Fields of output
image
object {url, content_type, file_name, file_size, width, height}Image file produced by generation.

More models: Image Editing

For AI agents: this page as Markdown is at https://doitong.com/en-US/developers/models/live-portrait/image.md. All models and guides: https://doitong.com/developers/llms.txt