Generates video from text, an image, references · 480p to 2K · 5–15 s · native audio
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}'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. |
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
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 |
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
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