GET /v1/modelsでモデルを一覧し、正確なモデルidを見つける

他人のサンプルでは問題なさそうに見えたモデル名で、あなたのコードが404を返す。API自身に聞いてみよう。https://api.cheaptokens.dev/v1/modelsへのGETリクエスト1回で、呼び出し可能なモデルとそのコンテキスト・出力上限の一覧が返る。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のベースURLの隣に貼り付けるとリクエストが失敗する。キーに問題はない。プロバイダーは同じモデルに異なる名前を付ける。deepseek-ai/のようなプレフィックス、-0731のようなバージョンサフィックス、大文字小文字の違いなどだ。APIは一覧に載っている正確な文字列しか受け付けず、価格ラベルから取った短い名前も動かない。

だからこそ、idを一度調べておく価値がある。間違ったidが画面上でどう見えるかの詳細は、API 401 or 404 error: wrong key, base URL or model idで解説している。このガイドはその前のステップだ。正しいidを見つけて、そのエラーを二度と見ないようにしよう。

APIに聞く：リクエスト1回#

使っているタブを選ぼう。どちらも同じリクエストを送る。両方の例で、キーは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は出力から丸ごとコピーしよう。

3つの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出力トークン。

ほとんどの判断では2つの数値が重要だ。コンテキストはモデルが1回のリクエストで保持できる量で、プロンプトとその回答を合わせたものだ。出力上限は1回の回答の最大長だ。これらの言葉が初めてなら、how to read AI model namesとwhy an answer stops mid-sentenceが平易な言葉で説明している。

タスクに合った最初のモデルを選ぶ#

始めるのに長いベンチマーク調査は不要だ。2つの質問で最初の選択のほとんどは決まる。入力はどれくらい大きいか、回答はどれくらい長くする必要があるか。自分に一番近いケースをクリックしよう。

3つとも残高と価格を共有し、時間帯による変動やピーク時間はないので、後から切り替えても変わるのは文字列1つだけだ。OpenRouterと比べると、3つとも入力と出力を合計した総額で安い。ワークロードの例を見てみよう。2,000入力トークンを送って500トークンを受け取る小さなアシスタントを1日1,000回動かすとする。下のライブテーブルはまさにそれを価格計算している。

全モデルの現在のトークン単価はpricing pageにあり、model pagesでは各モデルをより詳しく扱っている。タスク別の比較が欲しければ、GLM vs DeepSeek vs MiniMax: which model to chooseがある。

上限から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
  }'

初めての呼び出しなら、Your first API request with CheapTokensが回答フォーマットとusageフィールドを扱っている。

手順を定着させるために、ステップを順番に並べよう：

それでもリクエストが失敗する場合#

まず文字列を確認しよう。1文字違うモデルidが404の通常の原因なので、打ち直すのではなく一覧からもう一度貼り付けよう。402は残高切れ、レート制限はAPIキーあたり毎分120リクエストだ。エラーは標準のOpenAI/Anthropic JSON形式で返るので、SDKは通常どおりパースする。詳細な手順はAPI 401 or 404 errorを参照。

APIはhttps://api.cheaptokens.dev/v1でOpenAIおよびAnthropic互換だ。Anthropic SDKとClaude Codeは/v1なしのルートURLhttps://api.cheaptokens.devを使う。セットアップの詳細はdocsにある。