HeyGen Video 1.0

https://mcp.app.layer.ai/mcp

execute_forge({
  "base_model_id": "heygen-video",
  "prompt": "A torch-lit dungeon corridor, slow dolly forward",
  "batch_size": 1,
  "duration_seconds": 5
})

# Start the generation — returns an inference id straight away.
curl -X POST https://api.app.layer.ai/api/v2/workspaces/$WORKSPACE_ID/base-models/heygen-video/inferences \
  -H "Authorization: Bearer $LAYER_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
        "prompt": "A torch-lit dungeon corridor, slow dolly forward"
      }'

# Poll until status is "complete" — the response then carries the asset URLs.
curl https://api.app.layer.ai/api/v2/workspaces/$WORKSPACE_ID/inferences/$INFERENCE_ID \
  -H "Authorization: Bearer $LAYER_TOKEN"

prompt

stringrequired

Describe what to generate, or the change to make.

color_palette

any

Colors the output should use. This model doesn't take a palette natively, so the colors are added to the prompt.

aspect_ratio

enumdefault LANDSCAPE_16_9_480p24 options

The shape and size of the output.

prompt_enhancement

enumdefault AUTO5 options

Let the model rewrite the prompt before generating.

seed

integer

The starting point for the model's randomness. The same seed and settings give the same result.

duration_seconds

integerdefault 5

Length of the generated clip, in seconds.

guidance_file_first_frame

file[]

The frame the video starts on

prompt_language

string

The language the prompt is written in, so it reaches the model as you meant it.