1. API 키 생성
IteraCompute 계정을 생성하거나 로그인한 다음 콘솔에서 키를 생성하세요.
3단계로 연결
2. 기본 URL 구성
@ai-sdk/openai- Compatible을 사용하여 IteraCompute 사용자 지정 공급자를 추가합니다.
3. 모델을 선택하세요
선택한 모델에 대한 정확한 API 모델 ID를 사용하세요.에이전트 또는 비전 기능을 활성화하기 전에 해당 컨텍스트와 기능을 확인하세요.
모델을 선택하세요
예시 구성
서버 환경이나 도구 자격 증명 저장소에 API 키를 보관하세요.해당하는 경우 예제 키 필드를 사용자 고유의 키로 바꿉니다.
오픈코드.json
{
"$schema": "https://opencode.ai/config.json",
"model": "iteracompute/qwen/qwen3.8-27b",
"provider": {
"iteracompute": {
"npm": "@ai-sdk/openai-compatible",
"name": "IteraCompute",
"options": {
"baseURL": "https://api.iteracompute.com/v1",
"apiKey": "{env:ITERACOMPUTE_API_KEY}"
},
"models": {
"qwen/qwen3.8-27b": {
"name": "Qwen3.8-27B"
}
}
}
}
}버전 및 검증
2026년 10월 14일에 검증된 실제 워크플로 · OpenCode 1.19.0 · Node.js 25.2.1 · Windows · 무료 Qwen 전용.파일 읽기, slugify.mjs 복구, 테스트 실행, 독립적 재실행: 4회 통과, 0회 실패.유지된 5단계 실행은 30,911개의 토큰과 25.256초의 에이전트 이벤트 창을 보고합니다.
정확한 프롬프트, 검증된 구성, 코드 차이, 테스트 및 전체 작업 로그 →
성공 기준
OpenCode에서 짧은 프롬프트를 보낸 다음 비어 있지 않은 답변을 확인하세요.코딩 테스트의 경우 diff 파일을 검사하고 프로젝트 테스트 명령을 실행합니다.
설치된 버전 기록
opencode --version아래 API 확인 후 구성된 도구 자체를 테스트해 보세요.HTTP 200 또는 cURL 결과만으로는 해당 도구를 확인할 수 없습니다.
연결 테스트
cURL · 채팅 완료
# Bash / zsh / WSL; set ITERACOMPUTE_API_KEY in your environment first.
curl --fail-with-body https://api.iteracompute.com/v1/chat/completions \
-H "Authorization: Bearer $ITERACOMPUTE_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"qwen/qwen3.8-27b","messages":[{"role":"user","content":"Reply with exactly: Hello!"}],"max_tokens":512}'choices[0].message.content에 보이는 텍스트가 포함되어 있는지 확인하세요.HTTP 200만으로는 부족합니다.추론은 출력 예산을 소비할 수 있습니다.무료 Qwen을 사용하려면 다음을 사용하세요. 첫 무료 API 호출 예제 사고를 비활성화하려면 도구 내부에 메시지를 보내세요.
선택된 모델 기능
선택한 모델의 API 기능입니다.워크플로의 기능 가용성은 도구 및 해당 설정에 따라 달라집니다.추론 제어는 모델에 따라 다릅니다.
- 채팅 완료지원됨
- 도구 호출지원됨
- 추론지원됨
- 이미지 입력지원됨
- 스트리밍지원됨
문제 해결
공급자 또는 모델을 찾을 수 없습니다.
프로젝트에서 opencode.json을 로드합니다.선택한 이름은 iteracompute/qwen/qwen3.8-27b입니다.모델 키는 iteracompute 공급자 내부의 qwen/qwen3.8-27b입니다.
자격증명 누락
OpenCode를 실행하는 프로세스에서 ITERACOMPUTE_API_KEY를 설정합니다.{env:ITERACOMPUTE_API_KEY} 필드는 해당 환경 변수를 읽습니다.터미널을 변경한 후 다시 엽니다.
엔드포인트 또는 모델 설정
@ai-sdk/openai- Compatible을 사용하고 baseURL에 /v1을 유지하세요.대규모 프로젝트를 연결하기 전에 계정 계층에 대한 컨텍스트 및 출력 제한을 구성하십시오.
429 / 요청 제한
계정 전체의 월간 사용량과 TPM을 확인하세요.Retry-After를 존중하고 병렬 재시도를 방지합니다.무료 Qwen에는 자동으로 지불되는 초과분이 없습니다.다른 모델은 게시된 가격을 사용합니다.
401 / 403 : 키와 모델 권한을 확인하세요.무료 Qwen에는 잔액이나 카드가 필요하지 않습니다.유료 모델의 경우 사용 가능한 잔액도 확인하세요.
