Discover and reuse a Voice Library voice

from fishaudio import FishAudio
from fishaudio.utils import save

client = FishAudio()  # reads FISH_API_KEY

# Search the public library by title (not just your own voices)
page = client.voices.list(title="narration", self_only=False, page_size=10)
print(f"{page.total} public voices match")

# Pick the first result; fall back to a known id if the search is empty
reference_id = "<voice-id>"
for voice in page.items:
    print(voice.id, voice.title, voice.languages)
    reference_id = reference_id if reference_id != "<voice-id>" else voice.id

# Synthesize with the discovered voice as the reference
audio = client.tts.convert(
    text="Speaking with a voice I found in the public library.",
    reference_id=reference_id,
    model="s2.1-pro-free",
)
save(audio, "out.mp3")

import { FishAudioClient } from "fish-audio";
import { writeFile } from "fs/promises";

const client = new FishAudioClient({ apiKey: process.env.FISH_API_KEY });

// Search the public Voice Library by title (not just your own voices)
const page = await client.voices.search({ title: "narration", page_size: 10 });
console.log(`${page.total} public voices match`);

// Pick the first result; fall back to a known id if the search is empty
let referenceId = "<voice-id>";
for (const voice of page.items) {
  console.log(voice._id, voice.title, voice.languages);
  referenceId = referenceId !== "<voice-id>" ? referenceId : voice._id;
}

// Synthesize with the discovered voice as the reference
const stream = await client.textToSpeech.convert(
  {
    text: "Speaking with a voice I found in the public library.",
    reference_id: referenceId,
    format: "mp3",
  },
  "s2.1-pro-free"
);

const chunks = [];
for await (const chunk of stream) chunks.push(Buffer.from(chunk));
await writeFile("out.mp3", Buffer.concat(chunks));