GET /v1/models로 모델을 나열하여 정확한 모델 id 찾기

다른 사람의 예제에서는 멀쩡해 보였던 모델 이름에 대해 코드가 404를 반환합니다. API 자체에 물어보세요. https://api.cheaptokens.dev/v1/models로 보내는 GET 요청 하나면 호출 가능한 모델 목록을 컨텍스트 및 출력 한도와 함께 보여줍니다. 기억이 아니라 그 응답에서 id를 복사하고, max_tokens를 설정하기 전에 한도를 확인하세요.

문서 페이지(CheapTokens docs, 2026년 10월 28일 확인)는 GET /v1/models를 컨텍스트 및 출력 한도와 함께 호출 가능한 모델 목록으로 설명합니다. 그 옆에는 단일 모델용 GET /v1/models/{model}와 GET /v1/capabilities가 있습니다. 채팅 자체는 POST /v1/chat/completions(OpenAI 호환) 또는 POST /v1/messages(Anthropic 호환)을 통해 이루어집니다.

같은 모델인데 어디서나 id가 다른 이유#

다른 제공자의 튜토리얼을 찾았다고 해봅시다. 그 튜토리얼은 model: "deepseek-chat"를 사용하는데, 이를 CheapTokens base URL 옆에 붙여 넣으면 요청이 실패합니다. 키에는 아무 문제가 없습니다. 제공자마다 같은 모델을 다르게 부릅니다. deepseek-ai/ 같은 접두사, -0731 같은 버전 접미사, 대소문자 차이 등입니다. API는 자신이 나열한 정확한 문자열만 받아들이며, 가격 라벨에서 가져온 짧은 이름도 작동하지 않습니다.

이것이 id를 한 번 조회해야 하는 이유의 전부입니다. 잘못된 id가 화면에 어떻게 나타나는지 전체 이야기를 보고 싶다면 API 401 또는 404 오류: 잘못된 키, base URL 또는 모델 id에서 자세히 다룹니다. 이 가이드는 그 전 단계입니다. 올바른 id를 찾아 그 오류를 아예 보지 않도록 하세요.

API에 물어보기: 요청 하나#

사용하는 탭을 선택하세요. 둘 다 같은 요청을 보냅니다. 두 예제 모두 키는 CHEAPTOKENS_API_KEY 환경 변수에서 가져옵니다(잔액에 자금이 있으면 키는 dashboard에 있습니다).

export CHEAPTOKENS_API_KEY="sk-your-key"

curl https://api.cheaptokens.dev/v1/models \
  -H "Authorization: Bearer $CHEAPTOKENS_API_KEY"

import json
import os

import requests

resp = requests.get(
    "https://api.cheaptokens.dev/v1/models",
    headers={"Authorization": f"Bearer {os.environ['CHEAPTOKENS_API_KEY']}"},
    timeout=30,
)
resp.raise_for_status()
print(json.dumps(resp.json(), indent=2))

Python 버전은 의도적으로 원시 JSON을 출력합니다. 직접 한 번 읽어보세요. 모델 id와 그 옆의 컨텍스트 및 출력 한도를 찾고 있습니다. 출력에서 각 id를 전체 그대로 복사하세요.

세 가지 id와 그 한도#

문서에는 다음 호출 가능 모델이 나열되어 있습니다(2026년 10월 28일 확인). 각 줄 시작 부분의 코드 형식 문자열을 model로 보내세요:

• zai-org/GLM-5.3-Flash — 390K 컨텍스트, 최대 8,192 출력 토큰.
• deepseek-ai/DeepSeek-V4-Flash-0731 — 380K 컨텍스트, 최대 32,768 출력 토큰.
• MiniMaxAI/MiniMax-M2.7 — 180K 컨텍스트, 최대 8,192 출력 토큰.

대부분의 결정에는 두 숫자가 중요합니다. 컨텍스트는 모델이 한 요청에서 담을 수 있는 양으로, 프롬프트와 답변을 합친 것입니다. 출력 한도는 단일 답변의 최대 길이입니다. 이 용어가 생소하다면 AI 모델 이름 읽는 방법과 답변이 문장 중간에 멈추는 이유에서 쉬운 말로 설명합니다.

작업에 맞는 첫 모델 선택하기#

시작하는 데 긴 벤치마크 연구는 필요 없습니다. 두 가지 질문이 대부분의 첫 선택을 결정합니다. 입력이 얼마나 큰가, 답변이 얼마나 길어야 하는가? 자신과 가장 가까운 사례를 클릭하세요.

세 모델 모두 하나의 잔액과 하루 중 언제든 동일한 가격을 공유하며 피크 시간이 없으므로, 나중에 전환하는 데는 문자열 하나만 바꾸면 됩니다. OpenRouter와 비교하면 세 모델 모두 입력과 출력을 합산한 총액이 더 저렴합니다. 워크로드 예시를 들어보면, 2,000 입력 토큰을 보내고 500을 돌려받는 작은 어시스턴트를 하루에 1,000번 실행한다고 가정해 봅시다. 아래 라이브 표가 바로 그것의 가격을 보여줍니다.

모든 모델의 현재 토큰당 가격은 pricing page에 있으며, model pages에서 각 모델을 더 깊이 다룹니다. 작업별 비교를 원한다면 GLM vs DeepSeek vs MiniMax: 어떤 모델을 선택할까가 있습니다.

한도에서 max_tokens를 설정한 후 요청 보내기#

흔한 실수: 한도가 8,192인 모델에 긴 보고서를 요청하면 답변이 중간에 멈춥니다. 목록에서 본 한도는 max_tokens의 상한입니다. 그 이하로 유지하세요.

다음은 목록에서 가져온 전체 id를 사용한 요청입니다. 허용하는 모델에 긴 답변을 요청합니다:

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": "Write a 1,500-word guide to API keys."}],
    "max_tokens": 4000
  }'

첫 호출이 처음인가요? CheapTokens로 첫 API 요청하기에서 응답 형식과 usage 필드를 다룹니다.

루틴을 확립하려면 단계를 순서대로 나열하세요:

요청이 여전히 실패한다면#

문자열부터 확인하세요. 한 글자만 다른 모델 id가 404의 흔한 원인이므로, 다시 입력하지 말고 목록에서 다시 붙여 넣으세요. 402는 잔액이 소진되었음을 의미하고, 속도 제한은 API 키당 분당 120 요청입니다. 오류는 표준 OpenAI/Anthropic JSON 형태로 반환되므로 SDK가 평소처럼 파싱합니다. 전체 안내는 API 401 또는 404 오류를 참조하세요.

API는 https://api.cheaptokens.dev/v1에서 OpenAI 및 Anthropic과 호환됩니다. Anthropic SDK와 Claude Code는 /v1 없이 루트 URL https://api.cheaptokens.dev를 사용합니다. 더 많은 설정 세부 사항은 docs에 있습니다.