ドキュメント

Amp

Amp はサーバー側でモデルにリクエストをルーティングするため、使用しているマシンでベース URL の環境変数を設定する必要はありません。Model Routing に Custom URL 接続を追加すると、Amp のクラウドからエンドポイントが呼び出されます。この機能は有料プラン向けのため、まずプランを確認してください。

AmpのModel RoutingでCustom URL接続を追加 — API formatはchat-completions、base URLはhttps://api.kunavo.com/v1、キーはベアラートークン — オプションがあるティアでは、マッピングしたモデルを1つのキーに移行できます。

Settings → Model Routing → Add → Custom URL

Connection type    Custom URL            (Model Routing → Add)
API format         chat-completions      OpenAI Chat Completions API, the default
Base URL           https://api.kunavo.com/v1
Key                sk-kn-...             sent as Authorization: Bearer <key>
Headers            —                     nothing extra is needed
Query Parameters   —                     nothing extra is needed
Model mapping      anthropic/claude-opus-4-6 -> claude-opus-4-6
                   anthropic/claude-fable-5  -> claude-fable-5
                   openai/gpt-5.6-sol        -> gpt-5-6-sol

Amp のティアを最初に確認してください。 Amp の Model Routing ページには、2026年9月21日時点で「AI モデルルーターとゲートウェイは実験段階の早期アクセス機能であり、Megawatt、Gigawatt、Enterprise のお客様のみご利用いただけます。まもなく全員に提供予定です」と記載されています。Custom URL 接続もその対象のため、Hobby アカウントでは Add メニューに表示されません。Amp は提供開始日を公表しておらず、このページでも予測していません。

Kunavo はこのエンドポイントで Amp を実際に動作させていません。 上記の各項目はすべて Amp 独自のドキュメントから転記したもので、この機能は有料の Amp プランでのみ利用できるため、ここでは誰も実際にセッションを完了していません。Amp の仕様をそのまま記載したものとして扱い、動作するかどうかは アクセスを確認 で確認してください。

chat-completions はベース URL に /v1 サフィックスを含めます。Amp が追加するのはルートだけだからです。Amp の具体例が明確に示しています: 「ベース URL が https://api.example.com/v1 で、chat-completions を指定すると、リクエストは https://api.example.com/v1/chat/completions に送信されます」。同じページには、末尾がすでに /v1 のベース URL も「受け付けられ、二重にはなりません」とあり、接続フォームでは入力中にリクエスト URL が表示されるため、保存前に結合後の URL を確認できます。

Amp の Dictation および Realtime Voice システムモデルは音声機能です。Kunavo は音声テキスト変換モデルもテキスト音声変換モデルも提供していません。この Custom URL 接続ではどちらの機能も提供できないため、それらの行は Amp のままにしてください。

まだキーをお持ちですか？Kunavoアカウントを作成し、キーを作成します（sk-kn-で始まります）。$10からクレジットを追加すると、呼び出しはその残高から支払われ、失敗した呼び出しは課金されません。ダッシュボードを開くと、Amp設定が表示されます。

手順

/app/keys でキーを作成してコピーします。キーは一度だけ表示されます。
個人設定の Model Routing を開きます（ワークスペース管理者は Workspace Model Routing を使うと、すべてのメンバーと 1 つの接続を共有できます）。Add メニューを開き、Custom URL を選択します。
API形式をchat-completionsに設定し、https://api.kunavo.com/v1をベースURLとして貼り付け、キーにはsk-kn-キーを入力します。Ampはどの形式でもこれをAuthorization: Bearer <key>として送信します。Kunavoが認証に使用するヘッダーなので、HeadersとQuery Parametersは空欄のままにします。
モデルマッピングを1行に1パターンずつ記述します。左辺はAmpの正規モデルID、->の後の右辺はKunavoが受け取るIDです。表記は異なります（Ampではopenai/gpt-5.6-solと記述し、Kunavoはgpt-5-6-solというIDを認識します）。そのため、ここでは矢印を省略できません。正規IDを記憶で入力せず、Modelsピッカーから挿入してください。
Check Accessを押します。マッピングが幅広い場合、Ampはエンドポイントのモデル一覧を表示します。マッピングにモデルが1つだけ指定されている場合は、1トークンのリクエストを送信します。続いて、接続一覧の下にあるルーティンググラフで、マッピングしたモデルがKunavoから提供され、マッピングしていないモデルは引き続きAmpと表示されていることを確認します。

Ampのモデルルーティングに関するドキュメントで2026年9月21日に確認しました。サードパーティの設定は変更されます。ここに記載されたフィールド名が表示内容と一致しなくなった場合は、このページではなく、そのページを正しい情報源としてください。

これが短い概要です。完全な手順 — モデルの選択、実際のセッション費用、失敗するケース — はAmp自体の料金と、接続によって請求額が変わる項目・変わらない項目にあります。

クライアントをデバッグする前に確認すること

1回のリクエストで、失敗の原因がエンドポイント、キー、設定ファイルのどれかを特定できます。これがJSONを返すなら、同じベースURLとキーがAmpで機能します。

# Settles whether a failure is the endpoint, the key, or the client.
curl -sS https://api.kunavo.com/v1/models \
  -H "Authorization: Bearer sk-kn-..."

フィールドに入力するモデルID

すべてのテキストモデルにはモデルIDでアクセスできます。現在の一覧はGET /v1/models、価格付きのカタログはモデルページにあります。料金は100万トークンあたりのUSDで、入力 / 出力の順です。

モデル ID	Kunavo 入力 / 出力	Ampでの位置付け
`gpt-5-6-sol`	$2.00 / $12.00	MediumモードのメインエージェントとPuck — Ampのデフォルト作業モデル
`gpt-6-astra`	$4.00 / $20.00	Highモードのメインエージェントと、ほとんどのモードで使われるOracleサブエージェント
`claude-fable-5-1`	$7.00 / $35.00	Ultraモードのメインエージェント。難しい自由形式の作業用に確保されたモデル
`gpt-5-6-terra`	$0.70 / $4.20	Searchサブエージェント — コードベースの検索。利用量がコストを大きく左右します
`claude-haiku-4-5`	$0.70 / $3.50	View Media — 画像、PDF、動画を扱うAmpのモデル。Claudeは画像を読み取りますが、動画は読み取りません

請求は月額料金なしの前払い残高からトークン単位で行われます — 請求を参照してください。繰り返し送られるコンテキスト（エディターやチャットクライアントが送る内容の大半）では、プロンプトキャッシュのほうがモデル選択より請求額を大きく左右します。

接続によって変わらない項目

モデルルーティングが変えるのは、トークンの請求先だけです。Ampのorbコンピュートは分単位で別途計測されるため、接続を設定してもその料金項目は変わりません。また、ウェブ検索などのモデル以外のツールは、モデルのルーティング方法にかかわらずAmpクレジットを消費し続けます。Custom URLオプションを利用可能にするAmpのサブスクリプションも固定費であり、最初のトークンを使う前から発生します。

Ampがデフォルトで実行するモデルのうち、Kunavoが提供していない2つは上の表に含まれていません。Lowモードの背後で使われるGLMモデルと、Read Threadサブエージェントです。接続を設定しても、Ampで設定されている最安の利用経路は再現できないため、*/*をマッピングすると、この2つは通知なくAmp側に残ります。これは正しい動作であり、設定ミスではありません。Amp独自のルールでは、どの接続からも提供されないモデルはAmpが提供します。

よくある質問

AmpでカスタムAPIエンドポイントを使えますか？

はい。Model RoutingのCustom URL接続から利用できますが、すべてのプランで使えるわけではありません。Ampのモデルルーティングに関するドキュメントによると、Custom URLが属するAIモデルルーターとゲートウェイは実験段階で、Megawatt、Gigawatt、Enterpriseの各顧客だけが早期アクセスできます。また、Ampは日付を示さず、近日中に全員へ提供を開始するとしています。2026年9月21日時点ではこの状態でした。HobbyアカウントではAddメニューにこのオプション自体がないため、ベースURLを確認する前に、まずプランを確認してください。

AmpのベースURLの末尾に/v1を付ける必要がありますか？

選択したAPI形式によって異なります。この項目はよく誤解されます。chat-completionsの場合、Ampが追加するのは/chat/completionsだけなので、ベースURLは/v1までのルートである必要があります。Ampの公式ドキュメントの例では、https://api.example.com/v1がhttps://api.example.com/v1/chat/completionsになります。anthropic-messagesの場合、Ampが代わりに/v1/messagesを追加するため、ここではオリジンのみを指定します。またAmpによると、末尾にすでに/v1が付いたベースURLも受け付けられ、/v1が二重に追加されることはありません。接続フォームには入力中の結合後のリクエストURLが表示されるので、保存前に確認できます。

カスタムエンドポイント用のAPIキーはAmpのどこに保存されますか？

お使いのマシンではなく、Ampのサーバー上です。Ampは自社のクラウドから推論を仲介するため、Custom URL接続はローカル設定ファイルや環境変数ではなく、アカウント設定のModel Routingで構成します。また、指定するエンドポイントはAmpのインフラから到達可能である必要があります。Ampは3種類すべてのAPI形式で、認証情報をAuthorization: Bearerヘッダーとして送信します。Ampが公開しているCLI設定リファレンスにはベースURL設定もAPIキー設定もありません。これはクライアント側から見ても同じことを示しています。

接続を追加してもAmpが自社モデルを使うのはなぜですか？

接続から提供されるのはマッピングに含まれるモデルだけで、それ以外はAmpが提供するためです。次の3点を順に確認してください。接続が有効か、優先順位リストのどこにあるか（個人の接続、ワークスペース、Ampの順で、priority 0が最初に試されます）、そしてモデルマッピングが実際にモードで実行されるモデルと一致しているかです。接続一覧の下にあるルーティンググラフには、各モデルをどの接続が提供しているかが表示されます。また、amp config model-providers check-access --provider-modelを実行すると、短い推論リクエストを1回行い、実際にどの接続から提供されたかを報告します。

KunavoはAmpをエンドポイントに接続してテストしましたか？

いいえ。KunavoはAmpの実行時テストを行っていません。このページは2026年9月21日時点で読んだAmp自身のModel Routingドキュメントを転記したもので、完了したセッションの報告ではありません。Custom URL機能は有料のAmpプランに限定されているため、ここに記載した項目は実行中のクライアントではなく、Ampが公開している仕様と照合しました。AmpのCheck Accessボタンはプロバイダーに対して認証情報を検証するもので、そのテスト結果が判断の基準となります。このページの項目名がAmpの画面に表示されているものと一致しなくなった場合は、Ampのページを正としてください。