Skip to main content

​
Welcome

You can generate a new API key at https://fish.audio/app/api-keys/.

​
Quick Start

See our Quick Start guide to generate audio in under 2 minutes.

​
Errors

Every error returns a JSON body with a message and a status. See Errors for the full status-code table, retry guidance, and SDK exception handling.

​
OpenAPI Schema

Fish Audio publishes a canonical OpenAPI schema at https://api.fish.audio/openapi.json. When working with AI coding agents or IDE assistants, mention this schema URL as part of your prompt or project context so the agent can understand Fish Audio’s endpoints, request and response models, authentication requirements, and supported parameters directly from the machine-readable API contract.

​
Distributed Tracing

Fish Audio inference APIs accept the W3C traceparent header so your business-side trace and Fish Audio’s inference-side trace can share the same trace ID. See Tracing & Performance Analysis for supported endpoints, examples, and enterprise performance analysis details.

​
Create a Voice Clone

Use our /model endpoint to create a voice clone model.

​
Generate Speech

Use our /v1/tts endpoint to generate speech.

​
Design a Voice

Use our /v1/voice-design endpoint to generate candidate voices from a prompt.

​
Real-time Streaming

Use our Python SDK or JavaScript SDK for real-time audio streaming with WebSocket.

​
Rate Limits

You can find the rate limits for each endpoint in the Rate Limits section.