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

Errors return a JSON body with a message and a status; some endpoints add fields. Errors from the network edge in front of the API, such as some 413 or 5xx responses, may not have a JSON body. 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.