Auto Caption

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

execute_forge({
  "base_model_id": "auto-caption",
  "prompt": "A torch-lit dungeon corridor, slow dolly forward",
  "batch_size": 1
})

# Start the generation — returns an inference id straight away.
curl -X POST https://api.app.layer.ai/api/v2/workspaces/$WORKSPACE_ID/base-models/auto-caption/inferences \
  -H "Authorization: Bearer $LAYER_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
        "guidance_file_init_video": [
          {
            "url": "https://example.com/input.png"
          }
        ]
      }'

# 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"

subtitle_font_file_id

string

The typeface of the captions.

subtitle_color

string

The colour of the caption text.

subtitle_font_size

integerdefault 3312–96

The size of the caption text.

subtitle_alignment

objectdefault [object Object]

Where the captions sit in the frame.

guidance_file_init_video

file[]

The video to modify