OpenCode에서 Muapi 사용

OpenCode에 Muapi를 OpenAI 호환 사용자 지정 공급자로 추가하여 Muapi 텍스트 모델을 사용하세요.

1. 키 생성 및 모델 선택

Muapi 대시보드에서 API 키를 만들고 사용 가능한 텍스트 모델을 조회합니다.

curl -s "https://api.muapi.ai/v1/models?type=text" \
  -H "Authorization: Bearer $MUAPI_API_KEY"

응답에 capabilities.tools: true가 있는 모델을 선택하세요. 파일 편집과 터미널 작업에는 도구 지원이 필요합니다.

2. Muapi를 공급자로 추가

OpenCode를 실행하는 셸에서 MUAPI_API_KEY 환경 변수를 설정합니다(macOS/Linux).

export MUAPI_API_KEY="your-muapi-api-key"

프로젝트 또는 전역 opencode.json 설정에 다음 공급자를 추가합니다.

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "muapi": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "Muapi",
      "options": {
        "baseURL": "https://api.muapi.ai/v1",
        "apiKey": "{env:MUAPI_API_KEY}"
      },
      "models": {
        "YOUR_MODEL_ID": { "name": "Muapi text model" }
      }
    }
  }
}

YOUR_MODEL_ID를 Muapi 모델 목록의 정확한 ID로 바꾸세요. API 키는 환경 변수에 보관하고 공유하거나 저장소에 커밋하는 설정 파일에 넣지 마세요.

3. 모델 선택

OpenCode를 시작하고 /models를 실행한 뒤 Muapi 공급자에서 모델을 선택합니다. 작은 코딩 작업으로 파일 읽기와 수정이 되는지 확인하세요.

문제 해결

  • /models에 Muapi가 나타나지 않으면 설정 문법, 모델 ID, 설정 파일 접근 권한을 확인하세요.
  • 인증 오류가 나면 OpenCode 실행 환경에 MUAPI_API_KEY가 설정되었는지 확인하세요.
  • 모델이 도구를 사용하지 못하면 capabilities.tools: true인 모델을 선택하세요.
  • 큰 저장소 프롬프트는 크레딧을 빠르게 사용할 수 있습니다. 작은 작업부터 시작하고 대시보드에서 사용량을 확인하세요.

현재 사용자 지정 공급자 옵션은 OpenCode 공급자 문서를 참조하세요.