Usage
Check account usage, credits, and quota for overseas integrations.
CN API paths use a separate contract
This English reference describes the global FishAudio Open API. For Kitta Audio China integrations, use the CN API Reference, API Playground, and API Keys in this site.
Usage
For overseas integrations, the stable account check today is Profile. Use it to read credits, tier, and remaining API quota before large operations. Dedicated usage endpoints should be treated as schema-driven: call only paths present in GET /api/openapi.json.
Request
Profile uses a normal bearer-authenticated request:
GET /api/open/v1/profile
Authorization: Bearer FISHSPEECH_API_KEYcurl https://fishaudio.org/api/open/v1/profile \
-H "Authorization: Bearer FISHSPEECH_API_KEY"Response
{
"user_id": "user_123",
"api_quota_remaining": 988000,
"tier": "pro",
"credits": 1200
}Use the response for operational guardrails, not as a reservation. Other workers may consume balance after you check it.
Billing And Credits
Store balance snapshots around expensive batches. If customers ask why a batch stopped, compare the starting profile snapshot, completed job count, failed job count, and final profile snapshot.
Errors
Profile errors follow the shared API error shape. If a future usage endpoint appears in the schema, apply the same retry and logging rules: log requestId, avoid logging API keys, and pause batch creation on insufficient credits.
Continue with runnable API checks
Docs and executable requests stay in the same CN-site surface. After reading the reference, open the API Playground for curl examples or manage API keys in the developer workspace.