vocea_get_audio
Obtain the CDN URL and metadata of a previously generated audio using its unique identifier.
Instructions
Get details (including CDN URL) for a previously generated audio.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| audio_id | Yes |
Implementation Reference
- src/index.ts:168-174 (handler)Handler for 'vocea_get_audio' tool. Calls vocea.audios.get(audio_id) and returns the audio details including CDN URL.
case "vocea_get_audio": { const a = args as { audio_id: string }; const audio = await vocea.audios.get(a.audio_id); return { content: [{ type: "text", text: JSON.stringify(audio) }], }; } - src/index.ts:90-97 (schema)Schema definition for 'vocea_get_audio' tool. Defines input as an object with required 'audio_id' (string) property.
{ name: "vocea_get_audio", description: "Get details (including CDN URL) for a previously generated audio.", inputSchema: { type: "object", properties: { audio_id: { type: "string" } }, required: ["audio_id"], }, - src/index.ts:28-100 (registration)Tool registration within ListToolsRequestSchema handler. The 'vocea_get_audio' tool is registered as part of the tools array (line 91).
server.setRequestHandler(ListToolsRequestSchema, async () => ({ tools: [ { name: "vocea_generate_audio", description: "Convert text to speech using a Vocea voice. Returns an audio URL.", inputSchema: { type: "object", properties: { voice_id: { type: "string", description: "Voice UUID to use for synthesis" }, text: { type: "string", description: "Text to convert to speech (max 10000 chars)" }, language_code: { type: "string", description: "Language code, e.g. 'en', 'es', 'fr'" }, emotion: { type: "string", enum: ["neutral", "happy", "sad", "angry", "fearful", "surprised", "disgusted", "whisper"], description: "Emotional tone (default: neutral)", }, speaking_rate: { type: "number", description: "Speaking rate multiplier 0.5–1.5 (default 1.0)" }, }, required: ["voice_id", "text", "language_code"], }, }, { name: "vocea_list_voices", description: "List the authenticated user's cloned voices.", inputSchema: { type: "object", properties: { page: { type: "number", description: "Page number (default 1)" }, limit: { type: "number", description: "Results per page (default 20)" }, }, }, }, { name: "vocea_list_public_voices", description: "List public community voices available for use.", inputSchema: { type: "object", properties: { page: { type: "number" }, limit: { type: "number" }, ageRange: { type: "string", enum: ["young", "adult", "senior"] }, }, }, }, { name: "vocea_transcribe", description: "Transcribe audio from a base64-encoded string to text (STT).", inputSchema: { type: "object", properties: { audio_base64: { type: "string", description: "Base64-encoded audio file (mp3, wav, ogg, webm, flac, max 10MB)" }, mime_type: { type: "string", description: "MIME type, e.g. audio/mpeg", default: "audio/mpeg" }, language: { type: "string", description: "BCP-47 language code, e.g. en-US (default: es-ES)" }, }, required: ["audio_base64"], }, }, { name: "vocea_get_credits", description: "Get the current credit balance for the authenticated user.", inputSchema: { type: "object", properties: {} }, }, { name: "vocea_get_audio", description: "Get details (including CDN URL) for a previously generated audio.", inputSchema: { type: "object", properties: { audio_id: { type: "string" } }, required: ["audio_id"], }, }, ], }));