# slot.fill

> Fills a template slot with media, text or caption words.

Source: https://alexgalhardo.github.io/vukem-video/pt-br/docs/reference/commands/slot.fill

Give exactly one of asset_id (media slot), text (text slot) or words (caption slot). A media slot with duration policy fit keeps its duration and needs an asset long enough; with stretch_timeline it takes the rest of the asset and the later items of every track follow.

## Arguments

| Argument | Type | Required | Description |
| --- | --- | --- | --- |
| `asset_id` | `string` | no | For a media slot. |
| `name` | `string` | yes | The slot name. |
| `source_in` | `string` | no | With asset_id only. Default "0s". |
| `text` | `string` | no | For a text slot. |
| `words` | array of `object` | no | For a caption slot: words with times relative to the caption, as lengths. |

## Example

As one operation of an `edit` batch (the `edit` tool of MCP, `vukem-video edit --ops`, or `POST /api/v1/projects/{id}/edit`):

```json
{
  "op": "slot.fill",
  "args": {
    "asset_id": "ast_4h6j8k2m3n",
    "name": "hero",
    "source_in": "1s"
  }
}
```

## Errors

[`E_VALIDATION`](/docs/reference/error-codes#e_validation), [`E_INVALID_TIME`](/docs/reference/error-codes#e_invalid_time), [`E_NOT_FOUND`](/docs/reference/error-codes#e_not_found), [`E_TYPE_MISMATCH`](/docs/reference/error-codes#e_type_mismatch), [`E_SLOT`](/docs/reference/error-codes#e_slot), [`E_OUT_OF_SOURCE`](/docs/reference/error-codes#e_out_of_source), [`E_LIMIT`](/docs/reference/error-codes#e_limit), [`E_OVERLAP`](/docs/reference/error-codes#e_overlap), [`E_INVALID_STATE`](/docs/reference/error-codes#e_invalid_state)

## Scope and phase

Scope `edit`, phase `alpha`. Run `vukem-video command:help slot.fill` for the same description from the binary.
