CheapTokens로 첫 API 요청 보내기

이 가이드는 새 계정에서 작동하는 요청까지 안내합니다. 이메일 주소, 약간의 잔액, 터미널만 있으면 됩니다. API는 OpenAI 호환 방식이므로, 이전에 OpenAI를 호출해 본 적이 있다면 바뀌는 것은 두 가지뿐입니다: base URL과 키입니다.

필요한 것#

• 계정. 이메일로 가입합니다 — 비밀번호는 없고, 로그인 링크를 보내드립니다.
• 잔액. 구독은 없습니다: USD 잔액을 충전하면 모든 요청이 모델의 고정 요율로 토큰당 과금됩니다.
• API 키 — 대시보드에서 발급받습니다.

1단계. 계정 생성 및 충전#

가입 페이지를 열고 이메일을 입력한 뒤 메일의 링크를 따라가세요. 대시보드에서 Top up을 누르고 결제 방법을 선택합니다:

• 암호화폐 — $5부터, 5% 입금 수수료가 부과됩니다.
• 카드 — 파트너사를 통해 결제하며, 해당 파트너가 자체 수수료를 부과합니다.

2단계. API 키 복사#

잔액이 0보다 많아지면(충전 또는 추천 보너스 후) 대시보드가 API 키를 생성해 한 번만 보여 줍니다. 즉시 복사하고 코드에 넣지 마세요. 예를 들어 환경 변수에 보관합니다:

export CHEAPTOKENS_API_KEY="paste-your-key-here"

키가 유출되면 Rotate를 누르세요: 새 키를 받고 기존 키는 작동을 멈춥니다.

3단계. 모델 선택#

요청에는 전체 모델 ID가 필요합니다 — 슬래시 앞의 접두사를 포함해 API가 나열하는 그대로여야 합니다. 작성 시점(2026년 10월)의 카탈로그:

카탈로그는 변경될 수 있으므로 기준은 API 자체입니다. 이 요청에는 키가 필요하지 않습니다:

curl https://api.cheaptokens.dev/v1/models

4단계. 요청 보내기#

curl#

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 hello in three languages"}]
  }'

성공한 응답은 표준 Chat Completions 형식으로 돌아옵니다. 축약한 예시입니다 — 텍스트, ID, 숫자는 다를 수 있고 응답에는 추가 서비스 필드가 포함될 수 있습니다:

{
  "id": "chatcmpl-…",
  "object": "chat.completion",
  "model": "deepseek-ai/DeepSeek-V4-Flash-0731",
  "choices": [
    {
      "index": 0,
      "message": { "role": "assistant", "content": "Hello! Hola! Bonjour!" },
      "finish_reason": "stop"
    }
  ],
  "usage": { "prompt_tokens": 14, "completion_tokens": 9, "total_tokens": 23 }
}

• 텍스트는 choices[0].message.content에 있습니다.
• 토큰 사용량은 usage에 있습니다: prompt_tokens — 입력, completion_tokens — 출력. 이 두 숫자가 요청에 과금되는 대상입니다.

Python#

공식 SDK를 pip install openai로 설치하고 base URL을 저희 주소로 지정하세요:

import os
from openai import OpenAI

client = OpenAI(
    base_url="https://api.cheaptokens.dev/v1",
    api_key=os.environ["CHEAPTOKENS_API_KEY"],
)
resp = client.chat.completions.create(
    model="deepseek-ai/DeepSeek-V4-Flash-0731",
    messages=[{"role": "user", "content": "Say hello in three languages"}],
)
print(resp.choices[0].message.content)
print("tokens in/out:", resp.usage.prompt_tokens, resp.usage.completion_tokens)

JavaScript#

SDK를 npm install openai로 설치하세요:

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://api.cheaptokens.dev/v1",
  apiKey: process.env.CHEAPTOKENS_API_KEY,
});
const resp = await client.chat.completions.create({
  model: "deepseek-ai/DeepSeek-V4-Flash-0731",
  messages: [{ role: "user", content: "Say hello in three languages" }],
});
console.log(resp.choices[0].message.content);

Anthropic 스타일 클라이언트#

Anthropic Messages API용으로 만들어진 클라이언트는 /v1 없이 루트 주소를 사용하며 — https://api.cheaptokens.dev — 키를 x-api-key 헤더로 보냅니다. Anthropic SDK는 경로와 헤더를 스스로 추가하므로, base URL과 키만 설정하면 됩니다.

문제가 생겼을 때#

• 401 Invalid API key — 키를 잘못 입력했거나 로테이션되었습니다. 전체를 붙여넣었는지 확인하세요. 대시보드는 키를 한 번만 표시하므로 분실했다면 Rotate를 눌러 새 키를 받으세요.
• 402 — 잔액이 소진되었거나, Authorization 헤더 없이 요청이 나갔습니다.
• 400 Model "…" not found — /v1/models의 전체 모델 ID를 슬래시 앞의 접두사까지 포함해 사용하세요.
• 404 — 주소를 확인하세요: OpenAI 스타일 클라이언트는 base URL 끝에 /v1가 필요합니다.

더 많은 사례와 해결 방법: 흔한 연결 오류와 해결 방법.

비용#

각 요청은 입력 토큰과 출력 토큰에 대해 각각 모델의 백만 토큰당 요율로 과금됩니다. 현재 가격 — 가격 페이지와 동일한 데이터:

다음 단계: 코딩 에이전트를 연결하거나, 예를 들어 Cline, AI 에이전트의 비용을 추정하는 방법을 알아보세요.

다른 개발자에게 CheapTokens를 추천하시나요? 추천 프로그램에서는 그들의 충전액 중 일정 비율을 받습니다.