One-shot vs persistent cloning: pick the right approach

from fishaudio import FishAudio
from fishaudio.types import ReferenceAudio
from fishaudio.utils import save

client = FishAudio()

with open("reference.wav", "rb") as f:
    audio = client.tts.convert(
        text="This line is spoken in the cloned voice, no model required.",
        references=[ReferenceAudio(
            audio=f.read(),
            text="Exact transcript of what is said in reference.wav.",
        )],
        model="s2.1-pro-free",
    )

save(audio, "oneshot.mp3")

import asyncio
from fishaudio import AsyncFishAudio
from fishaudio.types import ReferenceAudio
from fishaudio.utils import save

async def main():
    async with AsyncFishAudio() as client:
        with open("reference.wav", "rb") as f:
            audio = await client.tts.convert(
                text="This line is spoken in the cloned voice, no model required.",
                references=[ReferenceAudio(
                    audio=f.read(),
                    text="Exact transcript of what is said in reference.wav.",
                )],
                model="s2.1-pro-free",
            )
    save(audio, "oneshot.mp3")

asyncio.run(main())

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

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

// One-shot: clone inline by sending the reference bytes + exact transcript.
// Nothing is stored server-side; the clone lives only for this request.
const reference = await readFile("reference.wav");

const stream = await client.textToSpeech.convert(
  {
    text: "This line is spoken in the cloned voice, no model required.",
    references: [
      {
        audio: new File([reference], "reference.wav"),
        text: "Exact transcript of what is said in reference.wav.",
      },
    ],
    format: "mp3",
  },
  "s2.1-pro-free"
);

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