HeyGen Video Reference to Video
heygen/heygen-video/reference-to-videoHeyGen 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
Try the model
Playground
PNG, JPEG, WebP, or GIF · 20 MiB maximum each · up to 9
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
| Field | Type | Default | Notes |
|---|---|---|---|
prompt | string, required | — | Scene and action; describe how each reference is used. |
images | image URL[] | — | Up to 9 reference images (characters, products, scenes). |
videos | video URL[] | — | Up to 3 reference videos for motion or style. |
audios | audio URL[] | — | Up to 3 reference audio clips (voice or music). |
aspect_ratio | adaptive / 21:9 / 16:9 / 4:3 / 1:1 / 3:4 / 9:16 | adaptive | adaptive follows the references. |
resolution | 480p / 768p / 1080p / 2k | 768p | Output resolution; 1080p and 2k cost more. |
duration | 5–15 | 5 | Output 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.
| Output | Price |
|---|---|
| 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.
# 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
| Model | Type | Default price | Released |
|---|---|---|---|
HeyGen Video Reference to VideoThis model HeyGen | Video | $0.50 / run | Oct 21, 2026 |
HeyGen | Video | $0.18 / run | Oct 21, 2026 |
HeyGen | Video | $0.18 / run | Oct 21, 2026 |
HeyGen | Video | $0.60 / run | May 20, 2026 |
HeyGen | Video | $1.02 / run | Apr 16, 2026 |
HeyGen | Video | $0.50 / run | Apr 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.
