문제 해결
opencode 오류 — AI_APICallError, Model Not Found, 인증 해결
opencode는 Vercel AI SDK 위에 만들어져 프로바이더 실패가 AI_* 오류 클래스로 나타나며, models.dev 카탈로그에 없는 모델은 opencode.json에 기능을 직접 선언해야 합니다. 아래 페이지는 사용자에게 실제로 도달하는 실패들을 다룹니다.
| 오류 | 의미 |
|---|---|
AI_APICallError | opencode는 프로바이더 실패를 Vercel AI SDK의 AI_APICallError로 표시합니다. 감싸진 상태 코드를 읽는 방법과 그 아래의 baseURL, 키, 모델을 고치는 방법. |
opencode model not found | opencode는 자신이 아는 모델만 제공하며, 커스텀 프로바이더 모델은 models.dev 카탈로그에 없습니다. opencode.json에 모델을 선언해 표시되고 작동하게 만드는 방법. |
opencode 401 unauthorized | opencode는 커스텀 프로바이더를 options.apiKey — 보통 {env:...} 플레이스홀더 — 로 인증합니다. 변수가 조용히 빈 값으로 해석되어 요청이 401로 실패하는 이유. |
this model does not support image input | opencode는 모델의 modalities가 선언되어 있지 않으면 첨부된 이미지를 조용히 안내 문구로 대체합니다. 이미지 입력을 켜는 opencode.json 한 줄 선언. |
opencode AI_APICallError 원인과 해결 방법
opencode는 프로바이더 실패를 Vercel AI SDK의 AI_APICallError로 표시합니다. 감싸진 상태 코드를 읽는 방법과 그 아래의 baseURL, 키, 모델을 고치는 방법.
opencode Model Not Found — 커스텀 프로바이더 모델 선언 방법
opencode는 자신이 아는 모델만 제공하며, 커스텀 프로바이더 모델은 models.dev 카탈로그에 없습니다. opencode.json에 모델을 선언해 표시되고 작동하게 만드는 방법.
opencode에서 API 키가 인식되지 않을 때 — auth와 {env} 플레이스홀더
opencode는 커스텀 프로바이더를 options.apiKey — 보통 {env:...} 플레이스홀더 — 로 인증합니다. 변수가 조용히 빈 값으로 해석되어 요청이 401로 실패하는 이유.
opencode: This Model Does Not Support Image Input 해결 방법
opencode는 모델의 modalities가 선언되어 있지 않으면 첨부된 이미지를 조용히 안내 문구로 대체합니다. 이미지 입력을 켜는 opencode.json 한 줄 선언.