Введение в конфигурацию моделей
В этом руководстве объясняется, как настроить различные большие языковые модели в SelectTranslate расширение, включая API keys, URL-адреса конечных точек, выбор модели, параметры производительности и настройки подсказок. Правильная конфигурация модели может улучшить стабильность сервиса и повысить точность перевода, скорость ответа и общий пользовательский опыт в различных сценариях перевода.
1. Настроить API Key
Ан API key — это официальные учетные данные доступа, предоставленные поставщиком модельных услуг и используемые для безопасного вызова его AI модели и сопутствующие услуги.
Общий API Key Проблемы с конфигурацией
- Неверно API Key Формат: API key могут содержать пропущенные символы, лишние пробелы или быть неправильно обрезаны. Обязательно скопируйте полный ключ, предоставленный службой, и избегайте использования пробелов, разрывов строк и других недопустимых символов.
- API Key Несоответствие с поставщиком услуг: API keys от разных поставщиков моделей не являются взаимозаменяемыми. Например, OpenAI API key нельзя использовать с DeepSeek модели.
- API Key Срок действия истек или отключен: ваш API key могли быть отозваны из-за истечения срока действия, деактивации вручную, проблем с учетной записью, ограничений на использование или по соображениям безопасности. Посетите консоль вашего провайдера, чтобы проверить текущий статус вашего API key.
- Ошибка URL-адреса конечной точки: даже при наличии действительного API Key, тесты подключения могут завершиться неудачно, если URL-адрес конечной точки неверен, отсутствуют пути к версии или не соответствует конкретным требованиям поставщика.
- Несоответствие названия модели. Убедитесь, что название модели написано правильно и официально поддерживается вашим поставщиком. Типографские ошибки здесь часто ошибочно принимают за API Key проблемы.
- Проблемы с сетью или прокси-сервером. Стабильность локальной сети, конфигурации прокси-сервера или ограничения брандмауэра могут блокировать запросы, что приводит к сбоям аутентификации или таймаутам запросов.
2. Выбор модели перевода
При настройке расширения название модели должно соответствовать поставщику услуг, связанному с API key; в противном случае модель нельзя будет назвать успешной.
Поддерживаемые поставщики и сопоставление моделей
| Поставщик | Название модели |
|---|---|
| OpenAI | gpt-5、gpt-5-mini、gpt-5-nano |
| Gemini | gemini-2.5-flash、gemini-2.0-flash-lite |
3. Пользовательский API URL-адрес
Расширение использует официальный API URL-адрес по умолчанию, поэтому никаких изменений обычно не требуется. Ручной ввод URL-адреса требуется только в следующих случаях:
- Вызов модели через обратный прокси или службу ретрансляции,
- Используя частный развернутый сервис больших моделей,
- Подключение к стороннему API сервисы, которые не полностью используют официальный URL-адрес по умолчанию.
Правила ввода:
- URL-адрес должен быть полной конечной точкой HTTPS, например:
https://api.your-company.com/v1/chat/completions - Путь к конечной точке должен соответствовать технической документации поставщика услуг, а API должен правильно получать и обрабатывать запросы, соответствующие указанному формату.
4. Настройка параметров модели
Следующие параметры используются для настройки качества перевода, стабильности модели и скорости ответа. Настройки по умолчанию охватывают большинство случаев использования; корректируйте их по мере необходимости в соответствии с конкретными требованиями.
| Параметры | Описание | Рекомендуемые настройки |
|---|---|---|
| Максимальная длина текста на запрос | Используется для ограничения максимального количества символов, которые можно отправить в одном запросе на перевод. Установка слишком высокого значения может замедлить работу API ответы; сохранение его в разумных пределах помогает улучшить стабильность и скорость реакции. | - Рекомендуется 1000–1500 персонажи- Избегайте превышения 2000 символы, чтобы предотвратить задержки ответа или потерю контента. |
| Максимальное количество абзацев в запросе | Количество абзацев, которые можно отправить одновременно в одном запросе на перевод. Отправка слишком большого количества абзацев одновременно может увеличить нагрузку на обработку, что приведет к замедлению ответов или снижению стабильности. Правильная установка этого значения помогает повысить общую эффективность и надежность перевода. | - Технические или юридические тексты:1(обрабатывать параграф за параграфом, чтобы обеспечить точность терминологии)- Романы, диалоги или блоги: 3–5(улучшает беглость речи) |
| Максимальное количество запросов в секунду | Количество запросов на перевод, отправляемых в секунду. Если частота запросов слишком высока, дополнительные запросы будут поставлены в очередь, чтобы избежать попадания API ограничения скорости и для поддержания общей стабильности системы. | - Общее использование:25- Услуги со строгим ограничением скорости (например, Gemini): 8–10 |
| Температура | Управляет случайностью и изменчивостью выходных данных модели. Более высокие значения температуры дают более разнообразные и творческие ответы, а более низкие значения приводят к более стабильным результатам, что предпочтительнее для последовательного и точного перевода. | - Рекомендации для задач перевода: Официальные рекомендуемые температуры зависят от модели. Предлагается использовать предоставленное значение по умолчанию и корректировать по мере необходимости. |
5. Пользовательские подсказки (системная подсказка/подсказка пользователя)
Расширение включает встроенные оптимизированные общие подсказки для перевода, которые охватывают наиболее распространенные сценарии перевода. При наличии особых требований, таких как стиль перевода, согласованность терминологии, знание предметной области или предпочтения тона, можно использовать пользовательские подсказки для точной настройки результатов модели.
При создании индивидуальных запросов на перевод рекомендуется следовать следующим рекомендациям:
- Четкие и конкретные инструкции. Четко укажите целевой язык, стиль перевода, домен, а также любые выражения или варианты слов, которых следует избегать.
- Практические инструкции. Используйте конкретные и точные описания, избегая расплывчатых или абстрактных утверждений, чтобы модель могла точно понять инструкции и следовать им.
- Сохраняйте краткость. Убедитесь, что подсказка содержит достаточную информацию, оставаясь при этом краткой, избегая лишних деталей, которые могут помешать пониманию модели.
6. Отказ от ответственности
🔔 Обратите внимание на уровень бесплатного пользования и любые комиссии, взимаемые поставщиком услуг, чтобы избежать непредвиденных расходов.