OpenAI 호환

Roo Code에서 무료 Qwen3.8-27B 사용

편집기에서 코딩 에이전트를 실행하세요.

IteraCompute는 Cline 및 OpenCode에 내장되어 있어 직접 선택할 수 있습니다.Roo Code의 경우 아래 OpenAI Compatible 설정을 사용하세요.

3단계로 연결

1. API 키 생성

IteraCompute 계정을 생성하거나 로그인한 다음 콘솔에서 키를 생성하세요.

2. 기본 URL 구성

OpenAI Compatible을 선택하고 연결 필드를 입력합니다.선택한 모델에 대한 컨텍스트 창과 이미지 지원을 설정하세요.

3. 모델을 선택하세요

선택한 모델에 대한 정확한 API 모델 ID를 사용하세요.에이전트 또는 비전 기능을 활성화하기 전에 해당 컨텍스트와 기능을 확인하세요.

모델을 선택하세요

Qwen3.8-27B 예시는 Free 등급을 사용합니다. 월 30M tokens와 입력 및 요청한 최대 출력을 합한 128K(131072) 총 컨텍스트를 제공합니다. 최대 출력은 8192 tokens입니다.

누적 순 충전액이 $10에 도달하면 Starter가 활성화되어 월 100M tokens, 128K(131072) 컨텍스트와 대기열 우선권을 제공합니다. $50에 도달하면 Pro가 활성화되어 월 300M tokens, 대기열 우선권과 모델 최대치인 256K(262144) 컨텍스트를 제공합니다. 충전액은 API 잔액으로 사용할 수 있으며 월 요금이 아닙니다.

예시 구성

서버 환경이나 도구 자격 증명 저장소에 API 키를 보관하세요.해당하는 경우 예제 키 필드를 사용자 고유의 키로 바꿉니다.

연결 설정 · 도구의 각 필드를 입력하세요
API Provider: OpenAI Compatible
Base URL: https://api.iteracompute.com/v1
API Key: YOUR_ITERACOMPUTE_API_KEY
Model ID: qwen/qwen3.8-27b
Context window: 131072
Supports images: Yes

Roo Code의 각 필드 찾기

루필드어디서 찾을 수 있나요?예시값
API 제공자설정OpenAI Compatible
기본 URLAPI Provider 아래https://api.iteracompute.com/v1
API 키기본 URL 아래YOUR_ITERACOMPUTE_API_KEY
모델/모델 ID연결 필드 아래qwen/qwen3.8-27b
컨텍스트 창모델 구성 확장131072
최대 출력 토큰모델 구성8192
이미지 지원모델 구성Yes
컴퓨터 사용모델 구성No

VS Code에서 Roo Code 사이드바를 열고 설정 기어를 클릭한 다음 API 공급자 아래에서 OpenAI 호환을 선택합니다.모델 선택기 아래의 모델 구성을 확장합니다.필드 문구는 버전에 따라 다를 수 있습니다.이 값은 무료 Qwen3.8-27B를 사용합니다: 최대 8192개의 출력 토큰을 포함하여 총 131072개의 토큰.이 모델에서는 입력 가격과 출력 가격이 모두 0입니다.

연결 테스트

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}'

choice[0].message.content에 보이는 텍스트가 포함되어 있는지 확인하세요.HTTP 200만으로는 부족합니다.추론은 출력 예산을 소비할 수 있습니다.무료 Qwen을 사용하려면 다음을 사용하세요. 첫 번째 무료 통화 예시 사고를 비활성화하려면 도구 내부에 메시지를 보내세요.

작은 코딩 작업 완료

Node.js 22 이상이 설치된 VS Code에서 빈 폴더를 엽니다.Roo Code에서 코드 모드와 구성된 IteraCompute 공급자를 선택한 후 이 프롬프트를 보냅니다.제안된 파일 쓰기를 검토하고 Roo가 요청하면 테스트 명령을 승인합니다.

Roo Code · 작업 프롬프트
In this empty workspace, create slugify.mjs exporting slugify(text).
Trim whitespace, lowercase the text, replace each run of non-ASCII-alphanumeric characters with one hyphen, and strip leading/trailing hyphens.
Create slugify.test.mjs with node:test and node:assert/strict for these four cases:
"Hello Roo Code" -> "hello-roo-code"
"  IteraCompute API  " -> "iteracompute-api"
"Hello,   World!!" -> "hello-world"
"---" -> ""
Run node --test slugify.test.mjs. Fix failures, then complete the task with the files changed and the actual test result. Do not install dependencies.

완료된 작업에 대한 참조 파일

slugify.mjs
export function slugify(text) {
  return text.trim().toLowerCase().replace(/[^a-z0-9]+/g, '-').replace(/^-+|-+$/g, '');
}
slugify.test.mjs
import test from 'node:test';
import assert from 'node:assert/strict';
import { slugify } from './slugify.mjs';

for (const [input, expected] of [
  ['Hello Roo Code', 'hello-roo-code'],
  ['  IteraCompute API  ', 'iteracompute-api'],
  ['Hello,   World!!', 'hello-world'],
  ['---', ''],
]) {
  test(JSON.stringify(input), () => assert.equal(slugify(input), expected));
}
node --test slugify.test.mjs · 결과 요약
# tests 4
# pass 4
# fail 0

이러한 참조 파일은 2026년 10월 12일에 로컬로 테스트되었으며 4가지 테스트가 모두 통과되었습니다.Roo 실행을 확인하려면 두 파일이 모두 존재하는지, 명령이 코드 0으로 종료되고 Roo가 테스트 결과와 함께 작업 완료를 보고하는지 확인하세요.채팅 응답이나 HTTP 200만으로는 파일 편집 및 명령 실행을 확인할 수 없습니다.로컬 참조 테스트는 엔드투엔드 Roo API 실행을 설정하지 않습니다.

선택된 모델 기능

선택한 모델의 API 기능입니다.워크플로의 기능 가용성은 도구 및 해당 설정에 따라 달라집니다.추론 제어는 모델에 따라 다릅니다.

  • 채팅 완료지원됨
  • 도구 호출지원됨
  • 추론지원됨
  • 이미지 입력지원됨
  • 스트리밍지원됨

문제 해결

401 / 403 · 활성 공급자

Roo 설정에서 모델 권한을 포함하여 현재 작업에서 선택한 공급자 구성에 대한 API 키를 확인하세요.저장하고 다시 시도하세요.무료 Qwen에는 잔액이나 카드가 필요하지 않습니다.

404 · 기본 URL / 모델 ID

Roo 설정에서 OpenAI 호환을 선택하고 기본 URL에 /v1을 유지하고 openai/ 접두사 없이 모델 ID로 qwen/qwen3.8-27b를 입력합니다.채팅 완료 엔드포인트를 사용하세요.

400 / 도구가 실행되지 않음

Roo에는 기본 도구 호출이 필요합니다.모델 구성 확인: 무료 Qwen 컨텍스트는 131072이고 최대 출력은 8192입니다. 파일 편집의 경우 코드 모드를 사용하고 작업 타임라인에서 보류 중인 도구 승인을 검사합니다.완성된 채팅 답변만으로는 부족합니다.

429 / 빈 답장

IteraCompute 콘솔에서 월간 사용량과 TPM을 확인하고 Roo 작업을 다시 시도하기 전에 Retry-After를 준수하십시오.빈 응답의 경우 첫 번째 무료 API 호출을 별도로 실행하여 표시되는 콘텐츠를 확인한 다음 작은 코드 모드 작업을 다시 시도하세요.

401 / 403 : 키와 모델 권한을 확인하세요.무료 Qwen에는 잔액이나 카드가 필요하지 않습니다.유료 모델의 경우 사용 가능한 잔액도 확인하세요.

Roo Code 구성 참고 →

Roo Code로 구축을 시작해 보세요.

키를 연결하고 모델을 선택한 후 첫 번째 요청을 보내세요.