Mejore el reconocimiento de nombres de personas, productos y términos especializados con palabras clave (instantáneas o precompiladas) y mejora de contexto.
Elegir un método de optimización
Los nombres de personas, productos y términos especializados pueden sonar como palabras comunes y producir homófonos o grafías incorrectas en las transcripciones. Las palabras clave y la mejora de contexto proporcionan las grafías correctas o información relevante para ayudar al modelo a mejorar el reconocimiento.
Elija según la información que ya tenga la aplicación: use palabras clave para una lista de términos definida, o contexto para conversaciones y descripciones de negocio existentes. Para las palabras clave, elija el modo instantáneo o precompilado según la necesidad de reutilizar la lista en varias solicitudes. Consulte los Modelos y regiones compatibles antes de usarlo.
| Método | Cuándo usarlo | Cómo usarlo |
|---|---|---|
| Palabras clave instantáneas | Los nombres y términos cambian en cada solicitud, o hay pocos términos temporales y no es necesario almacenar ni gestionar una lista. | Envíe un objeto «término: peso» en cada solicitud de reconocimiento. La aplicación proporciona las grafías correctas y puede ajustar la preferencia del modelo por cada término mediante su peso. |
| Palabras clave precompiladas | Ya existe un glosario de negocio, o el mismo conjunto de términos se usa repetidamente y necesita mantenimiento centralizado. | Cree una lista con términos, pesos e idiomas opcionales y haga referencia a su ID durante el reconocimiento. Actualice la lista cuando cambie el glosario, sin reenviar todas las entradas en cada solicitud. |
| Mejora de contexto | La aplicación ya guarda conversaciones recientes, descripciones de negocio o textos especializados que pueden ayudar al reconocimiento. | Envíe el texto relevante como mensajes de contexto junto con el audio. No es necesario extraer términos ni asignar pesos individuales. Incluya las grafías correctas. Una lista de términos definida también puede usarse como palabras clave para corregir el mismo tipo de error. |
Usar palabras clave
Antes de ejecutar los ejemplos, descargue el audio de ejemplo y prepare una clave de API en la consola de Model Studio. Texto del audio: «Please send the quarterly project report to Kelyra before Friday.»
Palabras clave instantáneas
Las palabras clave instantáneas son adecuadas para términos que cambian en cada solicitud. Defina parameters.vocabulary como un objeto JSON cuyas claves sean los textos de las palabras clave (string) y cuyos valores sean los pesos (integer). No es necesario crear una lista previamente.
-
Reconocer el audio sin palabras clave
Sin palabras clave, el nombre de este ejemplo no se reconoce con precisión. La siguiente solicitud devuelve el resultado sin configuración.
cURL
-
Añadir palabras clave instantáneas a la solicitud
Añada «Kelyra» a la misma solicitud con peso 4. Mantenga sin cambios las demás entradas. Para los valores y ajustes de peso, consulte Ajustar los pesos de las palabras clave.
cURL
| Configuración | Ejemplo de transcripción |
|---|---|
| Sin configuración | Please send the quarterly project report to Kellira before Friday. |
| Con configuración | Please send the quarterly project report to Kelyra before Friday. |
Palabras clave precompiladas
Las palabras clave precompiladas son adecuadas para vocabularios de negocio reutilizados en varias solicitudes. Cree una lista previamente y envíe vocabulary_id durante el reconocimiento, sin reenviar todas las entradas.
Envíe las entradas como un array JSON al crear la lista. Cada elemento contiene los siguientes campos:
| Campo | Tipo | Obligatorio | Descripción |
|---|---|---|---|
text | string | Sí | Una palabra real en un idioma compatible con el modelo. Para los límites de longitud, consulte Reglas del texto de las palabras clave. |
weight | integer | Sí | Use de 1 a 5 para palabras clave normales, empezando por 4. Algunos modelos también admiten el peso 50 para superpalabras clave. Consulte Ajustar los pesos de las palabras clave. |
lang | string | No | Código que determina el idioma al que se aplica la entrada. Puede omitirse si se desconoce. Para su relación con el parámetro de reconocimiento language_hints, consulte Organizar y mantener vocabularios. |
La administración de palabras clave y el reconocimiento de voz deben usar la misma cuenta. De lo contrario, el reconocimiento no puede acceder al vocabulario.
- HTTP / cURL
- SDK
-
Crear una lista de palabras clave
Este ejemplo usa
qwen-audio-3.1-asr-flashy especifica el modelo de destino mediantetarget_model. Guardeoutput.vocabulary_idde la respuesta.cURL -
Comprobar que la lista está lista
Sustituya
<vocabulary_id>por el ID devuelto en la creación y consulte la lista. Inicie el reconocimiento cuandooutput.statusseaOK.cURL -
Hacer referencia a la lista durante el reconocimiento
Haga referencia a la lista mediante
parameters.vocabulary_iden la solicitud de reconocimiento, sin reenviar sus entradas.cURL -
Reutilizar o eliminar la lista
Las solicitudes posteriores pueden seguir usando el mismo ID. Ejecute la siguiente solicitud de eliminación solo cuando la lista deje de ser necesaria, para liberar su cuota.
cURL
Usar la mejora de contexto
La mejora de contexto puede usar directamente el historial de conversaciones o textos especializados existentes. Las palabras clave requieren términos y pesos, mientras que el contexto se envía como mensajes de texto, sin dividir los materiales de negocio en entradas individuales. Ambos métodos pueden mejorar el reconocimiento de nombres propios. Elija según la información disponible en la aplicación.
Preparar el contexto
Para el audio de ejemplo, los mensajes existentes que contengan el nombre del destinatario «Kelyra» pueden proporcionar su grafía correcta. A continuación se presentan dos fuentes habituales de contexto.
- Contexto de negocio o texto especializado
- Historial de conversaciones
Use el texto relevante de una descripción de proyecto o material especializado existente en un mensaje con
role=user y type=input_text. No es necesario inventar una conversación ni añadir una respuesta. Envíe el siguiente array como contexto:El mensaje
assistant es opcional. Ordene el historial por turnos, con cada mensaje user antes de su mensaje assistant correspondiente. Para los límites de longitud del texto y de turnos retenidos, consulte Límites de uso.Configurar y llamar al servicio
Reconozca el mismo audio con el contexto preparado. Elija un ejemplo de llamada según la familia de modelos.
- Qwen-Audio-ASR
- Qwen-Audio-ASR-Message / Qwen-Audio-ASR-Streaming
- Qwen-Audio-ASR-Filetrans
Este ejemplo usa
qwen-audio-3.1-asr-flash. Coloque los mensajes de contexto en orden en input.messages, seguidos del mensaje de audio actual que contiene input_audio.cURL
| Configuración | Ejemplo de transcripción |
|---|---|
| Sin configuración | Please send the quarterly project report to Kellira before Friday. |
| Con configuración | Please send the quarterly project report to Kelyra before Friday. |
Ajustar y solucionar problemas de reconocimiento
Compare el mismo audio antes y después de configurar y ajuste las entradas, los pesos o el contexto. El ajuste de palabras clave se aplica a ambos métodos.
Ajustar los pesos de las palabras clave
Los pesos de palabras clave normales van de 1 a 5. Comience con weight=4. Un peso mayor favorece la palabra, pero un valor excesivo puede sustituir por error otras palabras de sonido similar.
| Peso | Preferencia | Cuándo usarlo |
|---|---|---|
| 1–2 | Leve | Término de sonido similar a una palabra común, para evitar correcciones excesivas |
| 3–4 | Moderada | Configuración inicial recomendada para la mayoría de los escenarios |
| 5 | Fuerte | Términos frecuentes en el audio que rara vez se confunden con otras palabras |
weight=50 en ambos métodos para mejorar la recuperación de términos objetivo. Cada vocabulario o solicitud puede contener un máximo de 50 superpalabras clave.
Organizar y mantener vocabularios
- Agrupar por escenario: Cree listas precompiladas independientes para cada escenario de negocio, como terminología médica y nombres de productos, para reducir las entradas no relacionadas.
-
Distinguir el idioma de la entrada del idioma del audio: un vocabulario precompilado puede mezclar idiomas identificados por
lang. El parámetro de reconocimientolanguage_hintsdeclara el idioma del audio. Al configurarlo, solo surten efecto las palabras clave del idioma coincidente; los demás se ignoran. - Mantener periódicamente: Actualice las entradas según las necesidades del negocio y elimine las listas sin uso para liberar la cuota.
Deje al menos 5 minutos entre actualizaciones de una lista de palabras clave; de lo contrario, las palabras clave actualizadas podrían no surtir efecto.
Revisar la calidad del reconocimiento
Primero, determine si el problema es una configuración sin efecto, una preferencia excesiva por las palabras clave o un audio difícil de reconocer. Después, compruebe los puntos correspondientes.
| Síntoma | Comprobaciones y acciones |
|---|---|
| Las palabras clave no se reconocen como se esperaba | Compruebe primero los Modelos y regiones compatibles. Las palabras clave instantáneas se especifican en parameters.vocabulary. Para las precompiladas, compruebe la cuenta, vocabulary_id, status=OK y que el target_model de la lista coincida con el modelo de reconocimiento.Aumente el peso de la palabra clave dentro del intervalo admitido y compare los resultados del mismo audio para determinar si el peso era demasiado bajo. |
| Otras palabras se sustituyen incorrectamente por palabras clave | Reduzca el peso dentro del intervalo admitido y elimine los términos ajenos al escenario. Compruebe que lang coincide con language_hints de la API de reconocimiento y que las entradas pertenecen al idioma deseado. |
| El contexto no mejora los términos deseados | Compruebe las grafías correctas, los roles, los tipos y el orden de los mensajes, así como el campo de entrada requerido por la API. El texto que supere los límites de longitud o turnos puede truncarse o descartarse. Consulte Límites de uso. |
| Muchas palabras comunes también son incorrectas | Compruebe que el formato y la frecuencia de muestreo del audio cumplan los requisitos del modelo y reduzca el ruido de fondo. Para audio en un solo idioma, declare el idioma mediante language_hints de la API de reconocimiento. Para la selección del modelo y los requisitos de audio, consulte Descripción general del reconocimiento de voz. |
Modelos y regiones compatibles
- Palabras clave precompiladas
- Palabras clave instantáneas
- Mejora de contexto
- Singapur
- China (Pekín)
Las palabras clave solo se admiten en el espacio de trabajo principal, no en los subespacios.
- Qwen-Audio-ASR: qwen-audio-3.1-asr-flash, qwen-audio-3.0-asr-flash
- Qwen-Audio-ASR-Streaming: qwen-audio-3.1-asr-flash-streaming, qwen-audio-3.0-asr-flash-streaming
- Qwen-Audio-ASR-Filetrans: qwen-audio-3.1-asr-flash-filetrans, qwen-audio-3.0-asr-flash-filetrans
- Qwen-Audio-ASR-Message: qwen-audio-3.1-asr-flash-message
- Fun-ASR-Realtime: fun-asr-realtime
- Fun-ASR-Flash: fun-asr-flash-2026-06-15
- Fun-ASR: fun-asr
Límites de uso
- Límites de palabras clave
- Reglas del texto de las palabras clave
- Límites de contexto
| Límite | Descripción |
|---|---|
| Número de listas de palabras clave | Hasta 50 vocabularios precompilados por cuenta, compartidos entre todos los modelos. Cada uno tiene un vocabulary_id. |
| Palabras clave | Series Qwen-Audio-ASR-Message, Qwen-Audio-ASR-Streaming, Qwen-Audio-ASR-Filetrans y Qwen-Audio-ASR: hasta 2000.Modelos de versión principal de las series Fun-ASR-Realtime, Fun-ASR-Flash y Fun-ASR: hasta 2000. Otros modelos de estas series y la serie Paraformer: hasta 500.Se cuentan por vocabulario para palabras clave precompiladas y por solicitud para las instantáneas. |
| Superpalabras clave | Un máximo de 50 entradas puede tener peso 50. |
En las series Qwen-Audio-ASR-Message, Qwen-Audio-ASR-Streaming, Qwen-Audio-ASR-Filetrans y Qwen-Audio-ASR, el servicio combina las palabras clave precompiladas e instantáneas cuando se configuran ambas. Si el conjunto combinado supera las 2000 palabras clave, selecciona 2000 al azar.
Facturación de las funciones
Las funciones de palabras clave instantáneas y precompiladas son gratuitas. Para los cargos por llamadas a modelos con palabras clave o mejora de contexto, consulte las reglas de facturación.
API relacionadas
- Para crear, consultar, actualizar y eliminar listas de palabras clave, consulte API de administración de palabras clave.
- SDK de gestión de palabras clave: SDK de Java y SDK de Python.
- API de llamada a modelos: Eventos del cliente de Qwen-Audio-ASR-Message, Eventos del cliente de Qwen-Audio-ASR-Streaming, Qwen-Audio-ASR-Filetrans HTTP API y Qwen-Audio-ASR HTTP API.