feat: QoL and account related APIs

* feat: add reference_id parameter to TTS conversion methods

Signed-off-by: James Ding <jamesding365@gmail.com>

* feat: add support for references parameter in TTS conversion methods

Signed-off-by: James Ding <jamesding365@gmail.com>

* feat: add tests for WebSocket streaming with reference_id and references parameters

Signed-off-by: James Ding <jamesding365@gmail.com>

* feat: change references parameter to Optional in TTS methods

Signed-off-by: James Ding <jamesding365@gmail.com>

* feat: add support for additional parameters in TTS methods (format, latency, speed)

Signed-off-by: James Ding <jamesding365@gmail.com>

* feat: preserve volume when overriding speed in Prosody configuration

Signed-off-by: James Ding <jamesding365@gmail.com>

* feat: add check_free_credit parameter and support for opus audio format

Signed-off-by: James Ding <jamesding365@gmail.com>

* feat: enforce value constraints on top_p and temperature parameters in TTS models

Signed-off-by: James Ding <jamesding365@gmail.com>

* Update src/fishaudio/resources/tts.py

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

* Update src/fishaudio/resources/tts.py

Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

---------

Signed-off-by: James Ding <jamesding365@gmail.com>
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>

Author: twangodev

src/fishaudio/resources/account.py

@@ -2,7 +2,7 @@
 
 from typing import Optional
 
-from ..core import AsyncClientWrapper, ClientWrapper, RequestOptions
+from ..core import OMIT, AsyncClientWrapper, ClientWrapper, RequestOptions
 from ..types import Credits, Package
 
 
@@ -15,12 +15,14 @@ def __init__(self, client_wrapper: ClientWrapper):
     def get_credits(
         self,
         *,
+        check_free_credit: Optional[bool] = OMIT,
         request_options: Optional[RequestOptions] = None,
     ) -> Credits:
         """
         Get API credit balance.
 
         Args:
+            check_free_credit: Whether to check free credit availability
             request_options: Request-level overrides
 
         Returns:
@@ -31,11 +33,21 @@ def get_credits(
             client = FishAudio(api_key="...")
             credits = client.account.get_credits()
             print(f"Available credits: {float(credits.credit)}")
+
+            # Check free credit availability
+            credits = client.account.get_credits(check_free_credit=True)
+            if credits.has_free_credit:
+                print("Free credits available!")
             ```
         """
+        params = {}
+        if check_free_credit is not OMIT:
+            params["check_free_credit"] = check_free_credit
+
         response = self._client.request(
             "GET",
             "/wallet/self/api-credit",
+            params=params,
             request_options=request_options,
         )
         return Credits.model_validate(response.json())
@@ -78,12 +90,14 @@ def __init__(self, client_wrapper: AsyncClientWrapper):
     async def get_credits(
         self,
         *,
+        check_free_credit: Optional[bool] = OMIT,
         request_options: Optional[RequestOptions] = None,
     ) -> Credits:
         """
         Get API credit balance (async).
 
         Args:
+            check_free_credit: Whether to check free credit availability
             request_options: Request-level overrides
 
         Returns:
@@ -94,11 +108,21 @@ async def get_credits(
             client = AsyncFishAudio(api_key="...")
             credits = await client.account.get_credits()
             print(f"Available credits: {float(credits.credit)}")
+
+            # Check free credit availability
+            credits = await client.account.get_credits(check_free_credit=True)
+            if credits.has_free_credit:
+                print("Free credits available!")
             ```
         """
+        params = {}
+        if check_free_credit is not OMIT:
+            params["check_free_credit"] = check_free_credit
+
         response = await self._client.request(
             "GET",
             "/wallet/self/api-credit",
+            params=params,
             request_options=request_options,
         )
         return Credits.model_validate(response.json())