모델 제공업체 연결
API 유형, 엔드포인트, API 키와 모델 ID를 입력하고 Yenpo의 요청 URL 생성 방식과 일반적인 연결 오류 해결 방법을 알아보세요.
AI Reader는 설정에서 선택한 제공업체를 사용합니다. 사용할 수 있는 모델과 요금은 제공업체 계정에 따릅니다. 파일 읽기와 검색에는 이 연결이 필요하지 않습니다.
제공업체 추가
설정 → 모델에서 제공업체 추가(더하기 버튼)를 누르고 새 항목을 현재 제공업체로 선택하세요. ‘팀 게이트웨이’처럼 알아보기 쉬운 이름을 붙이세요. 이름은 표시용이며 API 선택에 영향을 주지 않습니다.
다음 항목을 입력하세요.
| 항목 | 입력할 내용 |
|---|---|
| API 유형 | 서비스 프로토콜: OpenAI Chat Completions, OpenAI Responses 또는 Anthropic Messages |
| 엔드포인트 | 게이트웨이에 필요한 경로 접두사를 포함한 서비스 URL |
| 인증 / API 키 | API 키 또는 해당 제공업체가 제공하는 로그인 옵션 |
| 모델 | 계정에서 사용할 수 있는 정확한 모델 ID |
API 키는 설정에만 입력하고 대화나 프로젝트 파일에는 넣지 마세요. 키 대신 계정 로그인을 제공하는 경우 로그인 방식에서 선택하세요.
API 유형에 맞는 엔드포인트
모델 이름만으로 프로토콜을 알 수는 없습니다. 같은 게이트웨이가 비슷한 모델 이름을 서로 다른 API로 제공할 수 있습니다. 서비스 API 문서를 따르고 필요한 경로 접두사를 유지하세요.
다음은 Yenpo가 요청 URL을 만드는 방식입니다. 예시이며 실제 서비스가 아닙니다.
| API 유형 | 엔드포인트 입력 예시 | 생성되는 요청 URL |
|---|---|---|
| Chat Completions | https://gateway.example/v1 |
https://gateway.example/v1/chat/completions |
| Responses | https://gateway.example |
https://gateway.example/v1/responses |
| Messages | https://gateway.example |
https://gateway.example/v1/messages |
엔드포인트가 이미 /chat/completions, /responses 또는 /messages로 끝나면 해당 API 유형에서 그대로 사용합니다. Responses와 Messages는 /v1로 끝나면 마지막 구간을 추가합니다. Chat Completions는 입력한 주소 뒤에 /chat/completions를 추가하며 누락된 /v1을 대신 넣지 않습니다.
오류가 사라질 때까지 API 유형을 무작정 바꾸지 마세요. 서비스가 지원하는 프로토콜과 전체 요청 경로를 확인하세요.
모델 ID
모델에 ID를 입력하거나 서비스가 모델 목록을 제공하면 목록 가져오기를 누르세요. 목록 조회와 모델 호출은 별도 요청이므로 조회에 실패해도 모델은 작동할 수 있습니다. 문서에 나온 ID를 직접 입력해 보세요.
컨텍스트 길이는 입력·출력 예산, 대화 압축 시점 및 이후 유지할 컨텍스트 양에 영향을 줍니다. 모델 문서의 한도를 입력하세요. 비우면 Yenpo 기본값을 사용합니다. 너무 작으면 불필요하게 압축하고, 너무 크면 모델이 요청을 거부할 수 있습니다.
요금은 실행 상세에 표시되는 예상 비용 계산에 사용됩니다. 제공업체의 요금을 입력하세요. 실제 청구액이나 모델 접근 권한을 바꾸지는 않습니다. 처음 연결할 때는 다른 모델 설정을 그대로 두세요.
이미지 입력은 제공업체별로 기본적으로 꺼져 있습니다. 모델과 API가 보낼 이미지를 지원할 때만 이미지 허용을 켜세요.
작은 질문으로 테스트
서비스에 보내도 되는 작은 파일을 열고 질문하세요.
빈 입력에 대해 이 함수는 무엇을 반환하나요? 관련 분기를 인용해 주세요.
답변이 돌아오면 연결은 작동합니다. 답변의 정확성은 별개이므로 코드와 대조하세요.
요청에는 입력한 메시지뿐 아니라 AI Reader가 프로젝트에서 찾은 관련 코드도 포함됩니다. 비공개 코드를 원격 엔드포인트로 보내기 전에 데이터, 편집 권한 및 터미널을 읽으세요.
요청 실패 시
| 증상 | 확인할 사항 |
|---|---|
| 인증 또는 권한 오류 | 선택한 계정이나 키, 엔드포인트 운영자, 모델 접근 권한 |
| 찾을 수 없음 또는 API 미지원 | API 유형, 게이트웨이 접두사를 포함한 전체 요청 경로 |
| 모델을 찾을 수 없음 | 정확한 모델 ID와 계정의 사용 권한 |
| 모델 목록 조회 실패 | 서비스의 목록 제공 여부. 문서의 ID를 직접 입력 |
| 시간 초과 또는 스트림 중단 | 네트워크 접근, 프록시나 게이트웨이 동작, 제공업체 상태 |
HTTP 상태만으로 원인을 알기 어려우며 게이트웨이가 상위 서비스 오류를 바꾸기도 합니다. 문제 보고에는 오류 메시지, API 유형 및 비공개 내용을 제거한 엔드포인트를 포함하세요. API 키는 절대 포함하지 마세요.
편집을 허용한 실행이 중단되었다면 재시도 전에 작업 트리를 확인하세요. 최종 답변이 없어도 파일이 변경되었을 수 있습니다.