Introdução à configuração de modelos
Este tutorial explica como configurar vários modelos de linguagem grandes no SelectTranslate extensão, incluindo API keys, URLs de endpoint, seleção de modelo, parâmetros de desempenho e configurações de prompt. A configuração adequada do modelo pode melhorar a estabilidade do serviço e aprimorar a precisão da tradução, a velocidade de resposta e a experiência geral do usuário em diferentes cenários de tradução.
1. Configurar API Key
Um API key é a credencial de acesso oficial fornecida pelo provedor de serviços modelo, usada para ligar com segurança para seu AI modelos e serviços relacionados.
Comum API Key Problemas de configuração
- Incorreto API Key Formato: O API key pode ter caracteres ausentes, espaços extras ou estar truncado incorretamente. Certifique-se de copiar a chave completa fornecida pelo serviço e evite incluir espaços, quebras de linha ou outros caracteres inválidos.
- API Key Incompatibilidade com o Provedor de Serviços: API keys de fornecedores de modelos diferentes não são intercambiáveis. Por exemplo, um OpenAI API key não pode ser usado com DeepSeek modelos.
- API Key Expirado ou desativado: seu API key pode ter sido revogado devido a expiração, desativação manual, problemas de conta, limites de uso ou motivos de segurança. Visite o console do seu provedor para verificar o status atual do seu API key.
- Erro de URL do endpoint: mesmo com um endereço válido API Key, os testes de conexão poderão falhar se o URL do endpoint estiver incorreto, faltando caminhos de versão ou não corresponder aos requisitos específicos do provedor.
- Incompatibilidade de nome do modelo: certifique-se de que o nome do modelo esteja escrito corretamente e seja oficialmente compatível com seu provedor. Erros tipográficos aqui são frequentemente identificados erroneamente como API Key questões.
- Problemas de rede ou proxy: estabilidade da rede local, configurações de proxy ou restrições de firewall podem bloquear solicitações, resultando em falhas de autenticação ou tempos limite de solicitação.
2. Seleção do modelo de tradução
Ao configurar a extensão, o nome do modelo deve corresponder ao provedor de serviços associado ao API key; caso contrário, o modelo não poderá ser chamado com êxito.
Provedores suportados e mapeamento de modelos
| Provedor | Nome do modelo |
|---|---|
| OpenAI | gpt-5、gpt-5-mini、gpt-5-nano |
| Gemini | gemini-2.5-flash、gemini-2.0-flash-lite |
3. Personalizado API URL
A extensão usa o oficial API URL por padrão, portanto, geralmente não são necessários ajustes. A entrada manual do URL só é necessária nos seguintes casos:
- Chamar o modelo por meio de um proxy reverso ou serviço de retransmissão,
- Usando um serviço de modelo grande implantado de forma privada,
- Conectando-se a terceiros API serviços que não usam totalmente o URL padrão oficial.
Diretrizes de entrada：
- O URL deve ser um endpoint HTTPS completo, por exemplo:
https://api.your-company.com/v1/chat/completions - O caminho do terminal deve corresponder à documentação técnica do provedor de serviços e o API deve receber e tratar corretamente as solicitações que seguem o formato especificado.
4. Ajuste de parâmetros do modelo
Os parâmetros a seguir são usados para ajustar a qualidade da tradução, estabilidade do modelo e velocidade de resposta. As configurações padrão cobrem a maioria dos casos de uso; ajuste-os conforme necessário para requisitos específicos.
| Parâmetros | Descrição | Configurações recomendadas |
|---|---|---|
| Comprimento máximo do texto por solicitação | Usado para limitar o número máximo de caracteres que podem ser enviados em uma única solicitação de tradução. Definir este valor muito alto pode desacelerar API respostas; mantê-lo dentro de uma faixa razoável ajuda a melhorar a estabilidade e a velocidade de resposta. | - Recomendado 1000–1500 personagens- Evite exceder 2000 caracteres para evitar atrasos de resposta ou perda de conteúdo. |
| Número máximo de parágrafos por solicitação | O número de parágrafos que podem ser enviados de uma só vez em uma única solicitação de tradução. Enviar muitos parágrafos de uma vez pode aumentar a carga de processamento, levando a respostas mais lentas ou redução da estabilidade. Definir esse valor adequadamente ajuda a melhorar a eficiência e a confiabilidade geral da tradução. | - Textos Técnicos ou Legais:1(processar parágrafo por parágrafo para garantir a precisão da terminologia)- Romances, Diálogos ou Blogs: 3–5(melhora a fluência) |
| Máximo de solicitações por segundo | O número de solicitações de tradução enviadas por segundo. Se a taxa de solicitação for muito alta, solicitações adicionais serão enfileiradas para evitar atingir API limites de taxa e para manter a estabilidade geral do sistema. | - Uso Geral:25- Serviços com taxa limitada estrita (por exemplo, Gemini): 8–10 |
| Temperatura | Controla a aleatoriedade e a variabilidade da saída do modelo. Valores de temperatura mais elevados produzem respostas mais diversas e criativas, enquanto valores mais baixos resultam em resultados mais estáveis, o que é preferível para traduções consistentes e precisas. | - Recomendação para tarefas de tradução:As temperaturas oficiais recomendadas variam de acordo com o modelo. Sugere-se usar o padrão fornecido e ajustar conforme necessário. |
5. Prompts personalizados (prompt do sistema/prompt do usuário)
A extensão inclui prompts de tradução gerais integrados e otimizados que cobrem os cenários de tradução mais comuns. Quando existem requisitos específicos – como estilo de tradução, consistência terminológica, conhecimento do domínio ou preferências de tom – prompts personalizados podem ser usados para ajustar a saída do modelo.
Ao criar prompts de tradução personalizados, é recomendável seguir estas diretrizes:
- Instruções claras e específicas: especifique claramente o idioma de destino, o estilo de tradução, o domínio e quaisquer expressões ou opções de palavras a serem evitadas.
- Instruções práticas: use descrições concretas e precisas, evitando declarações vagas ou abstratas, para garantir que o modelo possa compreender e seguir as instruções com precisão.
- Mantenha os prompts concisos: certifique-se de que o prompt forneça informações suficientes e seja breve, evitando detalhes redundantes que possam interferir na compreensão do modelo.
6. Isenção de responsabilidade
🔔 Esteja ciente do nível gratuito e de quaisquer taxas cobradas pelo provedor de serviços para evitar custos inesperados.