Fish Audio Raw API Skill

Use this skill to generate correct, runnable Fish Audio API calls without any SDK. The canonical machine-readable sources are:

• REST: https://docs.fish.audio/api-reference/openapi.json
• WebSocket: https://docs.fish.audio/api-reference/asyncapi.yml

This file condenses those into rules an agent can apply directly.

Global facts

• Base URL: https://api.fish.audio
• WebSocket base: wss://api.fish.audio
• Auth (all endpoints): Authorization: Bearer <FISH_API_KEY>
• Optional distributed tracing for inference APIs: see https://docs.fish.audio/api-reference/observability.
• Get API keys: https://fish.audio/app/api-keys
• Never hardcode keys. Read from an env var like FISH_API_KEY.
• Errors are JSON with at least {status, message} (for example 401 / 402 / 404 / 429). Speech-to-text errors from transcribe-1-pro also carry code and request_id. Errors from the network edge in front of the API (some 413 and 5xx responses) may not be JSON. 422 validation errors, on the endpoints that return them, are an array of {loc, type, msg, ctx, in}.