CheapTokens와 함께하는 Anthropic Python SDK: Messages API

코드가 이미 Anthropic Python SDK를 사용하고 있다면, 다른 모델을 호출하기 위해 코드를 다시 작성할 필요가 없습니다. CheapTokens는 Anthropic Messages API를 지원하므로, 클라이언트 설정만 변경하고 client.messages.create(...)는 그대로 두면 됩니다. 이 가이드는 빈 폴더에서 시작해 답변을 출력하는 스크립트까지 안내합니다.

필요한 것#

• Python 3.10 이상 (SDK의 요구 사항).
• CheapTokens API 키. 아직 없다면 "API 키란 무엇이며 안전하게 저장하는 방법"을 참고하세요.
• 하나의 잔액으로 모든 모델을 사용할 수 있고 피크 시간이 없으므로, 같은 스크립트는 하루 중 언제 실행해도 동일한 비용이 듭니다.

SDK 설치#

pip install anthropic
export CHEAPTOKENS_API_KEY="your-key"

키는 소스 파일이 아니라 환경 변수에 보관하세요.

클라이언트 생성#

기본 Anthropic 설정과 다른 점은 두 가지입니다: 키와 base_url입니다.

import os
import anthropic

client = anthropic.Anthropic(
    api_key=os.environ["CHEAPTOKENS_API_KEY"],
    base_url="https://api.cheaptokens.dev",
)

SDK가 /v1/messages 경로를 자체적으로 추가하므로, base_url는 /v1가 없는 호스트입니다. (OpenAI 스타일 엔드포인트인 https://api.cheaptokens.dev/v1은 OpenAI SDK와 함께 사용하는 것이며, "CheapTokens로 첫 API 요청하기"를 참고하세요.)

첫 요청#

message = client.messages.create(
    model="deepseek-ai/DeepSeek-V4-Flash-0731",
    max_tokens=1024,
    messages=[
        {"role": "user", "content": "Explain what a token is in two sentences."}
    ],
)

print(message.content[0].text)
print(message.stop_reason, message.usage.input_tokens, message.usage.output_tokens)

모델 id는 CheapTokens 문서에서 가져오세요. id는 제공자마다 다릅니다. 여기서는 DeepSeek-V4-Flash를 사용합니다: 380K 컨텍스트 윈도우와 한 답변에 최대 32,768 토큰으로, 긴 답변이나 에이전트 루프에 적합합니다.

응답은 message.content에 있으며 블록의 리스트입니다. 텍스트는 첫 번째 블록에 있습니다. usage는 호출이 사용한 입력 및 출력 토큰 수를 보여주며, 이에 대해 과금됩니다.

max_tokens는 필수입니다#

OpenAI API와 달리 messages.create는 max_tokens 없이는 실행되지 않습니다. 이는 답변의 길이를 제한합니다:

• 너무 낮으면 답변이 잘립니다. 이때 message.stop_reason는 "end_turn" 대신 "max_tokens"가 됩니다.
• DeepSeek-V4-Flash의 경우 전체 파일이나 보고서 같은 긴 답변을 위해 최대 32,768까지 설정할 수 있습니다.
• 설정한 한도가 아니라 실제로 생성된 토큰에 대해서만 비용을 지불합니다.

답변이 문장 중간에 멈추면, 자세한 설명은 "AI 답변이 문장 중간에 멈추는 이유는?"을 참고하세요.

모델 전환#

model 문자열만 변경하면 되고, 스크립트의 나머지는 그대로 유지됩니다. 작업에 따라 선택하세요:

• DeepSeek-V4-Flash: 긴 답변과 에이전트 루프, 시간대와 관계없이 동일한 가격, 최대 32,768 출력 토큰.
• GLM-5.3-Flash: 저렴한 일상 채팅 및 코딩 호출, 390K 컨텍스트, 최대 8,192 출력 토큰.
• MiniMax-M2.7: 저비용 에이전트 및 코딩 작업, 180K 컨텍스트, 최대 8,192 출력 토큰.

사용 가능한 id 목록은 GET https://api.cheaptokens.dev/v1/models에서 반환되며, 예를 들어 zai-org/GLM-5.3-Flash 및 MiniMaxAI/MiniMax-M2.7가 있습니다.

MiniMax-M2.7의 1M 토큰당 현재 가격은 입력 $0.05, 출력 $0.15입니다. MiniMax-M2.7은 입력과 출력을 합산한 총액 기준으로 OpenRouter보다 저렴합니다. 다음은 2,000 입력 및 500 출력 토큰의 요청이 각 모델에서 비용이 얼마인지 가격 목록에서 실시간으로 보여줍니다:

GLM-5.3-Flash와 MiniMax-M2.7은 입력과 출력을 합산한 총액 기준으로 OpenRouter보다 저렴합니다.

다음 단계#

키를 생성하고 첫 요청 섹션의 스크립트를 실행하세요. 답변이 출력되면 model 문자열을 바꿔 자신의 작업에서 모델을 비교해 보세요.