trim_audio

Trim audio

Save one stretch of an owned voice-over, song or audio upload as a new WAV audio generation, cut to the sample. Specify the start time and duration in seconds. To cut a whole take into a talking head's lines, pass each window of chunks from transcribe_media with chunk_max_seconds. Costs no credits; uses account storage. get_generation waits for the result.

Scope

generation.write — Makes, edits, imports, shares and deletes media in the account.

Behaviour

Writes: Creates or changes items in the caller's own account.
Adds or updates: Adds or updates; nothing the caller already has is deleted or overwritten.
Stays in the account: Stays inside the caller's private Kuro account: any media provider it calls acts on Kuro's account, and the result is visible to no one else.

Credits

What the tool's description says about credits, verbatim.

Costs no credits; uses account storage. get_generation waits for the result.

Inputs

sourceobject (type: "upload") or object (type: "generation") · required
start_secondsnumber · required
≥ 0 · ≤ 600
duration_secondsnumber · required
> 0 · ≤ 600
accurateboolean · optional

Example call

A tools/call request with the required arguments only, each a placeholder read off the schema. Replace them before sending.

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "trim_audio",
    "arguments": {
      "source": {
        "type": "upload",
        "upload_id": "00000000-0000-4000-8000-000000000000"
      },
      "start_seconds": 0,
      "duration_seconds": 1
    }
  }
}

Input schema

As the server sends it in tools/list.

{
  "type": "object",
  "properties": {
    "source": {
      "anyOf": [
        {
          "type": "object",
          "properties": {
            "type": {
              "type": "string",
              "const": "upload"
            },
            "upload_id": {
              "type": "string",
              "format": "uuid"
            }
          },
          "required": [
            "type",
            "upload_id"
          ],
          "additionalProperties": false
        },
        {
          "type": "object",
          "properties": {
            "type": {
              "type": "string",
              "const": "generation"
            },
            "generation_id": {
              "type": "string",
              "format": "uuid"
            }
          },
          "required": [
            "type",
            "generation_id"
          ],
          "additionalProperties": false
        }
      ]
    },
    "accurate": {
      "type": "boolean"
    },
    "start_seconds": {
      "type": "number",
      "minimum": 0,
      "maximum": 600
    },
    "duration_seconds": {
      "type": "number",
      "exclusiveMinimum": 0,
      "maximum": 600
    }
  },
  "required": [
    "source",
    "start_seconds",
    "duration_seconds"
  ],
  "additionalProperties": false
}

Related tools

transcribe_media
Get the spoken words out of any audio or video in the user's account, timed and attributed to speakers.
get_generation
Get current status and signed media URL for one generation.
trim_video
Save one stretch of an owned video as a new clip, using a keyframe copy by default.

Every tool· This page as Markdown