블로그로 돌아가기

도구 및 통합가이드

OpenHands를 CheapTokens에 연결하기: 모델, Base URL, 키

OpenHands 설정 > LLM(고급)에서 세 필드를 채워 CheapTokens 모델로 에이전트를 실행하고, 흔한 세 가지 실패를 읽는 법을 알아보세요.

작성자: CheapTokens Team 게시됨읽는 시간 4분

CheapTokens Base URL과 모델 id가 입력된 OpenHands 설정 필드
이 페이지의 내용
  1. 설정을 열기 전에
  2. 세 개의 필드
  3. 먼저 OpenHands 밖에서 구성 요소를 확인하세요
  4. 잘못된 필드는 어떻게 보이나
  5. 세션 하나의 비용
  6. 이미 다른 제공자로 OpenHands를 사용 중이신가요?

고급을 켠 뒤 설정 > LLM에서 세 개의 필드를 채우면 CheapTokens 모델로 OpenHands를 실행할 수 있습니다. Custom Model(openai/deepseek-ai/DeepSeek-V4-Flash-0731), Base URL(https://api.cheaptokens.dev/v1), API Key입니다. 설정은 이게 전부입니다. 이 페이지의 나머지는 각 필드의 의미와 필드 중 하나가 잘못됐을 때 어떤 모습인지 설명합니다.

필드 이름과 모델 문자열 규칙은 OpenAI 호환 엔드포인트에 관한 OpenHands 문서 페이지에서 가져왔습니다(2026년 11월 8일 확인, 페이지에 날짜나 버전 없음). 해당 날짜 기준 최신 OpenHands 릴리스는 v1.37.0(2026년 11월 6일)입니다. 사용 중인 빌드의 레이블이 조금 달라 보이면 위치로 판단하세요: 모델, base URL, 키.

설정을 열기 전에#

미리 준비해 두면 왕복 한 번을 아낄 수 있는 세 가지가 있습니다: 키, 모델 id, 설정 접근 권한입니다.

체크리스트

설정할 준비가 되셨나요?

키와 base URL이 처음이신가요? base_url이란 무엇이고 어떻게 전환하는지에서 몇 분 만에 다루고, GET /v1/models로 모델 목록 조회하기에서 id를 직접 찾는 방법을 보여줍니다.

세 개의 필드#

설정 > LLM을 열고 고급을 켜세요. Base URL 필드는 고급 토글 아래에 있습니다.

OpenHands 설정 > LLM(고급)의 세 가지 값
스크린샷이 아닌 값 다이어그램: 세 필드 각각에 무엇이 들어가는지. 키는 자리표시자입니다.

문서는 모델 규칙을 이렇게 설명합니다: Custom Model은 openai/ 뒤에 모델 이름이 오며, 자체 접두사가 있는 프록시를 거치는 경우 openai/<proxy-prefix>/<model-name>입니다. openai/ 뒤의 부분이 모델 이름입니다. CheapTokens의 id는 deepseek-ai/DeepSeek-V4-Flash-0731이므로 전체 문자열은 openai/deepseek-ai/DeepSeek-V4-Flash-0731입니다.

필드 값
Custom Model openai/deepseek-ai/DeepSeek-V4-Flash-0731
Base URL https://api.cheaptokens.dev/v1
API Key CheapTokens 키

에이전트에 이 모델을 쓰는 이유는? DeepSeek-V4-Flash는 380K 컨텍스트 윈도우와 답변당 최대 32,768 출력 토큰을 가지며, 시간대와 관계없이 단일 가격이라 긴 세션이 피크 시간에 더 비싸지지 않습니다. 코딩 에이전트는 매 단계마다 많은 컨텍스트를 다시 보내는데, 바로 이를 위한 윈도우입니다.

GLM이 더 좋으신가요? 같은 필드에 openai/zai-org/GLM-5.3-Flash(390K 컨텍스트, 최대 8,192 출력 토큰)를 넣고 다른 건 바꾸지 마세요. 같은 잔액, 같은 키, 같은 Base URL입니다.

먼저 OpenHands 밖에서 구성 요소를 확인하세요#

에이전트를 탓하기 전에 같은 URL, 키, id로 요청을 하나 보내세요. 이게 작동하면 남은 문제는 필드를 입력한 방식에 있습니다.

bash
curl https://api.cheaptokens.dev/v1/chat/completions \
  -H "Authorization: Bearer $CHEAPTOKENS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"deepseek-ai/DeepSeek-V4-Flash-0731","messages":[{"role":"user","content":"Say ready"}],"max_tokens":20}'

빠진 것을 보세요: model 값에 openai/이 없습니다. 그 접두사는 API가 아니라 OpenHands용입니다. 응답에는 prompt_tokens와 completion_tokens가 담긴 usage 블록이 있습니다 — 나중에 에이전트 세션에서 합산되어 표시될 바로 그 두 숫자입니다.

비교하기

모델 문자열: 하나의 접두사, 두 가지 결과

id만

deepseek-ai/DeepSeek-V4-Flash-0731 — curl과 API용 형식입니다.

접두사 포함

openai/deepseek-ai/DeepSeek-V4-Flash-0731 — Custom Model 필드용 형식입니다.

잘못된 필드는 어떻게 보이나#

세 필드 각각이 원인이 될 수 있습니다:

각 오류가 가리키는 곳: 키, Base URL, 모델 문자열
증상에서 필드로: 401은 키, 404는 Base URL 또는 모델 문자열을 가리킵니다.
  • 잘못된 키. API가 401을 반환합니다 — 키가 없거나, 잘못 입력됐거나, 복사하면서 끝에 공백이 붙었습니다.
  • 잘못된 Base URL. 요청이 엉뚱한 곳으로 가서 404나 연결 오류가 발생합니다. 주소는 /v1로 끝나야 하며 추가 경로가 없어야 합니다.
  • 잘못된 모델 문자열. 접두사가 빠졌거나, 뒤의 id가 전체 id가 아닙니다(API는 전체 gateway_id만 허용하며 deepseek-v4-flash-0731 같은 짧은 id는 받지 않습니다).

401과 404에 대한 자세한 이유는 API 401 또는 404: 잘못된 키, base URL 또는 모델 id에 있습니다.

직접 해보기직접 해보기: 키도 맞고 URL도 맞는데 에이전트가 첫 단계에서 계속 실패합니다. 어느 필드를 여시겠습니까?정답 보기

Custom Model 필드입니다. openai/로 시작하는지, 뒤의 id가 위 표와 정확히 같은 철자인지 확인하세요. 키와 URL은 curl로 확인하기 쉬운 쪽입니다.

세션 하나의 비용#

에이전트는 한 줄짜리 작업이 아니라 매 단계마다 전체 컨텍스트에 대해 과금합니다. OpenHands가 버그를 40단계 동안 처리하며, 단계마다 약 30,000 토큰을 보내고 1,500 토큰을 쓴다고 가정해 봅시다. DeepSeek-V4-Flash의 한 단계는 $0.0006이고, 40단계는 아래에서 다른 모델 및 OpenRouter와 나란히 비교되어 있습니다.

모델 요청당 40회 요청 OpenRouter, 40회 요청
GLM-5.3-Flash $0.00066 $0.0264 $0.0452
DeepSeek-V4-Flash $0.0006 $0.024 $0.0924
MiniMax-M2.7 $0.0017 $0.069 $0.828

요청당 입력 30,000개 및 출력 1,500개 토큰입니다. 100만 토큰당 가격은 현재 기준이며 당사 요금제에 따라 함께 변경됩니다. OpenRouter 열은 동일한 작업량에 대한 참고 가격을 보여줍니다.

입력과 출력을 합산한 총액에서 이 워크로드의 경우 DeepSeek-V4-Flash가 OpenRouter보다 저렴합니다. 가정은 직접 바꿀 수 있습니다: 짧은 수정은 10단계, 큰 리팩터링은 100단계일 수 있습니다. 현재 가격은 가격 페이지에 있고, 모델 페이지는 저렴한 DeepSeek입니다.

이미 다른 제공자로 OpenHands를 사용 중이신가요?#

그렇다면 세 값만 바꾸면 됩니다: Custom Model, Base URL, API Key. 프로젝트의 다른 것은 바뀌지 않으며 같은 방식으로 되돌릴 수 있습니다. API 자체의 단계별 연결은 CheapTokens 문서에 있고, 다른 도구에서의 유사한 설정은 Aider 연결에 있습니다.

태그: