logo
RunComfy
  • ComfyUI
  • TrainerNew
  • Models
  • API
  • Pricing
discord logo
MODELS
Explore
All Models
LIBRARY
Generations
MODEL APIS
API Docs
API Keys
ACCOUNT
Usage

HeyGen Image: Identity Remix Portraits from Reference Photos on Models and API | RunComfy

heygen/heygen-image/identity-remix

HeyGen Image keeps a face from identity photos and takes the scene from one reference.

Image 1
Image 2
Image 3
One to five photos of the same person. The face should be clear in each.
Image 1
Exactly one photo showing the pose, clothing, light, and setting. It must contain one face.
Output shape. Leave the job to follow the reference by choosing a listed ratio that matches it.
How many stills to return. They share one shape.
Optional starting seed. Leave empty for a new roll.
Idle
The rate is $0.25 per image.

Introduction To HeyGen Image

HeyGen's HeyGen Image keeps one person's face and borrows pose, clothes, and light from a reference at $0.25 per image.
Trading a new photo day for a restaged still suits campaign teams, casting desks, and thumbnail editors.
For developers, HeyGen Image on RunComfy can be used both in the browser and via an HTTP API, so you don't need to host or scale the model yourself.
Ideal for: Campaign Stills | Outfit Tests | Cover Portraits.

Why Choose This Page#


A headshot locks the clothes and the room. This page keeps the face from your identity photos and takes pose, outfit, light, and setting from one reference photo.


AdvantageWhat you get
Face from your setHeyGen Image takes one to five photos of the same person.
Scene from one frameExactly one reference supplies pose and clothes.
A shape you can setNine aspect ratios, or follow the reference.
Up to five stillsOne HeyGen Image job can return several images of that setup.

There is no text prompt. The photos are the brief. The reference must show one person. A second face fails the job.


On RunComfy, try the uploads in the model UI, then send the same URLs through the HTTP API.


Best Use Cases#


  • Campaign sets: HeyGen Image places one identity in several locations.
  • Outfit tests: Keep the face and swap the reference when clothes change.
  • Casting boards: One HeyGen Image person, several rooms, the gaze of the identity photos.
  • Covers: A vertical still from a 3:4 or 9:16 reference.
  • Opening frames: A HeyGen Image still here can later start a clip.

How It Works#


  1. Open the identity-remix template.
  2. Upload one to five clear photos of one person for HeyGen Image.
  3. Upload exactly one HeyGen Image reference with one face, in the pose and room you want.
  4. Choose an aspect ratio, or leave the shape to follow the reference.
  5. Set the count from 1 to 5. The default is 1.
  6. Set a HeyGen Image seed only when the next pass should stay near the first.
  7. Generate. The job finishes when every requested still is ready.
  8. For a HeyGen Image production, send identity_images, reference_images, aspect ratio, and count.

Parameters#


These are the controls on this page.


ParameterRequiredTypeDefaultRange / OptionsDescription
identity_images*Yes (*)Image URLsThree portraits1–5 imagesPhotos of the person whose face should remain.
reference_images*Yes (*)Image URLOne scene photoExactly 1 imagePose, clothing, light, and setting.
aspect_ratioNoString3:41:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9Output shape.
num_imagesNoInteger11–5How many stills. They share one shape.
seedNoIntegerEmpty0–4294967295Optional starting seed.

Identity photos do not set the HeyGen Image frame. The reference, or the ratio you pick, does.


Pricing#


HeyGen Image bills $0.25 per delivered image. Aspect ratio does not change it. Five images cost five times one image.


ImagesPrice
1$0.25
2$0.50
3$0.75
5$1.25

A failed job does not return a partial set.


Prompting & Reference Tips#


  • One person per file: HeyGen Image rejects two faces in the reference, and an identity photo with no face.
  • Match the gaze you want. Lens-facing HeyGen Image portraits tend to stay lens-facing.
  • Keep the head in frame. A cropped chin gives the model less to hold.
  • For HeyGen Image, change clothes in the photo, not in a caption. There is no text brief.
  • Same person only across the identity set.
  • Try one HeyGen Image still, then raise the count.
  • Use photos you may use: yourself, someone who agreed, or a look you are allowed to generate.

Related Models

z-image/turbo/image-to-image/lora

8-step Turbo model enabling rapid, high-quality visual edits for creators

q2/reference-to-image

High-speed model for consistent visual creation and precise design control

flux-2/dev/text-to-image

Flux 2 dev is an open-weight model for precise visual creation, color control, and consistent style rendering. Generate images at just $0.013 each.

nano-banana-2-lite/text-to-image

Fast, low-cost text-to-image generation at a fixed 1K resolution.

ideogram-v3/reframe

Change an image’s aspect ratio cleanly with Ideogram 3 Reframe.

flux-2/pro/edit

Edit detailed visuals fast with layout-aware, multi-reference control for brand-ready results.

Frequently Asked Questions

What is HeyGen Image used for in an image-to-image workflow?

HeyGen Image keeps a face from one to five identity photos and takes pose, clothes, light, and setting from exactly one reference photo. There is no text prompt. The photos are the brief.

How many photos does HeyGen Image need?

HeyGen Image needs 1 to 5 identity photos of the same person and exactly one reference. The reference should show one face. A second face in that photo fails the job, and an identity photo with no face is rejected.

Which shapes and counts can HeyGen Image return?

HeyGen Image aspect ratios are 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, and 16:9. The default shape is 3:4. One job can return 1 to 5 stills, and they share that shape.

What stays fixed when I change the HeyGen Image reference?

HeyGen Image holds the face from the identity set and takes the new pose, outfit, and room from the reference. Change clothes in the photo, not in a caption. Lens-facing portraits tend to stay lens-facing.

What input limits should I know before using HeyGen Image?

HeyGen Image accepts up to five identity photos and one reference. Keep the head in frame. Use photos of yourself, someone who agreed, or a look you are allowed to generate. A seed is optional when the next pass should stay near the first.

Can I try HeyGen Image in the Playground Web UI and then call the same model from the API?

Yes. Upload the photos for HeyGen Image in the Playground Web UI, then send the same identity URLs, reference URL, aspect ratio, and count through the RunComfy API. The API uses the same model. It does not promise a fixed turnaround or unlimited concurrency.

How much does it cost to generate with HeyGen Image on RunComfy?

HeyGen Image costs $0.25 per delivered image. Aspect ratio does not change the rate. Five images cost $1.25. Generations consume usd credits, and a failed job does not return a partial set.

Follow us
  • LinkedIn
  • Facebook
  • Instagram
  • Twitter
Support
  • Discord
  • Email
  • System Status
  • Affiliate
Video Models
  • OmniHuman 2.0
  • Wan 2.5
  • Wan 3.0
  • MiniMax H3 Max
  • Wan 2.6 Flash
  • Seedance 2.5 Reference to Video 1080p
  • View All Models →
Image Models
  • Wan 2.6 Image to Image
  • Nano Banana 2.1 Edit
  • Flux 2 Max Edit
  • Seedream 5.0 Pro
  • Nano Banana Pro
  • GPT Image 2.5 Sunburst
  • View All Models →
Legal
  • Terms of Service
  • Privacy Policy
  • Cookie Policy
RunComfy
Copyright 2026 RunComfy. All Rights Reserved.

RunComfy is the premier ComfyUI platform, offering ComfyUI online environment and services, along with ComfyUI workflows featuring stunning visuals. RunComfy also provides AI Models, enabling artists to harness the latest AI tools to create incredible art.

Examples Of HeyGen Image