Fish Audio: Fish Audio Drama 3 (Preview)

Name: Fish Audio Drama 3 (Preview)
Author: Fish Audio

fish/drama-3-preview

active tts 1 provider

Playground

Fish Audio's Drama 3 text-to-speech model (preview): a new TTS model exposed on the same /v1/tts, streaming and WebSocket endpoints as the S2 family, with single-speaker synthesis and multi-speaker dialogue via <|speaker:N|> tags. Preview status: Fish states its behavior and availability may change.

AuthorFish Audio

Languagesnot specified

VoicesLoading...

Response formatsMP3 · WAV · PCM · Opus

Statusactive

Quick start

Fish Audio Drama 3 (Preview)

Create an API key

Create API key

Make a request

Pick an SDK, request mode, and language. The model and provider route are already filled in.

ElevenLabs SDK streaming TTS

Routes the ElevenLabs SDK through allmodels and streams the audio response.

import { ElevenLabsClient } from "elevenlabs";

const client = new ElevenLabsClient({
  apiKey: process.env.ALLMODELS_API_KEY,
  baseUrl: "https://api.allmodels.io/el"
});

const stream = await client.textToSpeech.stream("voice_id", {
  text: "I'm sorry, Dave. I'm afraid I can't do that.",
  modelId: "fish/drama-3-preview",
  outputFormat: "mp3_44100_128"
}, {
  queryParams: {
    provider: {
      "only": [
        "fish"
      ]
    }
  }
});

const reader = stream.getReader();
for (;;) {
  const { done, value } = await reader.read();
  if (done) break;
  // Write value to your response, file, or audio playback pipeline.
}

Pass provider parameters

Pass provider preferences through the compatible SDK request options when you want to pin a route to a provider.

{
  queryParams: {
    provider: {
      only: ["fish"]
    }
  }
}

Providers

Different providers can host the same model. Choose one provider when you need a fixed backend, or let routing select among them.

ProviderSlugPer 1k charactersLatencyiModesUptime

Fish Audio 19 params

fish

$0.015

—

Synchronous · Streaming

Fish Audio

19 documented provider parameters for this route.

Pricing

ModeLanguagePer 1k characters

Text To Speech (Paid) Any $0.015 ($15.00 usd Per 1m Utf8 Bytes)

Parameters

model header · string · required

Specify which TTS model to use. We recommend `s2-pro`.

default "s2-pro"2 enum values

Values

s1s2-pro

text body · string · required

Text to convert to speech.

chunk_length body · integer · optional

Text segment size for processing.

default 300min 100max 300

condition_on_previous_chunks body · boolean · optional

Use previous audio as context for voice consistency.

default true

early_stop_threshold body · number · optional

Early stopping threshold for batch processing.

default 1min 0max 1

format body · string · optional

Output audio format.

default "mp3"4 enum values

Values

wavpcmmp3opus

latency body · string · optional

Latency-quality trade-off. normal: best quality, balanced: reduced latency, low: lowest latency.

default "normal"3 enum values

Values

lownormalbalanced

max_new_tokens body · integer · optional

Maximum audio tokens to generate per text chunk.

default 1024

min_chunk_length body · integer · optional

Minimum characters before splitting into a new chunk.

default 50min 0max 100

mp3_bitrate body · integer · optional

MP3 bitrate in kbps. Only applies when format is mp3.

default 1283 enum values

Values

64128192

normalize body · boolean · optional

Normalizes text for English and Chinese, improving stability for numbers.

default true

opus_bitrate body · integer · optional

Opus bitrate in bps. -1000 for automatic. Only applies when format is opus.

default -10005 enum values

Values

-100024000320004800064000

prosody body · object | null · optional

Speed and volume adjustments for the output.

default null

reference_id body · string | array | null · optional

Voice model ID(s) from Fish Audio library or your custom models. For single-speaker synthesis, provide a string. For multi-speaker synthesis (dialogue), provide an array of model IDs. **Multi-speaker is only available with the S2-Pro model.** When using multiple speakers, use speaker tags in your text like `<|speaker:0|>` and `<|speaker:1|>` to indicate speaker changes. Example: `<|speaker:0|>Hello!<|speaker:1|>Hi there!<|speaker:0|>How are you?` with `reference_id: ["speaker-a-id", "speaker-b-id"]`.

default null

references body · array | array | null · optional

Inline voice references for zero-shot cloning. Requires MessagePack (not JSON). For single speaker, provide an array of ReferenceAudio objects. For multiple speakers, provide an array of arrays where each inner array contains references for one speaker. **Multi-speaker is only available with the S2-Pro model.** The speaker index corresponds to the index in reference_id array. Example for multi-speaker: [[{audio, text}], [{audio, text}, {audio, text}]] for 2 speakers where speaker 1 has 2 reference samples.

repetition_penalty body · number · optional

Penalty for repeating audio patterns. Values above 1.0 reduce repetition.

default 1.2

sample_rate body · integer | null · optional

Audio sample rate in Hz. When null, uses the format's default (44100 Hz for most formats, 48000 Hz for opus).

default null

temperature body · number · optional

Controls expressiveness. Higher is more varied, lower is more consistent.

default 0.7min 0max 1

top_p body · number · optional

Controls diversity via nucleus sampling.

default 0.7min 0max 1

Supported languages

No reviewed language list for this model yet.

Voices

Features

Text to speech

Generates spoken audio from text input.

text_to_speech

Streaming

Listed in the model enum of the streaming HTTP (/v1/tts/stream/with-timestamp) and WebSocket (/v1/tts/live/with-timestamp) endpoints in the OpenAPI document; the AsyncAPI document for /v1/tts/live still omits it (doc inconsistency, unprobed).

streaming

Synchronous

Synthesizes speech from fully-submitted text in a single POST /v1/tts request.

synchronous

Voice cloning

Accepts reference_id (persistent voice models) and references (zero-shot reference audio) like every Fish TTS model; the endpoint schema is model-agnostic.

voice_cloning

Multi-speaker dialogue

Multi-speaker dialogue synthesis (reference_id array + <|speaker:N|> tags) is available with the S2 family and drama-3-preview, not s1.

multi_speaker

Code

ElevenLabs SDK streaming TTS

Routes the ElevenLabs SDK through allmodels and streams the audio response.

import { ElevenLabsClient } from "elevenlabs";

const client = new ElevenLabsClient({
  apiKey: process.env.ALLMODELS_API_KEY,
  baseUrl: "https://api.allmodels.io/el"
});

const stream = await client.textToSpeech.stream("voice_id", {
  text: "I'm sorry, Dave. I'm afraid I can't do that.",
  modelId: "fish/drama-3-preview",
  outputFormat: "mp3_44100_128"
}, {
  queryParams: {
    provider: {
      "only": [
        "fish"
      ]
    }
  }
});

const reader = stream.getReader();
for (;;) {
  const { done, value } = await reader.read();
  if (done) break;
  // Write value to your response, file, or audio playback pipeline.
}