livekit integration plus change pipecat to s1

Author: kcui5

developer-guide/integrations/livekit.mdx

@@ -0,0 +1,77 @@
+---
+title: "LiveKit"
+description: "Build real-time voice AI agents with Fish Audio and LiveKit"
+icon: "/images/livekit-logo.jpeg"
+---
+
+[LiveKit Agents](https://github.com/livekit/agents) is an open source framework for building real-time voice and multimodal AI agents. It handles streaming audio pipelines, turn detection, interruptions, and LLM orchestration so you can focus on your agent's behavior.
+
+Fish Audio integrates with LiveKit through the `fishaudio` plugin, providing text-to-speech synthesis with support for both chunked and real-time WebSocket streaming modes.
+
+## Prerequisites
+
+- A [Fish Audio account](https://fish.audio) with an API key
+- Python 3.9 or higher
+
+## Installation
+
+Install LiveKit Agents with Fish Audio support:
+
+```bash
+pip install "livekit-agents[fishaudio]"
+```
+
+## Configuration
+
+Set your Fish Audio API key as an environment variable:
+
+```bash
+export FISH_API_KEY=your_api_key_here
+```
+
+## Basic usage
+
+Add Fish Audio TTS to your LiveKit agent:
+
+```python
+from livekit.plugins.fishaudio import TTS
+
+tts = TTS(
+    reference_id="your_voice_model_id",  # Optional: use a specific voice
+    model="s1",
+    sample_rate=24000,
+    latency_mode="balanced"
+)
+```
+
+### Key parameters
+
+| Parameter | Description |
+|-----------|-------------|
+| `api_key` | Your Fish Audio API key (or use `FISH_API_KEY` env var) |
+| `model` | TTS model/backend to use (default: `s1`) |
+| `reference_id` | Voice model ID from the [Fish Audio library](https://fish.audio/discover) |
+| `output_format` | Audio format: `pcm`, `mp3`, `wav`, or `opus` (default: `pcm`) |
+| `sample_rate` | Audio sample rate in Hz (default: `24000`) |
+| `num_channels` | Number of audio channels (default: `1`) |
+| `base_url` | Custom API endpoint (default: `https://api.fish.audio`) |
+| `latency_mode` | `normal` (~500ms) or `balanced` (~300ms, default) |
+
+### Streaming modes
+
+The plugin supports two synthesis modes:
+
+```python
+# Chunked (non-streaming) synthesis
+stream = tts.synthesize("Hello, world!")
+
+# Real-time WebSocket streaming
+stream = tts.stream()
+```
+
+## Resources
+
+- [LiveKit Agents Documentation](https://docs.livekit.io/agents/)
+- [LiveKit GitHub](https://github.com/livekit/agents)
+- [Fish Audio Plugin Reference](https://docs.livekit.io/reference/python/v1/livekit/plugins/fishaudio/index.html)
+- [Fish Audio Voice Library](https://fish.audio/discover)

developer-guide/integrations/pipecat.mdx

@@ -39,7 +39,7 @@ from pipecat.services.fish import FishAudioTTSService
 tts = FishAudioTTSService(
     api_key=os.getenv("FISH_API_KEY"),
     reference_id="your_voice_model_id",  # Optional: use a specific voice
-    model_id="speech-1.5",
+    model_id="s1",
     params=FishAudioTTSService.InputParams(
         latency="normal",
         prosody_speed=1.0
@@ -53,7 +53,7 @@ tts = FishAudioTTSService(
 |-----------|-------------|
 | `api_key` | Your Fish Audio API key |
 | `reference_id` | Voice model ID from the [Fish Audio library](https://fish.audio/discover) |
-| `model_id` | TTS model version (default: `speech-1.5`) |
+| `model_id` | TTS model version (default: `s1`) |
 | `output_format` | Audio format: `pcm`, `mp3`, `wav`, or `opus` |
 
 ### Prosody controls

docs.json

@@ -100,7 +100,8 @@
           {
             "group": "Integrations",
             "pages": [
-              "developer-guide/integrations/pipecat"
+              "developer-guide/integrations/pipecat",
+              "developer-guide/integrations/livekit"
             ]
           },
           {