list_gemini_omni_characters
Scope: generate:media. List the user's saved Gemini Omni characters (newest first). Each character is a bundle of (reference image, description, optional voice_id) backed by an opaque provider character_id that the model uses to render the same identity across multiple clips. USE WHEN: the user references a saved character ('use my Maya 'character', 'render the brand mascot') — pull the matching character_id from this list and pass it in character_ids when calling generate_media with a gemini-omni-video-* / gemini-omni-flash-* model. ALSO check this PROACTIVELY whenever the user wants the SAME person + voice across multiple video clips (a series, a recurring spokesperson, a marketing ad set): if no fitting character exists yet, offer to create one first via manage_library(kind='character', action='create', ...) so the identity is locked across the whole campaign. RETURNS: characters (each row has id [internal UUID], character_id [the value to pass to generate_media], character_name, image_url, description, voice_id, created_at). Each character_id consumes 1 of the 7 reference slots in generate_media.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "list_gemini_omni_characters"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||