# item.set_audio

> Sets the volume, the fades or the mute flag of a clip or audio item.

Source: https://alexgalhardo.github.io/vukem-video/docs/reference/commands/item.set_audio/

Sets the given values. Volume 1, fades of 0 and audio_muted false clear the stored value. audio_muted applies to clip items only. The two fades together cannot be longer than the item.

## Arguments

| Argument | Type | Required | Description |
| --- | --- | --- | --- |
| `audio_muted` | `boolean` | no | Drop the audio of a clip. |
| `fade_in` | `string` | no | Fade-in length; 0s removes it. |
| `fade_out` | `string` | no | Fade-out length; 0s removes it. |
| `item_id` | `string` | yes | A clip or audio item. |
| `volume` | `number` | no | Linear gain, 0 to 4. min 0; max 4 |

## 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": "item.set_audio",
  "args": {
    "fade_in": "1s",
    "fade_out": "0.5s",
    "item_id": "itm_m1n2p3q4r5",
    "volume": 0.8
  }
}
```

## 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_INVALID_STATE`](/docs/reference/error-codes#e_invalid_state)

## Scope and phase

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