Introducción a la configuración de modelos
Este tutorial explica cómo configurar varios modelos de lenguaje grandes en SelectTranslate extensión, incluyendo API keys, URL de punto final, selección de modelo, parámetros de rendimiento y configuración de mensajes. La configuración adecuada del modelo puede mejorar la estabilidad del servicio y mejorar la precisión de la traducción, la velocidad de respuesta y la experiencia general del usuario en diferentes escenarios de traducción.
1. Configurar API Key
un API key es la credencial de acceso oficial proporcionada por el proveedor de servicios modelo, utilizada para llamar de forma segura a su AI modelos y servicios relacionados.
Común API Key Problemas de configuración
- Incorrecto API Key Formato: El API key Es posible que falten caracteres, espacios adicionales o que esté truncado incorrectamente. Asegúrese de copiar la clave completa proporcionada por el servicio y evite incluir espacios, saltos de línea u otros caracteres no válidos.
- API Key Discrepancia con el Proveedor de Servicios: API keys de diferentes proveedores de modelos no son intercambiables. Por ejemplo, un OpenAI API key no se puede utilizar con DeepSeek modelos.
- API Key Caducado o deshabilitado: Su API key Es posible que haya sido revocado debido a vencimiento, desactivación manual, problemas con la cuenta, límites de uso o razones de seguridad. Visite la consola de su proveedor para verificar el estado actual de su API key.
- Error de URL del punto final: incluso con una dirección válida API Key, las pruebas de conexión pueden fallar si la URL del punto final es incorrecta, faltan rutas de versión o no coincide con los requisitos específicos del proveedor.
- El nombre del modelo no coincide: asegúrese de que el nombre del modelo esté escrito correctamente y que su proveedor lo admita oficialmente. Los errores tipográficos aquí frecuentemente se identifican erróneamente como API Key problemas.
- Problemas de red o proxy: la estabilidad de la red local, las configuraciones del proxy o las restricciones del firewall pueden bloquear las solicitudes, lo que genera fallas de autenticación o tiempos de espera de solicitud.
2. Selección del modelo de traducción
Al configurar la extensión, el nombre del modelo debe coincidir con el proveedor de servicios asociado con la API key; de lo contrario, el modelo no podrá llamarse correctamente.
Proveedores admitidos y mapeo de modelos
| Proveedor | Nombre del modelo |
|---|---|
| OpenAI | gpt-5、gpt-5-mini、gpt-5-nano |
| Gemini | gemini-2.5-flash、gemini-2.0-flash-lite |
3. Personalizado API URL
La extensión utiliza el oficial. API URL predeterminada, por lo que normalmente no es necesario realizar ajustes. La entrada manual de la URL solo es necesaria en los siguientes casos:
- Llamar al modelo a través de un proxy inverso o un servicio de retransmisión,
- Utilizando un servicio de modelo grande implementado de forma privada,
- Conexión con un tercero API servicios que no utilizan completamente la URL predeterminada oficial.
Pautas de entrada:
- La URL debe ser un punto final HTTPS completo, por ejemplo:
https://api.your-company.com/v1/chat/completions - La ruta del punto final debe coincidir con la documentación técnica del proveedor de servicios y la API debe recibir y manejar correctamente las solicitudes que sigan el formato especificado.
4. Ajuste de parámetros del modelo
Los siguientes parámetros se utilizan para ajustar la calidad de la traducción, la estabilidad del modelo y la velocidad de respuesta. La configuración predeterminada cubre la mayoría de los casos de uso; ajústelos según sea necesario para requisitos específicos.
| Parámetros | Descripción | Configuraciones recomendadas |
|---|---|---|
| Longitud máxima del texto por solicitud | Se utiliza para limitar la cantidad máxima de caracteres que se pueden enviar en una sola solicitud de traducción. Establecer este valor demasiado alto puede ralentizar API respuestas; mantenerlo dentro de un rango razonable ayuda a mejorar la estabilidad y la velocidad de respuesta. | - Recomendado 1000–1500 personajes- Evite excederse 2000 caracteres para evitar retrasos en la respuesta o pérdida de contenido. |
| Número máximo de párrafos por solicitud | El número de párrafos que se pueden enviar a la vez en una sola solicitud de traducción. Enviar demasiados párrafos a la vez puede aumentar la carga de procesamiento, lo que genera respuestas más lentas o una estabilidad reducida. Establecer este valor adecuadamente ayuda a mejorar la eficiencia y confiabilidad general de la traducción. | - Textos Técnicos o Legales:1(procesar párrafo por párrafo para garantizar la precisión de la terminología)- Novelas, Diálogos o Blogs: 3–5(mejora la fluidez) |
| Solicitudes máximas por segundo | El número de solicitudes de traducción enviadas por segundo. Si la tasa de solicitudes es demasiado alta, se pondrán en cola solicitudes adicionales para evitar que lleguen. API límites de tasas y para mantener la estabilidad general del sistema. | - Uso General:25- Servicios estrictos con tarifa limitada (p. ej., Gemini): 8–10 |
| Temperatura | Controla la aleatoriedad y variabilidad de la salida del modelo. Los valores de temperatura más altos producen respuestas más diversas y creativas, mientras que los valores más bajos dan como resultado resultados más estables, lo cual es preferible para traducciones consistentes y precisas. | - Recomendación para tareas de traducción: Las temperaturas oficiales recomendadas varían según el modelo. Se sugiere utilizar el valor predeterminado proporcionado y ajustarlo según sea necesario. |
5. Mensajes personalizados (mensaje del sistema/mensaje del usuario)
La extensión incluye mensajes de traducción generales optimizados e integrados que cubren los escenarios de traducción más comunes. Cuando existen requisitos específicos, como estilo de traducción, coherencia terminológica, experiencia en el dominio o preferencias de tono, se pueden utilizar indicaciones personalizadas para ajustar la salida del modelo.
Al crear mensajes de traducción personalizados, se recomienda seguir estas pautas:
- Instrucciones claras y específicas: especifique claramente el idioma de destino, el estilo de traducción, el dominio y cualquier expresión o elección de palabras que deba evitar.
- Instrucciones prácticas: utilice descripciones concretas y precisas, evitando declaraciones vagas o abstractas, para garantizar que el modelo pueda comprender y seguir las instrucciones con precisión.
- Mantenga las indicaciones concisas: asegúrese de que la indicación proporcione suficiente información sin dejar de ser breve, evitando detalles redundantes que podrían interferir con la comprensión del modelo.
6. Descargo de responsabilidad
🔔 Tenga en cuenta el nivel gratuito y las tarifas cobradas por el proveedor de servicios para evitar costos inesperados.