Videofrom$0.0250 / s

HeyGen Video 1

Generates video from text, an image, references · 480p to 2K · 5–15 s · native audio

text-to-videoimage-to-videoreference-to-video

curl -X POST https://api.open.sume.com/v1/video-router/generate \
  -H "Authorization: Bearer $SUME_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"heygen-video-1","prompt":"A cinematic tracking shot along a sunlit coastal road","duration":5,"resolution":"480p","aspect_ratio":"16:9","generate_audio":false}'

1. Calling the API

HeyGen Video 1 has the model id heygen-video-1. Send a JSON body to POST https://api.open.sume.com/v1/video-router/generate.

Parameter	Type	Required	Default	Description
model	string	Yes	—	"heygen-video-1"
prompt	string	Yes	—	What happens in the video.
image_url	string	No	—	First frame (HTTPS image).
reference_image_urls	string[]	No	—	Reference images (HTTPS).
duration	integer	No	5	Seconds, 5–15.
resolution	string	No	480p	Output resolution. Options: 480p, 768p, 2K.
aspect_ratio	string	No	16:9	Frame shape. Options: 16:9, 9:16, 1:1, 4:3, 3:4, 21:9.
generate_audio	boolean	No	false	Generate a soundtrack with the video.

2. Authentication

Send your open.sume.com key as a bearer token from server code only. Keys minted on open.sume.com bill this balance in dollars and call the model API only.

Authorization: Bearer $SUME_API_KEY

3. Queue

A submit answers 202 with the job, its status_url and result_url. Poll the status until it is completed, failed or canceled; failed and canceled jobs are refunded.

GET https://api.open.sume.com/v1/jobs/<job_id>/status
GET https://api.open.sume.com/v1/jobs/<job_id>/result
POST https://api.open.sume.com/v1/jobs/<job_id>/cancel

4. Price before you submit

The estimate is the charge: the same function prices both.

curl -X POST https://api.open.sume.com/v1/open/estimate \
  -H "Content-Type: application/json" \
  -d '{"model":"heygen-video-1","input":{"prompt":"…"}}'

Full reference: open.sume.com/docs

Pricing

Dollars per unit at each option, from our rate card; a request rounds up to $0.0001. The estimate above is the exact charge.

Option	Price
480p	$0.0250 / s
768p	$0.0375 / s
2K	$0.1125 / s

curl -X POST https://api.open.sume.com/v1/video-router/generate \ -H "Authorization: Bearer $SUME_API_KEY" \ -H "Content-Type: application/json" \ -d '{"model":"heygen-video-1","prompt":"A cinematic tracking shot along a sunlit coastal road","duration":5,"resolution":"480p","aspect_ratio":"16:9","generate_audio":false}'

Parameter

Type

Required

Default

Description

model

string

Yes

—

"heygen-video-1"

prompt

string

Yes

—

What happens in the video.

image_url

string

—

First frame (HTTPS image).

reference_image_urls

string[]

—

Reference images (HTTPS).

duration

integer

Seconds, 5–15.

resolution

string

480p

Output resolution. Options: 480p, 768p, 2K.

aspect_ratio

string

16:9

Frame shape. Options: 16:9, 9:16, 1:1, 4:3, 3:4, 21:9.

generate_audio

boolean

false

Generate a soundtrack with the video.

Option

Price

480p

$0.0250 / s

768p

$0.0375 / s

$0.1125 / s