모델 구성 소개

이 튜토리얼에서는 에서 다양한 대규모 언어 모델을 구성하는 방법을 설명합니다.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 오류: 유효한 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`

💡 드롭다운 메뉴에서 모델명을 선택하는 것이 좋습니다. 수동으로 입력하는 경우 제공업체의 특정 모델 ID와 정확히 일치하는지 확인하세요(예: gpt-5 또는 gpt-5-mini).

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. 면책조항

⚠️ “커스텀 사용하기 API Key” 모드: 발생하는 모든 비용은 실제 사용량을 기준으로 해당 서비스 제공업체에서 청구합니다. 이 확장은 요청 기능만 제공하며 추가 비용은 청구하지 않습니다.

🔔 예상치 못한 비용이 발생하지 않도록 무료 등급과 서비스 제공업체에서 부과하는 수수료를 숙지하시기 바랍니다.

Translation Credits & 모델 Tokens

모델 구성 프로세스