Tools

export_clip

Render one clip as an MP4 up to your plan's export quality (1080p Hobby, 1440p Creator, 4K Arena) with its captions and look. Returns its status; call again with the same ids every ~10 s until completed to get the download link (it never starts a second render). Free: Clips minutes pay for the video, not exports.

Access token · edit · Changes account data

Parameters

job_id string required

The Clips job id (from clip_video or list_clip_jobs).

View schema

{
  "description": "The Clips job id (from clip_video or list_clip_jobs).",
  "type": "string",
  "format": "uuid",
  "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000)$"
}

clip_id string required

A clip's id, from list_clips.

View schema

{
  "description": "A clip's id, from list_clips.",
  "type": "string",
  "minLength": 1,
  "maxLength": 150
}

Request example

{
  "name": "export_clip",
  "arguments": {
    "job_id": "00000000-0000-4000-8000-000000000001",
    "clip_id": "YOUR_CLIP_ID"
  }
}

Replace example values with ids and arguments read from your own Heavenly account. This example does not execute a tool.

Returns

The tool result from Heavenly’s workspace, encoded as MCP text content. The connector returns isError when an argument, permission, plan or account check fails.

Account access and permissions are checked by Heavenly. See errors for failure handling.