블로그로 돌아가기

도구 및 통합가이드

DeepSeek Harness를 CheapTokens에 연결하기: 커스텀 제공자

DeepSeek Harness에서 커스텀 OpenAI 호환 제공자를 추가하고, CheapTokens API를 가리킨 뒤 첫 코딩 작업을 실행하세요. 실패할 경우 확인할 사항도 함께 다룹니다.

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

커버: 커스텀 제공자를 통해 CheapTokens에 연결된 DeepSeek Harness
이 페이지의 내용
  1. 무엇을 연결하는가
  2. Harness를 열기 전에 키를 확인하세요
  3. 커스텀 제공자 양식 작성하기
  4. 모델을 선택하고 첫 작업 실행하기
  5. 저렴한 모델이 에이전트 루프에 맞는 이유
  6. 작동하지 않는다면
  7. 탭을 닫기 전에

DeepSeek Harness를 CheapTokens와 함께 사용하려면 Settings → Models를 열고 카드를 Custom model API로 전환한 뒤, base URL을 https://api.cheaptokens.dev/v1로 설정하고 프로토콜로 OpenAI Chat Completions를 선택한 다음 CheapTokens 키를 붙여넣고 모델 id deepseek-ai/DeepSeek-V4-Flash-0731을 추가하세요. 피커에서 해당 모델을 선택하면 다음 세션이 그 모델로 실행됩니다.

이게 전부입니다. 이 페이지의 나머지는 정확한 양식, 앱을 탓하기 전에 키가 작동하는지 빠르게 확인하는 방법, 그리고 게이트웨이가 거부할 때 살펴볼 항목의 짧은 목록입니다.

아래 설정은 2026년 10월 24일 기준 Harness 문서에서 가져왔습니다. 이 프로젝트는 공개 프리뷰 상태이며, README에서 호환성을 깨뜨리는 변경이 있을 것이라고 경고하므로, 라벨이 옮겨졌다면 화면과 provider guide를 믿으세요.

무엇을 연결하는가#

DeepSeek Harness는 DeepSeek의 오픈소스 에이전트입니다(MIT 라이선스, Cordis 플러그인 아키텍처 기반). Apple 실리콘용 macOS와 Windows 64비트 데스크톱 앱으로, 또는 npx @deepseek-ai/dsh web로 시작하는 웹 UI로 제공됩니다(Node.js 필요). 웹 UI는 기본적으로 http://127.0.0.1:3080에서 열립니다.

기본적으로는 DeepSeek 키를 요구합니다. 하지만 같은 Models 화면에는 카탈로그에 없는 것, 릴레이, 회사 게이트웨이 또는 다른 제공자를 위한 카드가 있습니다. 우리가 사용하는 것이 바로 그 카드입니다.

CheapTokens 쪽에서는 두 가지가 필요합니다: 키와 잔액입니다. 아직 키를 만들지 않았다면 Your first API request with CheapTokens가 몇 분이면 끝나고, What is an API key and how to store it safely에서 어디에 보관할지 다룹니다.

Harness를 열기 전에 키를 확인하세요#

터미널에서 요청 하나를 보내면 키, 잔액, 모델 id가 괜찮은지 알 수 있습니다. 이게 작동하는데 Harness가 작동하지 않는다면, 문제는 계정이 아니라 양식에 있습니다.

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 hi in five words."}]
  }'

choices 배열과 입력 및 출력 토큰을 집계하는 usage 블록이 포함된 JSON 응답을 받아야 합니다. Invalid API key 스타일 오류는 키 문제이고, 잔액에 관한 메시지는 충전이 필요하다는 뜻입니다.

커스텀 제공자 양식 작성하기#

Settings → Models를 열고 제공자 카드를 Custom model API로 전환하세요. 필드를 다음과 같이 채우세요:

Field What to enter
Provider ID cheaptokens (소문자; 나중에 변경할 수 없으니 마음에 드는 이름을 고르세요)
Display name CheapTokens
Base URL https://api.cheaptokens.dev/v1
API protocol OpenAI Chat Completions
Credential your CheapTokens API key
Models deepseek-ai/DeepSeek-V4-Flash-0731

사람들이 두 군데에서 실수합니다. 첫째, base URL은 위 curl에서 /chat/completions을 뺀 https://api.cheaptokens.dev/v1과 정확히 같아야 합니다. 둘째, 모델 id는 deepseek-ai/ 접두사가 붙은 전체 id입니다. deepseek-v4-flash 같은 짧은 이름은 API가 기대하는 것이 아닙니다. base_url에 대한 배경과 전환 방법을 알고 싶다면 OpenAI-compatible API: what base_url is and how to switch를 참고하세요.

Fetch available models 버튼도 있습니다. 문서에 따르면 이 버튼은 GET /models을 조회하며 id를 직접 입력해도 된다고 합니다. 여기서는 직접 입력하는 것이 안전한 방법이니 그렇게 하세요.

Custom model API card in DeepSeek Harness: empty form turns into the filled CheapTokens provider
Illustration: the Custom model API card before and after filling it in

모델을 선택하고 첫 작업 실행하기#

모델 피커를 열고 CheapTokens 모델을 선택하세요. 거기서 모델을 선택하면 새 세션의 기본값이 되므로 반복할 필요가 없습니다.

이제 작고 확인 가능한 작업을 맡기세요. 실패하는 테스트가 있는 프로젝트가 있다고 가정해 봅시다:

text
Run the tests, find why test_parse_date fails and fix it. Show me the diff.

보고 싶은 것: 에이전트가 테스트 명령을 실행하고, 실패한 파일을 읽고, 편집하고, 테스트를 다시 실행하고, diff를 보여줍니다. 그렇게 하면 연결이 완료된 것입니다. 이제 잔액이 이 루프의 비용을 지불합니다.

저렴한 모델이 에이전트 루프에 맞는 이유#

에이전트는 질문 하나를 보내지 않습니다. 매 단계마다 전체 대화, 파일 목록, 도구 출력을 다시 보내므로 세션은 대부분 입력 토큰입니다. 그래서 에이전트 청구서가 놀랍습니다(why a long chat costs more가 메커니즘을 설명하고, How to estimate the cost of an AI agent가 방법을 제시합니다).

세션에 200단계가 있고, 각 단계가 약 30,000 토큰의 컨텍스트를 보내고 약 600 토큰을 돌려받는다고 가정해 봅시다. 그러면 200 × 30,000 = 6,000,000 입력 토큰과 200 × 600 = 120,000 출력 토큰입니다. DeepSeek-V4-Flash에서 이 세션은 오늘 가격으로 $0.102이며, 입력과 출력을 합쳐 계산하면 총액에서 OpenRouter보다 저렴합니다. 아래 표는 우리가 제공하는 모든 모델에 동일한 워크로드를 적용한 것입니다:

모델 비용 OpenRouter
GLM-5.3-Flash $0.125 $0.257
DeepSeek-V4-Flash $0.102 $0.304
MiniMax-M2.7 $0.318 $1.94

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

긴 세션의 경우 DeepSeek-V4-Flash는 380K 컨텍스트 윈도우, 한 답변에 최대 32,768 토큰, 시간대와 무관한 단일 가격을 제공합니다: 피크 시간 할증이 없습니다. 다른 모든 CheapTokens 모델과 같은 잔액을 사용하므로 다시 충전하지 않고도 Harness에서 모델을 전환할 수 있습니다. 현재 요금은 pricing page에 있고, model page에 DeepSeek 라인에 대한 자세한 내용이 있습니다.

세션을 더 가볍게 유지하고 싶다면 zai-org/GLM-5.3-Flash(390K 컨텍스트, 최대 8,192 출력 토큰) 또는 MiniMaxAI/MiniMax-M2.7(180K 컨텍스트, 최대 8,192 출력 토큰)을 같은 제공자에 추가 모델 id로 추가하세요. 하나의 제공자가 여러 모델을 담을 수 있고, 피커에서 이들 사이를 이동할 수 있습니다.

작동하지 않는다면#

Harness 문서에 일반적인 원인들이 나열되어 있습니다. 여기에 무엇을 해야 하는지와 함께 정리했습니다:

  • 키와 URL이 맞는데도 게이트웨이가 모든 요청을 거부합니다. 요청 형태가 엔드포인트가 기대하는 것과 다릅니다. Harness에는 시스템 프롬프트에 사용되는 역할이나 출력 토큰 필드의 이름 같은 모델별 호환성 설정이 있습니다. 이들은 $DSH_HOME/profiles/<profile>/cordis.patch.yml에 있으며 재시작 없이 다시 로드됩니다. 추측하지 말고 provider guide에서 정확한 키를 가져오세요.
  • 직접 입력한 모델에 effort 메뉴가 없습니다. Harness는 추론 수준을 선언한 모델에만 표시합니다. 직접 입력한 모델은 선언된 것이 없으므로 메뉴가 비어 있습니다. 수준 선언은 같은 모델별 설정 파일의 일부입니다.
  • 모델을 가져올 때 401. 키를 확인하거나, 버튼을 건너뛰고 모델 id를 직접 입력하세요.
  • 답변이 문장 중간에 멈춥니다. 이는 토큰 제한이지 연결 문제가 아닙니다. why an AI answer stops mid-sentence를 참고하세요.
  • 첫 요청에서 로그에 401 또는 403. 같은 키로 위의 curl 확인을 반복하세요. curl이 작동하면 Credential 필드에 키를 다시 입력하세요; 끝에 붙은 공백 하나가 전형적인 원인입니다.

같은 키로 다른 에이전트를 이미 사용하고 있다면 connecting OpenCode도 같은 패턴을 따르고, CheapTokens docs에 모든 엔드포인트가 나열되어 있습니다. 같은 서랍에 도구 하나 더, 잔액 하나.

탭을 닫기 전에#

  • Base URL: https://api.cheaptokens.dev/v1
  • Protocol: OpenAI Chat Completions
  • Model id: deepseek-ai/DeepSeek-V4-Flash-0731
  • Key: CheapTokens 계정에서 가져온 것으로, 스크린샷과 저장소에 남기지 마세요

실패하는 테스트 작업을 한 번 실행하고 잔액에서 사용량을 확인하세요. 그 한 번의 실행이 여러분의 세션 비용이 얼마인지 알려줍니다.

태그: