cast_voice

Cast a voice from a face

Read a portrait already in the account and return the voices that suit it, best first. Returns ids to pass to generate_voiceover; spends no credits and makes no audio.

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.

Returns ids to pass to generate_voiceover; spends no credits and makes no audio.

Inputs

modelstring · required
one of "elevenlabs-tts", "eleven-v4", "gemini-3.1-flash-tts", "kokoro-82m", "minimax-speech-2.8-hd", "inworld-tts-2"
generation_idstring · optional
uuid
upload_idstring · optional
uuid

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": "cast_voice",
    "arguments": {
      "model": "elevenlabs-tts"
    }
  }
}

Input schema

As the server sends it in tools/list.

{
  "type": "object",
  "properties": {
    "model": {
      "type": "string",
      "enum": [
        "elevenlabs-tts",
        "eleven-v4",
        "gemini-3.1-flash-tts",
        "kokoro-82m",
        "minimax-speech-2.8-hd",
        "inworld-tts-2"
      ]
    },
    "generation_id": {
      "type": "string",
      "format": "uuid"
    },
    "upload_id": {
      "type": "string",
      "format": "uuid"
    }
  },
  "required": [
    "model"
  ],
  "additionalProperties": false
}

Related tools

generate_voiceover
Start a voice-over generation from text.

Every tool· This page as Markdown