fish-audio-api
SKILL.md
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> - Get API keys:
https://fish.audio/app/api-keys - Never hardcode keys — read from an env var like
FISH_API_KEY. - Errors are JSON
{status, message}for 401 / 402 / 404, and an array of{loc, type, msg, ctx, in}for 422 (validation).