docs: explain concurrency and QPM conversion

[Kilerd]

Summary

• Explain that Fish Audio rate limits are based on concurrent in-flight requests, not a fixed QPS or QPM allowance.
• Add the planning formulas for converting concurrency to QPS/QPM and estimating required concurrency.
• Show example QPM estimates for short AI companion replies, voice-agent turns, narration paragraphs, and long-form audiobook synthesis.

Validation

• npx prettier --check developer-guide/models-pricing/pricing-and-rate-limits.mdx
• git diff --check
• npx mint validate was run with filesystem access for Mintlify's cache. It reached build validation but failed on existing repository warnings unrelated to this page: invalid react imports in snippet JSX files and a missing temp snippet import.

Summary by CodeRabbit

• Documentation
  • Standardized formatting across pricing tables and informational callouts.
  • Improved consistency and readability for Text-to-Speech, Automatic Speech Recognition, and Voice Design pricing sections.
  • Reformatted the Concurrent Request Limits table.
  • Added guidance and examples for converting concurrency limits to QPS or QPM.

[coderabbitai]

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: 08db62b0-9d0d-4e86-946f-e37d4d433ae0

📥 Commits

Reviewing files that changed from the base of the PR and between 3ec13d5 and 34ab22b.

📒 Files selected for processing (1)

• developer-guide/models-pricing/pricing-and-rate-limits.mdx

---

📝 Walkthrough

Walkthrough

The pricing documentation page standardizes MDX formatting, reorganizes Text-to-Speech, Automatic Speech Recognition, and Voice Design pricing tables, and adds guidance for converting concurrency limits into QPS or QPM.

Changes

Pricing and rate limits documentation

Layer / File(s)	Summary
Pricing tables and billing sections developer-guide/models-pricing/pricing-and-rate-limits.mdx	Standardizes MDX imports and formatting, and reformats the Text-to-Speech, Automatic Speech Recognition, and Voice Design pricing tables and billing explanations.
Concurrency conversion guidance developer-guide/models-pricing/pricing-and-rate-limits.mdx	Reformats the Concurrent Request Limits table and adds formulas, measurement instructions, conversion notes, and throughput examples for QPS and QPM planning.

Estimated code review effort: 2 (Simple) | ~10 minutes

Possibly related PRs

• fishaudio/docs#94: Updates entries in the overlapping Text-to-Speech pricing table.

Suggested reviewers: abersheeran

🚥 Pre-merge checks | ✅ 5

✅ Passed checks (5 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The title clearly summarizes the main documentation change about concurrency and QPM conversion.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch docs/concurrency-qpm-rate-limits

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}

[mintlify]

Preview deployment for your docs. Learn more about Mintlify Previews.

Project	Status	Preview	Updated (UTC)
hanabiaiinc	🟢 Ready	View Preview	Jul 6, 2026, 1:37 PM

💡 Tip: Enable Workflows to automatically generate PRs for you.