HeyGen Video 1.0 Reference

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

execute_forge({
  "base_model_id": "heygen-video-reference",
  "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-reference/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_480p29 options

The shape and size of the output. Auto follows the shape of the input.

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

guidance_file_reference_image

file[]

Guides style and content without being modified

guidance_file_reference_video

file[]

Guides style and motion without being modified

guidance_file_reference_audio

file[]

Guides style and voice without being modified

prompt_language

string

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