HeyGen Video Agent V3

Name: HeyGen Video Agent V3
Price: 1.02 USD
Availability: InStock
Author: HeyGen

heygen/video-agent/v3

Heygen Video Agent V3 is HeyGen's text-to-video AI model. Turn written scripts and prompts into professional-quality video clips with realistic motion, lighting, and scene composition.

Use in agent Get API key

Base price: $1.02USD / run
Execution: async
Model type: video
Input fields: 1

Production route

Try the model

Playground

Open playground

Input

Prompt(string)

Natural language prompt describing the video to generate. The agent handles avatar selection, script, and production automatically.

OutputReady

Your output will appear here

Complete the inputs, then click Run.

Model card

Specifications

Pricing

Base price: $1.02 / 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/video-agent/v3
Execution: async
API: Unified Run API
Endpoint: /v1/run

API README

HeyGen Video Agent V3

heygen/video-agent/v3 builds a complete presenter-led video from a high-level creative brief, coordinating planning, script, visuals, narration, and assembly. Video Agent V3 improves autonomous storytelling and scene construction, turning an objective into a more coherent finished video with less manual orchestration. This combination makes the model a practical choice when the creative outcome depends on those qualities rather than on a generic media conversion.

For production work with heygen/video-agent/v3, it is useful for explainers, marketing concepts, educational content, and rapid video production when the desired outcome can be described at the campaign or story level. The result is most reliable when the source material and creative brief clearly describe the intended subject, progression, visual or sonic character, and the qualities that must remain unchanged.

Highlights

Autonomous video planning turns a high-level objective into a structured sequence.

Integrated script development creates narration and scene progression around the brief.

Coherent visual assembly coordinates presenter, supporting imagery, pacing, and transitions.

End-to-end generation reduces manual handoffs from concept through completed video.

Pricing

Billing	Price
Per second of output video (rounded up)	$0.034
Default (30s)	$1.02

When to Use

✅ Good fit	❌ Consider alternatives
The model's named workflow matches the source material and intended output	A different input modality or model route is required
A managed asynchronous result is suitable for the production pipeline	A synchronous, interactive editor is essential
The documented controls cover the required duration, framing, or format	The project needs controls outside this endpoint's schema
Creative iteration benefits from a repeatable request structure	Exact deterministic pixels, frames, geometry, or samples are mandatory
A finished downloadable media asset is the desired deliverable	Editable source layers or a native project file are required

Prompt Guide

For generation, state the intended result first, then add the subject or source treatment, progression, style, and delivery constraints. Keep one creative variable per phrase, use the documented field names for controls, and change one setting at a time when comparing results.

{
  "prompt": "Create a 30-second product demo video showcasing our new AI features with professional lighting and modern graphics."
}

Technical Specs

Spec	Value
Model ID	`heygen/video-agent/v3`
Inputs	prompt
Required inputs	prompt
Output fields	content_type, url
Execution	Async (submit, then poll for result)

Related Models

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/video-agent/v3

# 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/video-agent/v3",
  "prompt": "Create a 30-second product demo video showcasing our new AI features with professional lighting and modern graphics."
}
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

Model	Type	Default price	Released
HeyGen Video Agent V3This model `HeyGen`	Video	$1.02 / run	Apr 16, 2026
HeyGen Avatar 5 Digital Twin `HeyGen`	Video	$0.50 / run	May 20, 2026
HeyGen Avatar 4 Image to Video `HeyGen`	Video	$0.50 / run	Feb 23, 2026

Questions

FAQ

How do I call HeyGen Video Agent V3 through SandBase?

Create a SandBase API key, then send requests with the model ID "heygen/video-agent/v3" 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 Agent V3 and the other models in the catalog; you do not need to sign up with HeyGen separately.