Migrate from transcribe-1

• POST /v1/asr requests with no model header, or with a value that is not an exact, lowercase match, such as Transcribe-1-Pro.
• The Python and JavaScript SDKs, when you don’t set the model header.
• The OpenAI-, Groq-, and OpenRouter-compatible transcription endpoints, with fish-audio/transcribe-1 or an alias such as whisper-1, gpt-4o-transcribe, or whisper-large-v3.
• The ElevenLabs-compatible speech-to-text endpoint, which ignores model_id.
• OpenAI Realtime-compatible transcription sessions opened with ?intent=transcription and no model, or with fish-audio/transcribe-1.

​

What is changing

​

What happens if you do nothing

• text can include speaker markers such as <|speaker:0|> when more than one person speaks.
• text can include emotion and vocal-event cues such as [laughter].
• With timestamps requested, the response also includes speaker_turns.
• Error bodies add code and request_id to status and message.

​

Migrate to transcribe-1-pro

​

Send the model header

curl --request POST https://api.fish.audio/v1/asr \
  --header "Authorization: Bearer $FISH_API_KEY" \
  --header "model: transcribe-1-pro" \
  --form audio=@speech.wav

from fishaudio import FishAudio
from fishaudio.core import RequestOptions

client = FishAudio()  # reads FISH_API_KEY

with open("speech.wav", "rb") as f:
    result = client.asr.transcribe(
        audio=f.read(),
        request_options=RequestOptions(
            additional_headers={"model": "transcribe-1-pro"}
        ),
    )

print(result.text)

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

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

const result = await client.speechToText.convert(
  { audio: new File([await readFile("speech.wav")], "speech.wav") },
  { headers: { model: "transcribe-1-pro" } }
);
console.log(result.text);

​

Keep plain transcripts, if you need them

curl --request POST https://api.fish.audio/v1/asr \
  --header "Authorization: Bearer $FISH_API_KEY" \
  --header "model: transcribe-1-pro" \
  --form audio=@speech.wav \
  --form diarize=false \
  --form tag_audio_events=false

​

If you use a compatible endpoint

​

Check your error handling

​

Support

• API Reference - Complete API documentation
• Create a Voice Clone - Create a voice clone model
• Generate Speech - Generate realistic speech
• Real-time Streaming - WebSocket for real-time streaming
• Discord Community - Get help from the community
• Support Email - Contact our support team