CheapTokens ではじめる最初の API リクエスト

このガイドでは、新しいアカウントから実際に動くリクエストまでを案内します。必要なものはメールアドレス、少額の残高、そしてターミナルです。API は OpenAI 互換なので、OpenAI を呼び出したことがあれば変わるのは 2 点だけです。ベース URL とキーです。

必要なもの#

• アカウント。 登録はメールで行います — パスワードは不要で、サインインリンクをお送りします。
• 残高。 サブスクリプションはありません。USD の残高をチャージし、各リクエストはモデルの固定レートでトークン単位で課金されます。
• API キー をダッシュボードから取得します。

ステップ 1. アカウントを作成してチャージする#

サインアップページを開き、メールアドレスを入力して、メール内のリンクをたどってください。ダッシュボードで Top up を押し、支払い方法を選択します:

• 暗号通貨 — $5 から。5% の入金手数料がかかります。
• カード — パートナー経由で、パートナーが独自の手数料を請求します。

ステップ 2. API キーをコピーする#

残高がゼロを超えると(チャージまたは紹介ボーナスの後)、ダッシュボードが 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 — 出力。この 2 つの数値がリクエストの課金対象です。

Python#

公式 SDK を pip install openai でインストールし、ベース 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 はパスとヘッダーを自動的に追加するため、ベース URL とキーを設定するだけで済みます。

問題が発生した場合#

• 401 Invalid API key — キーの入力ミスか、ローテーション済みです。全体を貼り付けたか確認してください。ダッシュボードはキーを一度しか表示しないため、紛失した場合は Rotate を押して新しいキーを取得してください。
• 402 — 残高が使い果たされているか、リクエストが Authorization ヘッダーなしで送信されました。
• 400 Model "…" not found — /v1/models から完全なモデル ID を使用し、スラッシュの前のプレフィックスを含めてください。
• 404 — アドレスを確認してください: OpenAI スタイルのクライアントでは、ベース URL の末尾に /v1 が必要です。

その他のケースと修正方法: よくある接続エラーとその修正方法。

料金#

各リクエストは入力トークンと出力トークンに対して個別に、モデルの 100 万トークンあたりのレートで課金されます。現在の価格 — 料金ページと同じデータ:

次のステップ: コーディングエージェントを接続する（例: Cline）か、AI エージェントのコスト見積もり方法を学びましょう。

CheapTokensをほかの開発者に勧めていますか？紹介プログラムでは、その人たちのチャージ額の一定割合を受け取れます。