API Free WeekHundreds of APIs are free to call this week.Browse free APIs

HeyGen Video Reference to Video

heygen/heygen-video/reference-to-video

HeyGen Video Reference to Video generates a 5-15 second video guided by reference images, videos and audio.

Base price
$0.50USD / run
Execution
async
Model type
video
Input fields
7
Production route

Try the model

Playground

Open playground
Input
Describe the scene, action, camera and sound.

PNG, JPEG, WebP, or GIF · 20 MiB maximum each · up to 9

Up to 9 reference images (characters, products, scenes).
Up to 3 reference videos for motion or style.
Up to 3 reference audio clips (voice or music).
Output frame shape. adaptive follows the references. Allowed values: adaptive, 21:9, 16:9, 4:3, 1:1, 3:4, 9:16.
Output resolution. 1080p and 2k cost more. Allowed values: 480p, 768p, 1080p, 2k.
515
Output length in seconds (5-15). Range: 5 to 15.
OutputExample

Examples

Select an example to load its inputs and result into the playground.

Model card

Specifications

Pricing

Base price
$0.50 / run

Context & modalities

Input
Schema-defined
Output
video

Capabilities

Chat
Not supported
Vision
Not supported
Reasoning
Not supported
Structured output
Not supported
Function calling
Not supported
Audio input
Not supported

Access

Provider
HeyGen
Model ID
heygen/heygen-video/reference-to-video
Execution
async
Base URL
https://api.sandbase.ai
API
Unified Run API
Endpoint
/v1/run

API README

HeyGen Video Reference to Video

HeyGen Video Reference to Video generates a 5–15 second video guided by reference images, videos and audio clips.

Fields

FieldTypeDefaultNotes
promptstring, required—Scene and action; describe how each reference is used.
imagesimage URL[]—Up to 9 reference images (characters, products, scenes).
videosvideo URL[]—Up to 3 reference videos for motion or style.
audiosaudio URL[]—Up to 3 reference audio clips (voice or music).
aspect_ratioadaptive / 21:9 / 16:9 / 4:3 / 1:1 / 3:4 / 9:16adaptiveadaptive follows the references.
resolution480p / 768p / 1080p / 2k768pOutput resolution; 1080p and 2k cost more.
duration5–155Output length in seconds.

Billing

Billed per output second: $0.07 at 480p, $0.10 at 768p, $0.18 at 1080p and 2k. References are not billed separately.

OutputPrice
5s, 768p (default)$0.50
5s, 480p$0.35
10s, 1080p$1.80
Failed runs are not charged.

Prompting

  • Say which reference is the subject and which sets motion, style or sound.

Limits

  • Clips are 5–15 seconds.

Also on SandBase

Other HeyGen Video endpoints: heygen/heygen-video/text-to-video, heygen/heygen-video/image-to-video.

Start building

Send your first request

OpenAI-compatible endpoint with unified authentication and usage tracking.

Production API
Unified Run API endpoint
https://api.sandbase.ai/v1/run
Model ID
heygen/heygen-video/reference-to-video
# The quoted heredoc keeps Unicode and shell metacharacters unchanged.
result=$(curl --fail-with-body --silent \
  -X POST "https://api.sandbase.ai/v1/run" \
  -H "Authorization: Bearer $SANDBASE_API_KEY" \
  -H "Content-Type: application/json" \
  --data-binary @- <<'SANDBASE_JSON'
{
  "model": "heygen/heygen-video/reference-to-video",
  "duration": 5,
  "resolution": "768p",
  "aspect_ratio": "adaptive"
}
SANDBASE_JSON
)
run_id=$(printf '%s' "$result" | jq -r .id)
for attempt in $(seq 1 120); do
  status=$(printf '%s' "$result" | jq -r .status)
  case "$status" in completed|failed|timeout) break ;; esac
  sleep 2
  result=$(curl --fail-with-body --silent \
    -H "Authorization: Bearer $SANDBASE_API_KEY" \
    "https://api.sandbase.ai/v1/run/$run_id")
done
status=$(printf '%s' "$result" | jq -r .status)
[ "$status" = completed ] || { echo "Generation ended: $status" >&2; exit 1; }
printf '%s\n' "$result"

Choose your model

Compare models

All image & video models
ModelTypeDefault priceReleased
HeyGenVideo$0.50 / runOct 21, 2026
HeyGenVideo$0.18 / runOct 21, 2026
HeyGenVideo$0.18 / runOct 21, 2026
HeyGenVideo$0.60 / runMay 20, 2026
HeyGenVideo$1.02 / runApr 16, 2026
HeyGenVideo$0.50 / runApr 16, 2026

Questions

FAQ

How do I call HeyGen Video Reference to Video through SandBase?

Create a SandBase API key, then send requests with the model ID "heygen/heygen-video/reference-to-video" to Unified Run API (/v1/run) at https://api.sandbase.ai. The request examples on this page show the exact payload.

Do I need a separate HeyGen account?

No. One SandBase API key and balance gives you access to HeyGen Video Reference to Video and the other models in the catalog; you do not need to sign up with HeyGen separately.