MonkeyCode란 무엇이며 API를 어떻게 설정하나요?
MonkeyCode의 용도를 확인하고 BetterToken API Key, Base URL, Model ID를 설정한 뒤 429 및 연결 오류를 해결하세요.
MonkeyCode는 자체 인터페이스에서 사용자 지정 provider로 모델을 연결할 수 있는 AI 도구입니다. 이 가이드는 AI Model에서 OpenAI Chat(Chat Completions)으로 BetterToken을 설정하는 방법을 다루며 MonkeyCode 자체의 공식 API를 문서화하지 않습니다. BetterToken API Key, https://bettertoken.ai/v1, 정확한 Model ID를 입력하고 연결을 저장한 뒤 새 채팅을 시작하세요. MonkeyCode에서 호환 모델을 직접 선택하려는 경우 이 방법을 사용하세요. Kodacode / Koda에서 문제가 발생했다면 Kodacode 설정 및 429 오류 가이드를 확인하세요. 제품 정보와 현재 온라인 서비스는 MonkeyCode 공식 저장소를 참고하세요.
주요 설정
| 필드 | 값 |
|---|---|
| API Key | BetterToken API Key |
| Base URL | https://bettertoken.ai/v1 |
| 모델 | 모델 광장의 현재 Model ID |
사전 요구 사항
이미 계정이 있나요? 로그인하고 잔액을 충전한 다음 콘솔에서 키를 만드세요.
추가 요구 사항
- MonkeyCode 계정(서비스 접속은 공식 저장소 참고)
설치
MonkeyCode를 설치하거나 연 다음 아래의 수동 설정을 계속하세요.
수동 설정
MonkeyCode settings UI에서 이 설정을 완료하세요. configuration file을 직접 수정할 필요가 없습니다.
| 필드 | 값 |
|---|---|
| API Key | BetterToken API Key |
| Base URL | https://bettertoken.ai/v1 |
| 모델 | 모델 광장의 현재 Model ID |
설정
MonkeyCode에 로그인
MonkeyCode 공식 저장소에 안내된 온라인 서비스를 열고 로그인하세요.
system settings 열기
task page로 이동한 후 오른쪽 아래의 Settings를 클릭하세요.
AI model 연결
AI Model section에서 Bind를 클릭하세요.
BetterToken config 입력
| 필드 | 값 |
|---|---|
| Model API URL | https://bettertoken.ai/v1 |
| API Key | BetterToken API Key |
| API format | OpenAI Chat (Chat Completions) |
| Model name | 모델 광장에서 복사한 model ID |
공식 문서에서 명시적으로 요구할 때만 extra headers 설정
BetterToken에 User-Agent를 필수로 하는 MonkeyCode 공식 설정 요구 사항은 확인하지 못했습니다. 이 페이지에 제시된 Base URL, API Key 및 model ID부터 사용하세요.
custom gateway, tenant routing, observability 또는 caching layer도 사용한다면 해당 upstream service의 공식 문서에 따라서만 headers를 추가하세요.
저장 후 사용 시작
Save를 클릭한 다음 main page로 돌아가 방금 설정한 모델을 선택하세요.
MonkeyCode 다시 시작
config를 저장한 후 page를 새로 고치거나 MonkeyCode를 다시 열고 새 모델을 사용하세요.
연결 확인
짧은 테스트 prompt를 보내세요. 도구가 authentication 또는 Model ID 오류 없이 response를 반환하면 연결이 작동합니다. configuration을 변경한 후에는 도구를 완전히 다시 시작하세요.
모델 전환
model selector를 열거나 configuration의 Model field를 변경하세요. 모델 광장의 정확한 Model ID를 사용한 다음 현재 session을 다시 시작하세요.
일반적인 오류
| 오류 | 확인할 사항 |
|---|---|
401 또는 Unauthorized | BetterToken API Key를 확인하고 앞뒤 spaces를 제거하세요. |
404 | Base URL을 확인하고 specific endpoint path를 추가하지 마세요. |
model not found | 모델 광장에서 현재 Model ID를 복사하세요. |
| Changes가 적용되지 않음 | configuration을 저장하고 도구를 완전히 다시 시작하세요. |
기술 세부 정보
Protocol, endpoint 및 내부 provider 필드
이 설정은 https://bettertoken.ai/v1을 사용합니다. 도구가 OpenAI-compatible endpoint path를 추가합니다. 특정 field에서 명시적으로 요구하지 않는 한 /chat/completions 또는 /responses를 추가하지 마세요.
