Claude visitors: new accounts receive $1.00 in bonus API credit within 30 days. One per person; usage credits only.

DEEPSEEK HARNESS + RUNAPI

DeepSeek Harness で RunAPI を使う。

dsh に RunAPI を Custom model API として追加し、OpenAI Chat Completions の接続先を https://runapi.ai/v1 に設定。Web UI またはヘッドレス実行で gpt-5.4-nano とチャットできます。

dsh 0.2.1-rc.2 とローカルスタブで確認済み · 上流プロバイダーへの有料呼び出しなし
- id: llm-pi-ai
  config:
    providers:
      runapi:
        apiKeyEnv: RUNAPI_API_KEY
        api: openai-completions
        baseURL: https://runapi.ai/v1
        models:
          - id: gpt-5.4-nano
- id: agent-default-model
  config:
    provider: runapi
    model: gpt-5.4-nano
export RUNAPI_API_KEY="runapi_xxx"
npx @deepseek-ai/[email protected] --version
npx @deepseek-ai/[email protected] headless --patch runapi.patch.yml "Reply with one short sentence."
npx @deepseek-ai/[email protected] web --patch runapi.patch.yml
dsh 0.2.1-rc.2 で確認済み/v1
対象範囲

1 つのモデルで、1 回のテキストチャット

目的

DeepSeek Harness のユーザーが、専用のプロバイダープラグインを使わずに、独自のベース URL と API キーでチャットリクエストを RunAPI 経由にできるようにします。

最小限の動作構成

runapi という名前の Custom model API プロバイダー 1 つ、gpt-5.4-nano モデル 1 つ、そして返信を受け取るテキストメッセージ 1 件です。

固定バージョン

設定とコマンドは @deepseek-ai/dsh 0.2.1-rc.2 で確認しました。新しいリリースを自分で確認するまでは、npx でこのバージョンを指定してください。

有料呼び出しを伴わない確認

dsh の読み込み、リクエスト形式、返信、エラーメッセージは、RunAPI エンドポイントのローカルスタブに対して確認しました。このページのために上流プロバイダーへの有料リクエストは行っていません。

セットアップ

3 ステップで dsh を RunAPI に接続

1

RunAPI キーをエクスポートする

dsh を起動するシェルで RUNAPI_API_KEY を設定します。パッチは環境変数からキーを読み取るため、キーがファイルに保存されることはありません。

export RUNAPI_API_KEY="runapi_xxx"
2

Custom model API を追加する

--patch 用に runapi.patch.yml を保存するか、Settings → Models → Add model provider → Custom model API で値を追加します。UI は独自のプロファイルを保存し、キーは認証情報ストレージに保存します。--patch を使うと、Settings の該当フィールドは読み取り専用になります。

api: openai-completions
3

テキストメッセージを 1 件送信する

パッチを指定してヘッドレスタスクを 1 回実行するか、Web UI を開きます。UI ではチャット前にモデルピッカーで runapi/gpt-5.4-nano を選択してください。ターミナルまたはチャットに返信が表示されれば、dsh から RunAPI に到達しています。

npx @deepseek-ai/[email protected] headless --patch runapi.patch.yml "Reply with one short sentence."
リファレンス

Custom model API の設定項目

項目 値 用途
プロバイダー ID runapi セッション、デフォルト設定、認証情報の参照に使用する固定 ID です。
ベース URL https://runapi.ai/v1 RunAPI の OpenAI 互換エンドポイントにリクエストを送信します。
API プロトコル openai-completions RunAPI が /v1/chat/completions で提供する OpenAI Chat Completions です。
認証情報 RUNAPI_API_KEY apiKeyEnv で環境変数から読み取るか、Models ページから保存します。
モデル gpt-5.4-nano RunAPI カタログにある低コストの同期テキストモデルです。
チャット確認

dsh を使う前にキーとモデルを確認

この同期リクエストはパッチと同じベース URL、キー、モデルを使用し、返信を最大 64 トークンに制限します。メッセージが返る場合、dsh の失敗原因は RunAPI アカウントではなく dsh の設定にあります。

curl https://runapi.ai/v1/chat/completions \
  -H "Authorization: Bearer $RUNAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "gpt-5.4-nano", "max_tokens": 64, "messages": [{"role": "user", "content": "Reply with one short sentence."}]}'
トラブルシューティング

DeepSeek Harness のエラー

dsh が MISSING_CREDENTIAL で停止します。何が不足していますか?

dsh を起動したシェルで RUNAPI_API_KEY が設定されていません。エクスポートするか Models ページでキーを保存し、同じコマンドをもう一度実行してください。

dsh に 404 または接続エラーが表示されます。ベース URL が間違っていますか?

通常はその可能性があります。ベース URL は正確に https://runapi.ai/v1 とする必要があり、/chat/completions は dsh が自動で追加します。接続エラーは、ホスト自体に到達できなかったことを意味します。

正しい URL でも dsh に 404 Resource not found が表示されます。何を確認すべきですか?

RunAPI のモデルカタログで gpt-5.4-nano などのモデル ID を確認し、agent-default-model が対応するプロバイダー runapi とモデル ID を使用していることを確認してください。

RunAPI 専用のプロバイダープラグインは必要ですか?

いいえ。dsh は OpenAI Chat Completions 向けの Custom model API に対応しており、RunAPI はそのプロトコルを提供しているため、テキストチャットにはパッチだけで十分です。

dsh 用の RunAPI キーを取得。

RunAPI アカウントを作成またはログインし、API キーを作成して、dsh を起動する前に RUNAPI_API_KEY としてエクスポートしてください。