자체 API 키를 어디에 연결할까: 채팅, 에디터, 터미널, 코드

작업에 맞는 곳에 키를 붙여넣으세요. 모델과 대화만 하고 싶다면 브라우저 채팅(Open WebUI), VS Code에서 코딩한다면 에디터 확장(Cline, Kilo Code), 셸에서 산다면 터미널 도구(Aider, OpenCode), 직접 무언가를 만든다면 열 줄짜리 스크립트면 됩니다. 모두 같은 세 가지를 받습니다: 주소, 키, 모델 id.

잔액을 충전했고, 키도 받았고, 이제 어딘가의 텍스트 필드가 키를 요구하고 있습니다. 어느 필드일까요? 다음에 무엇을 할지에 달려 있으니, 거기서부터 시작하세요.

모든 도구가 요구하는 세 가지#

도구가 어떻게 생겼든, 설정 화면은 같은 세 가지를 원합니다:

• Base URL: https://api.cheaptokens.dev/v1 (도구가 기본 주소 대신 이 주소와 통신합니다). 이 단어가 낯설다면 base_url이 무엇이고 어떻게 바꾸는지는 3분이면 됩니다.
• API key: 계정에서 받은 비밀 문자열입니다. 비밀번호처럼 다루세요. 안전하게 보관하는 방법.
• Model id: 전체 이름, 예를 들어 deepseek-ai/DeepSeek-V4-Flash-0731. 가격표의 짧은 별명은 API가 받지 않으므로 문서에서 전체 id를 복사하세요.

CheapTokens API는 OpenAI Chat Completions와 Anthropic Messages를 지원하므로, 두 계열 중 하나에 커스텀 base URL을 설정할 수 있는 도구라면 연결할 수 있고, 아래 가이드가 이를 다룹니다. 하나의 잔액으로 모든 모델을 커버합니다.

작업별로 고르기#

지금부터 5분 뒤 화면에 무엇이 보이길 원하는지 자문해 보세요.

Claude Code에 대한 짧은 참고: Anthropic 형식을 사용하므로 주소는 /v1 없이 https://api.cheaptokens.dev입니다. 정확한 변수는 해당 가이드에 있습니다.

처음이라면: 채팅부터 시작#

API를 한 번도 다뤄본 적이 없고 키가 작동하는지만 확인하고 싶다고 해봅시다. Open WebUI가 가장 부드러운 시작입니다. 이미 아는 채팅처럼 보이고, 키는 설정 필드 하나에 들어갑니다. 짧은 질문을 던지고 답을 보면 잔액, 키, 모델이 제대로 연결되었다는 증거를 얻은 것입니다. 그다음 필요할 때 에디터나 터미널로 넘어가세요.

이런 채팅에는 MiniMax-M2.7(180K 컨텍스트, 답변당 최대 8,192 출력 토큰)이 짧고 잦은 질문에 가벼운 선택입니다.

코딩한다면: 에디터인가 터미널인가?#

이것은 대부분 당신의 손이 이미 어디에 있는지의 문제입니다.

VS Code에서 Cline과 Kilo Code는 사이드 패널에 자리 잡고 프로젝트 파일을 다루는 확장입니다. 프로바이더 설정을 열고 OpenAI 호환 프로바이더를 선택한 뒤 위의 세 값을 붙여넣으세요.

셸에서 Aider와 OpenCode는 터미널에서 저장소를 다룹니다. OpenCode는 opencode.json 파일로, Aider는 환경 변수나 설정으로 구성하며, 두 가이드 모두 정확한 줄을 보여줍니다.

이 도구들에서는 인터페이스보다 모델이 더 중요합니다. 에이전트 루프가 여러 단계를 돌 수 있기 때문입니다. DeepSeek-V4-Flash(380K 컨텍스트, 답변당 최대 32,768 출력 토큰, 피크 요금 없는 시간대 무관 단일 가격)가 여기서 좋은 기본값입니다. 긴 편집을 위한 여유가 있습니다.

코드를 작성한다면: 도구는 건너뛰기#

가장 짧은 길은 도구를 아예 쓰지 않는 것입니다. 키를 환경 변수에 설정하고 요청 하나를 보내세요:

export CHEAPTOKENS_API_KEY="sk-your-key"

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

응답은 JSON 객체입니다. 텍스트는 choices[0].message.content에 있고, usage 필드는 요청이 사용한 입력 및 출력 토큰 수를 보여줍니다. Python, Node, 스트리밍 형태의 같은 호출은 첫 요청에 있습니다.

시도하는 데 드는 비용#

채팅 메시지나 에디터 요청은 작습니다. 전형적인 하나를 가정해 봅시다: 입력 2,000 토큰(질문과 도구가 보내는 파일 또는 기록)과 출력 500 토큰, 100회. 실시간 표는 다음과 같습니다:

MiniMax-M2.7에서 이런 요청 하나는 $0.00018입니다. 이 워크로드에서는 입력과 출력을 합산했을 때 총액이 OpenRouter보다 저렴합니다. 가격은 모델별로 고정이며 피크 시간이 없습니다. 전체 가격표는 가격 페이지에 있습니다.

GLM-5.3-Flash도 같은 도구에서 사용할 수 있습니다(390K 컨텍스트, 최대 8,192 출력 토큰, OpenRouter보다 낮은 출력 가격). 따라서 설정에서 모델 id만 바꿔 모델을 전환할 수 있습니다(전체 id는 문서에서 가져오세요).

작동하지 않는다면#

첫 실행 실패는 대부분 세 곳에서 나옵니다:

• 도구가 여전히 기본 주소와 통신합니다. base URL 필드에 https://api.cheaptokens.dev/v1이 들어 있는지, 그리고 다른 용도의 필드에 붙여넣지 않았는지 확인하세요.
• 모델 id가 짧은 별명입니다. 전체 deepseek-ai/DeepSeek-V4-Flash-0731 형식을 사용하세요.
• 복사 과정에서 키에 공백이나 줄바꿈이 섞였습니다. 다시 붙여넣으세요.

401이나 429 같은 오류 문구는 일반적인 연결 오류를 참고하세요.

더 많은 도구를 찾으려면#

위에 나온 것보다 훨씬 많은 도구가 있습니다. 커뮤니티 카탈로그 Awesome AI DevTools RU(2026년 10월 23일 확인)는 BYOK(자체 키 사용), MCP, 로컬 모델, 오픈 소스 같은 라벨과 함께 20개 카테고리에 281개 도구를 나열하므로 둘러보기 좋은 곳입니다. 여기서 도구를 고르기 전에 해당 도구의 문서를 열어 커스텀 base URL이나 OpenAI 호환 프로바이더 설정이 있는지 확인하세요. 그것이 바로 당신의 키로 작동하게 해주는 것입니다.

시작할 준비가 되셨나요? 문서를 열고 base URL과 모델 id를 복사한 뒤, 작업에 맞는 표의 행을 고르세요.