ブログに戻る

ツールと連携ガイド

DeepSeek Harness を CheapTokens に接続する: カスタムプロバイダー

DeepSeek Harness でカスタムの OpenAI 互換プロバイダーを追加し、CheapTokens API を指定して最初のコーディングタスクを実行します。失敗した場合の確認項目も。

投稿者: CheapTokens Team公開日 読了時間 7 分

カバー: カスタムプロバイダー経由で CheapTokens に接続された DeepSeek Harness
このページの内容
  1. 何に接続するのか
  2. Harness を開く前にキーを確認する
  3. カスタムプロバイダーのフォームを入力する
  4. モデルを選んで最初のタスクを実行する
  5. なぜ安いモデルがエージェントループに合うのか
  6. 動かない場合
  7. タブを閉じる前に

DeepSeek Harness を CheapTokens で使うには、Settings → Models を開き、カードを Custom model API に切り替え、ベース URL を https://api.cheaptokens.dev/v1 に設定し、プロトコルとして OpenAI Chat Completions を選び、CheapTokens のキーを貼り付けてモデル ID deepseek-ai/DeepSeek-V4-Flash-0731 を追加します。ピッカーでそのモデルを選択すれば、次のセッションはそれで動きます。

仕掛けはこれだけです。このページの残りは、正確な入力フォーム、アプリを疑う前にキーが動くかを確認する簡単なチェック、そしてゲートウェイが拒否したときに見るべき項目の短いリストです。

以下の設定は 2026 年 10 月 24 日時点の Harness ドキュメントに基づいています。このプロジェクトはパブリックプレビュー中で、README には互換性を壊す変更が起こると警告されているため、ラベルが移動していたら画面とプロバイダーガイドを信頼してください。

何に接続するのか#

DeepSeek Harness は DeepSeek によるオープンソースのエージェントです(MIT ライセンス、Cordis プラグインアーキテクチャ上に構築)。Apple シリコン向け macOS と Windows 64 ビットのデスクトップアプリとして、または npx @deepseek-ai/dsh web で起動する Web UI として提供されます(Node.js が必要)。Web UI はデフォルトで http://127.0.0.1:3080 で開きます。

初期状態では DeepSeek のキーを要求します。しかし同じ Models 画面には、カタログにないもの、リレー、社内ゲートウェイ、別のプロバイダー向けのカードがあります。それを使います。

CheapTokens 側では 2 つ必要です: キーと残高。まだキーを作っていないなら、Your first API request with CheapTokens が数分で済み、What is an API key and how to store it safely が保管場所について説明しています。

Harness を開く前にキーを確認する#

ターミナルからの 1 回のリクエストで、キー、残高、モデル ID が問題ないか分かります。これが動いて Harness が動かないなら、問題はアカウントではなくフォームにあります。

bash
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 hi in five words."}]
  }'

choices 配列と、入力トークンと出力トークンを数える usage ブロックを含む JSON の応答が返るはずです。Invalid API key 形式のエラーはキーを意味し、残高に関するメッセージはチャージが必要という意味です。

カスタムプロバイダーのフォームを入力する#

Settings → Models を開き、プロバイダーカードを Custom model API に切り替えます。フィールドは次のように入力します:

フィールド 入力する内容
Provider ID cheaptokens (小文字。後から変更できないので、好きな名前を選んでください)
Display name CheapTokens
Base URL https://api.cheaptokens.dev/v1
API protocol OpenAI Chat Completions
Credential CheapTokens の API キー
Models deepseek-ai/DeepSeek-V4-Flash-0731

2 つの点でつまずきやすいです。1 つ目、ベース URL は上の curl とまったく同じ https://api.cheaptokens.dev/v1 で、/chat/completions を除いたものです。2 つ目、モデル ID は deepseek-ai/ プレフィックス付きの完全なものです。deepseek-v4-flash のような短い名前は API が期待するものではありません。base_url の背景と切り替え方については、OpenAI-compatible API: what base_url is and how to switch を参照してください。

Fetch available models ボタンもあります。ドキュメントによると GET /models にクエリを送り、ID はいつでも手入力できるとのことです。ここでは手入力が安全な道なので、そうしてください。

Custom model API card in DeepSeek Harness: empty form turns into the filled CheapTokens provider
Illustration: the Custom model API card before and after filling it in

モデルを選んで最初のタスクを実行する#

モデルピッカーを開き、CheapTokens のモデルを選びます。そこでモデルを選ぶと新しいセッションのデフォルトになるので、繰り返す必要はありません。

次に、小さくて確認できるものを与えます。失敗するテストがあるプロジェクトがあるとします:

text
Run the tests, find why test_parse_date fails and fix it. Show me the diff.

期待する動き: エージェントがテストコマンドを実行し、失敗しているファイルを読み、編集し、再度テストを実行して diff を表示します。そうなれば接続は完了です。あとは残高がこのループの支払いを担います。

なぜ安いモデルがエージェントループに合うのか#

エージェントは 1 つの質問を送るのではありません。各ステップで会話全体、ファイル一覧、ツール出力を毎回送り直すため、セッションの大半は入力トークンです。これがエージェントの請求を驚きにする原因です(why a long chat costs more が仕組みを説明し、How to estimate the cost of an AI agent が方法を示しています)。

セッションが 200 ステップあり、各ステップが約 30,000 トークンのコンテキストを送り、約 600 トークンを受け取るとします。これは 200 × 30,000 = 6,000,000 入力トークンと 200 × 600 = 120,000 出力トークンです。DeepSeek-V4-Flash では、今日の価格でこのセッションは $0.102 かかり、入力と出力を合計すると OpenRouter より安くなります。以下の表は、提供するすべてのモデルで同じワークロードを使っています:

モデル コスト OpenRouter
GLM-5.3-Flash $0.125 $0.257
DeepSeek-V4-Flash $0.102 $0.304
MiniMax-M2.7 $0.318 $1.94

合計 6,000,000 入力トークンと 120,000 出力トークン。100万トークンあたりの価格は現行のもので、当社の料金体系に合わせて変動します。OpenRouter 列は同じワークロードの参考価格を示しています。

長いセッションでは、DeepSeek-V4-Flash は 380K のコンテキストウィンドウ、1 回の回答で最大 32,768 トークン、時間帯を問わず同一価格を提供します: ピーク時間の割増はありません。他のすべての CheapTokens モデルと同じ残高を使うので、再度チャージせずに Harness でモデルを切り替えられます。現在の料金は料金ページにあり、モデルページには DeepSeek ラインの詳細があります。

セッションを軽く保ちたいなら、zai-org/GLM-5.3-Flash (390K コンテキスト、最大 8,192 出力トークン)または MiniMaxAI/MiniMax-M2.7 (180K コンテキスト、最大 8,192 出力トークン)を同じプロバイダーに追加のモデル ID として加えてください。1 つのプロバイダーが複数のモデルを保持でき、ピッカーでそれらを行き来できます。

動かない場合#

Harness ドキュメントはよくある原因を挙げています。以下に、やるべきこととともに示します:

  • キーと URL は正しいのにゲートウェイがすべてのリクエストを拒否する。 リクエストの形がエンドポイントの期待と異なります。Harness にはモデルごとの互換性設定があり、システムプロンプトに使うロールや出力トークンフィールドの名前などがあります。それらは $DSH_HOME/profiles/<profile>/cordis.patch.yml にあり、再起動なしで再読み込みされます。推測せず、プロバイダーガイドから正確なキーを取ってください。
  • 入力したモデルで effort メニューが表示されない。 Harness は reasoning レベルを宣言したモデルにのみ表示します。手入力したモデルは何も宣言していないため、メニューは空のままです。レベルの宣言は同じモデルごとの設定ファイルの一部です。
  • モデル取得時に 401。 キーを確認するか、ボタンを飛ばしてモデル ID を自分で入力してください。
  • 回答が途中で止まる。 それはトークン制限であり、接続の破損ではありません。why an AI answer stops mid-sentence を参照してください。
  • 最初のリクエストでログに 401 または 403。 同じキーで上の curl チェックを繰り返してください。curl が動くなら、Credential フィールドにキーを入力し直してください。末尾の余分なスペースは定番です。

すでに同じキーで別のエージェントを使っているなら、connecting OpenCode も同じパターンに従い、CheapTokens docs にすべてのエンドポイントが載っています。同じ引き出しにもう 1 つツール、残高は 1 つ。

タブを閉じる前に#

  • Base URL: https://api.cheaptokens.dev/v1
  • Protocol: OpenAI Chat Completions
  • Model id: deepseek-ai/DeepSeek-V4-Flash-0731
  • Key: CheapTokens アカウントのもの。スクリーンショットやリポジトリに残さない

失敗するテストのタスクを 1 回実行し、残高の使用量を確認してください。その 1 回で、自分のセッションのコストが分かります。

タグ: