Tools

create_variant_batch

Open a batch of different hooks over footage the user owns. Call it first with confirm omitted: the result is the AI-credit estimate (the cent figure is a hypothesis, not a measured price) and nothing is held. Set confirm to true only after the user accepts it. Nothing is rendered.

Access token · edit · Changes account data

Parameters

brief string required

View schema

{
  "type": "string",
  "minLength": 3,
  "maxLength": 2000
}

product_name string required

View schema

{
  "type": "string",
  "minLength": 1,
  "maxLength": 120
}

claims_allowed array optional

View schema

{
  "maxItems": 8,
  "type": "array",
  "items": {
    "type": "string",
    "minLength": 1,
    "maxLength": 200
  }
}

claims_forbidden array optional

View schema

{
  "maxItems": 20,
  "type": "array",
  "items": {
    "type": "string",
    "minLength": 1,
    "maxLength": 200
  }
}

cta string optional

View schema

{
  "type": "string",
  "maxLength": 120
}

length_seconds number required

View schema

{
  "type": "number",
  "minimum": 8,
  "maximum": 90
}

count integer required

View schema

{
  "type": "integer",
  "minimum": 1,
  "maximum": 10
}

collection string optional

View schema

{
  "type": "string",
  "minLength": 1,
  "maxLength": 80
}

budget_cents integer required

View schema

{
  "type": "integer",
  "minimum": 0,
  "maximum": 100000
}

confirm boolean optional

True only after the user accepts the credit estimate.

View schema

{
  "description": "True only after the user accepts the credit estimate.",
  "type": "boolean"
}

Request example

{
  "name": "create_variant_batch",
  "arguments": {
    "brief": "YOUR_BRIEF",
    "product_name": "YOUR_PRODUCT_NAME",
    "length_seconds": 8,
    "count": 1,
    "budget_cents": 0
  }
}

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.