feat: enhance API docs with AI-friendly parameter constraints and validation

app.py

@@ -1277,7 +1277,19 @@ def voice_clone_synthesis(
         gr.Error: If parameters are out of range or invalid combinations are used.
     """
     
-    # Validate parameter ranges early for better AI agent feedback
+    # Validate and convert parameter types early for better AI agent feedback
+    temperature = float(temperature)
+    speed = float(speed)
+    repetition_penalty = float(repetition_penalty)
+    length_penalty = float(length_penalty)
+    gpt_cond_len = int(gpt_cond_len)
+    top_k = int(top_k)
+    top_p = float(top_p)
+    silence_threshold = int(silence_threshold)
+    min_silence_len = int(min_silence_len)
+    keep_silence = int(keep_silence)
+    max_chars_per_segment = int(max_chars_per_segment)
+    
     if not (0.1 <= temperature <= 1.5):
         raise gr.Error(f"Temperature must be between 0.1 and 1.5, got {temperature}")
     if not (0.5 <= speed <= 2.0):