Fish Audio Docs
Integration GuidesThird-Party Integrations

n8n Setup

Use an n8n HTTP Request node to convert articles, RSS items, spreadsheet rows, or AI copy into Fish Audio MP3 files.

Call Fish Audio TTS from n8n

n8n can call Fish Audio through an HTTP Request node for RSS narration, batch voiceovers, Telegram speech, and automated audio production.

Configure HTTP Request

SettingValue
MethodPOST
URLhttps://fishaudio.org/v1/audio/speech
AuthenticationHeader Auth
HeaderAuthorization: Bearer YOUR_API_KEY
Content TypeJSON
Response FormatFile
Output Fielddata

JSON body:

{
  "model": "fishaudio-s21pro-flash",
  "input": "={{ $json.text }}",
  "voice": "00a1b221-6137-4b73-ad62-b0cbce134167",
  "response_format": "mp3",
  "speed": 1
}

Store the API key in an n8n credential rather than an exportable workflow JSON file.

Suggested workflow

RSS / Google Sheets / Webhook
→ Edit Fields prepares text
→ HTTP Request generates MP3
→ R2 / S3 / Telegram / Email

Troubleshooting

  • Garbled output: Response Format must be File, not JSON or Text.
  • Expression has no text: confirm that $json.text exists before the HTTP node.
  • 429 during batches: add Loop Over Items, Wait, or a concurrency limit.
  • 401/402: verify the credential and API credits.