fix

app/routers/transcribe.py

@@ -31,9 +31,16 @@ router = APIRouter(tags=["transcribe"])
 
 
 class TranscribeResult(BaseModel):
-    gpt: str = Field(..., description="Přepis z OpenAI (model whisper-1).")
-    deepgram: str = Field(..., description="Přepis z Deepgramu.")
-    merge: str = Field(..., description="Sloučený, co nejpřesnější výsledný přepis.")
+    gpt: str = Field(..., description="Přepis z OpenAI (model whisper-1), plynulý, bez mluvčích.")
+    deepgram: str = Field(
+        ...,
+        description="Přepis z Deepgramu. Při zapnuté diarizaci se štítky mluvčích "
+        "(`Mluvčí 0: ...`).",
+    )
+    merge: str = Field(
+        ...,
+        description="Sloučený, co nejpřesnější a úplný přepis se štítky mluvčích.",
+    )
 
 
 async def _read_upload(file: UploadFile) -> tuple[bytes, str, str]:
@@ -65,7 +72,11 @@ async def transcribe(
     whisper_model: str = Form(DEFAULT_WHISPER_MODEL, description="OpenAI přepisový model."),
     chat_model: str = Form(DEFAULT_CHAT_MODEL, description="OpenAI chat model pro sloučení."),
     language: str = Form(DEFAULT_LANGUAGE, description="Jazyk audia (ISO kód, např. cs)."),
-    diarize: bool = Form(True, description="Deepgram diarizace (rozlišení mluvčích)."),
+    diarize: bool = Form(
+        True,
+        description="Deepgram diarizace — rozlišení mluvčích. Při zapnutí vrací `deepgram` "
+        "přepis se štítky `Mluvčí N:` (interně zapne i utterances).",
+    ),
     smart_format: bool = Form(True, description="Deepgram smart formatting."),
     creds: Credentials = Depends(get_credentials),
 ) -> TranscribeResult: