How much does HeyGen Image to Video cost on varg?

HeyGen Image to Video costs $0.05/s on varg, on its cheapest route. The total depends on the request. varg charges the provider's price with no markup, from one credit balance. For the exact price of a request before you run it, send the same body to POST https://api.varg.ai/v2/estimate.

How do I call the HeyGen Image to Video API?

Send POST https://api.varg.ai/v2/tools/video/call with the header "Authorization: Bearer $VARG_API_KEY" and a JSON body that includes "model": "heygen_image_video". The call answers 202 with a job right away. Poll GET https://api.varg.ai/v2/jobs/{id} until "status" is "completed", then read output.outputs[0].url, or pass options.webhook_url to be called back.

Can I use HeyGen Image to Video from Claude, ChatGPT or Cursor?

Yes. Add the varg MCP server (https://mcp.varg.ai/mcp) to Claude, ChatGPT, Cursor or any other MCP client and sign in with varg, with no API key to paste. The agent runs HeyGen Image to Video with call_tool, passing tool "video" and "model": "heygen_image_video".

How long does a HeyGen Image to Video request take?

Typically about 3 min on the fastest route, by the catalog's estimate. The API answers at once with a job id, so nothing waits on an open connection while it runs.

Video · Avatar

HeyGen Image to Video API

HeyGen avatar video made from an image, billed per second.

Price: $0.05/s
Typical time: ~3 min
Model id: heygen_image_video

HeyGen Image to Video runs on one varg API key and one credit balance, the same as every other model here. You pay the provider's price, with no markup.

POST /v2/tools/video/call

curl -X POST https://api.varg.ai/v2/tools/video/call \
  -H "Authorization: Bearer $VARG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "heygen_image_video"
}'

Try it in the Playground Get an API key

HeyGen Image to Video pricing

$0.05/s. Prices are in US dollars and are the provider's own, with no markup. For the exact price of a request, send the same body to POST https://api.varg.ai/v2/estimate.

heygen $0.05/s
heygen:heygen_avatar
Avatar
Per second
$0.05/s
Most one request can cost
$10.00
Typical time
~3 min

HeyGen Image to Video inputs

The JSON body of the request. Media inputs are URLs: upload a local file with POST /v2/files and pass the URL it returns. Full JSON Schema, no key needed: api.varg.ai/v2/tools/video?model=heygen_image_video

HeyGen Image to Video request fields
Field	What it does
`model` string required	`heygen_image_video` picks a route automatically.
`prompt` string	—
`files` array of { url }	—
`aspect_ratio` string	Allowed e.g. 16:9 \| 9:16 \| 1:1 \| 4:3 \| 3:4 \| 21:9 \| auto
`resolution` string	Quality tier. Not supported by this model — ignored if sent. Allowed 480p \| 720p \| 1080p \| 4k
`audio` boolean	Native audio track request. Not supported by this model — ignored if sent.
`duration` integer	Length in seconds. Not mapped by this model — ignored if sent. Allowed 1–120

Provider options

Optional, under provider_options.<provider>. Only the options of the provider that runs the job apply; pin a route to choose it.

`provider_options.heygen`

HeyGen Image to Video options for heygen
Field	What it does
`script` string	—
`type` string	Allowed avatar \| image
`image.url` string	—
`image.type` string	Allowed url \| asset_id
`image.asset_id` string	—
`voice_id` string	—
`audio_url` string (URL)	—
`avatar_id` string	—
`resolution` string	—
`callback_id` string	—
`aspect_ratio` string	Allowed e.g. 16:9 \| 9:16 \| 1:1 \| 4:3 \| 3:4 \| 21:9 \| auto
`callback_url` string	—
`motion_prompt` string	—
`expressiveness` string	Allowed low \| medium \| high

Call the HeyGen Image to Video API

POST https://api.varg.ai/v2/tools/video/call with Authorization: Bearer $VARG_API_KEY. It answers 202 with a job right away.

1. Send the request

cURL

curl -X POST https://api.varg.ai/v2/tools/video/call \
  -H "Authorization: Bearer $VARG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "heygen_image_video"
}'

JavaScript

const headers = {
  Authorization: `Bearer ${process.env.VARG_API_KEY}`,
  'Content-Type': 'application/json',
}

const res = await fetch('https://api.varg.ai/v2/tools/video/call', {
  method: 'POST',
  headers,
  body: JSON.stringify({
    "model": "heygen_image_video"
  }),
})
const job = await res.json() // { id: "job_…", status: "queued" }

Python

import os
import requests

headers = {"Authorization": f"Bearer {os.environ['VARG_API_KEY']}"}

job = requests.post(
    "https://api.varg.ai/v2/tools/video/call",
    headers=headers,
    json={
      "model": "heygen_image_video"
    },
).json()  # {"id": "job_…", "status": "queued"}

2. Get the result

Poll the job until its status is completed, failed or cancelled; HeyGen Image to Video typically takes about 3 min. The result is at output.outputs[0].url.

GET /v2/jobs/{id}

curl https://api.varg.ai/v2/jobs/$JOB_ID \
  -H "Authorization: Bearer $VARG_API_KEY"

# Poll until "status" is completed, failed or cancelled.
# The result is in output.outputs[0].url

JavaScript

let current = job
while (!['completed', 'failed', 'cancelled'].includes(current.status)) {
  await new Promise((resolve) => setTimeout(resolve, 3000))
  current = await (await fetch(`https://api.varg.ai/v2/jobs/${current.id}`, { headers })).json()
}
console.log(current.output?.outputs?.[0]?.url)

Python

import time

while job["status"] not in ("completed", "failed", "cancelled"):
    time.sleep(3)
    job = requests.get(f"https://api.varg.ai/v2/jobs/{job['id']}", headers=headers).json()

print(job["output"]["outputs"][0]["url"])

Or take a webhook instead of polling

Add options.webhook_url and varg POSTs the finished job to it.

request body

{
  "model": "heygen_image_video",
  "options": {
    "webhook_url": "https://your-app.com/varg-webhook"
  }
}

From Claude, ChatGPT or Cursor (MCP)

The varg MCP server, https://mcp.varg.ai/mcp, runs HeyGen Image to Video with call_tool. Sign in with varg, no API key to paste. How to connect it

call_tool

{
  "tool": "video",
  "input": {
    "model": "heygen_image_video"
  },
  "wait": true
}