HeyGen Video Text to Video
heygen/heygen-video/text-to-videoHeyGen Video Text to Video turns a text prompt into a 5-15 second video at up to 2K resolution.
- Base price
- $0.18USD / run
- Execution
- async
- Model type
- video
- Input fields
- 4
Try the model
Playground
Examples
Select an example to load its inputs and result into the playground.
Model card
Specifications
Pricing
- Base price
- $0.18 / 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/text-to-video
- Execution
- async
- Base URL
- https://api.sandbase.ai
- API
- Unified Run API
- Endpoint
- /v1/run
API README
HeyGen Video Text to Video
HeyGen Video turns a text prompt into a 5–15 second video at up to 2K resolution.
Fields
| Field | Type | Default | Notes |
|---|---|---|---|
prompt | string, required | — | Scene, action, camera and sound. |
aspect_ratio | 21:9 / 16:9 / 4:3 / 1:1 / 3:4 / 9:16 | 16:9 | Output frame shape. |
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.02 at 480p, $0.036 at 768p, $0.06 at 1080p and 2k.
| Output | Price |
|---|---|
| 5s, 768p (default) | $0.18 |
| 5s, 480p | $0.10 |
| 10s, 1080p | $0.60 |
| 15s, 2k | $0.90 |
| Failed runs are not charged. |
Prompting
- Describe subject, action, camera move and light in order.
Limits
- Clips are 5–15 seconds.
Also on SandBase
Other HeyGen Video endpoints: heygen/heygen-video/image-to-video, heygen/heygen-video/reference-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/text-to-video",
"duration": 5,
"resolution": "768p",
"aspect_ratio": "16:9"
}
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 Text to VideoThis model HeyGen | Video | $0.18 / run | Oct 21, 2026 |
HeyGen | Video | $0.18 / run | Oct 21, 2026 |
HeyGen | Video | $0.50 / 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 Text to Video through SandBase?
Create a SandBase API key, then send requests with the model ID "heygen/heygen-video/text-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 Text to Video and the other models in the catalog; you do not need to sign up with HeyGen separately.