メインコンテンツまでスキップ

公式プラットフォームの API キー

BYOK は、自分のベンダーアカウントと API キーでモデルに接続する方法です。キーは Mystilink のローカルに設定し、利用量は該当ベンダーが課金します。Mystilink のアカウントと残高を使いたい場合は Newton LLM を参照してください。ここに第三者のキーを追加する必要はありません。

先に用意する三つの情報​

  1. API キー:実際に API を提供するベンダーの開発者プラットフォームで発行します。Web のログインパスワード、Mystilink の認証キー、チャット製品のログイン資格情報を入れないでください。
  2. モデル ID:現在の API アカウントが利用を許されている識別子です。表示名がそのままリクエストの ID とは限りません。
  3. API の権限と残量:ベンダーのチャット画面にログインできても、そのアカウントに使える API の残量があるとは限りません。開発者プラットフォームで確認してください。

ネット上の例にある古いモデル名が今も使えると決めつけないでください。現在のモデル一覧から選び、手入力するときは一字ずつ確認してください。

設定 → モデル を開き、サービスに対応するベンダーを選びます。API キーを入力するか、画面が対応していればこの端末で読める環境変数名を入力します。公式サービスではテンプレートの既定アドレスを残し、プロキシや別のエンドポイントが明確に必要なときだけ Base URL を上書きしてください。

まず接続をテストし、それからモデル ID を入力または選択し、表示名を補って保存します。対象の設定をメインモデルにしたうえで、私的な情報を含まないメッセージで会話が完了するか確認してください。接続テストの成功は、モデルが Agent のツール呼び出しをすべて備えていることを保証しません。

ベンダーとプロトコル​

以下は Mystilink の対応テンプレートと公式の入口であり、利用可能な地域・モデル・価格を約束するものではありません。キーの取得手順、権限、課金規則はベンダーのプラットフォームが基準です。

ベンダー公式の入口Mystilink テンプレートの注意
OpenAIAPI プラットフォーム、認証リファレンスOpenAI テンプレートを使う。既定アドレスを残し、アカウントで実際に使えるモデルを選ぶ
AnthropicConsole、API ドキュメントネイティブ API は Anthropic プロトコル。汎用の互換ゲートウェイとして入力しない
Google GeminiAI Studio、モデル資料Gemini テンプレートを使う。現在のテンプレートは Base URL の上書きに対応していない
DeepSeek開発者プラットフォーム、API ドキュメントDeepSeek テンプレートを使い、モデルとアカウントの権限を確認する
MiniMax開発者プラットフォーム対応するテンプレートを使う。地域の異なるアカウント、キー、アドレスを混ぜない
Moonshot / Kimi開発者プラットフォーム対応するテンプレートを使う。モデル ID とアドレスは同じサービス地域・アカウントのものにする

Anthropic​

公式のネイティブサービスを使うときは Anthropic テンプレートを選びます。提供元が別に互換ゲートウェイを用意している場合は、公開されている互換プロトコルとアドレスを使ってください。モデル名に Claude が含まれるという理由だけでネイティブのテンプレートを選ばないでください。

Google Gemini​

Gemini テンプレートで公式のネイティブ API に接続します。第三者のプラットフォームが提供する Gemini モデルは別の互換プロトコルのことがあります。実際のゲートウェイに合わせて カスタムベンダー を選んでください。

アドレス・キー・モデルは同じサービスから​

公式のキーがプロキシで使えるとは限らず、プロキシのキーを公式アドレスにそのまま使うこともできません。キーを発行したのは誰か、リクエストはどのドメインへ行くのか、そのアカウントでどのモデルが使えるのかを同時に確認してください。アドレスを上書きすると、リクエストの内容は新しいアドレスのサービスへ送られます。

Base URL にはサービスの API プレフィックスを入れ、チャットのリクエストパス全体やモデル詳細の Web ページを貼り付けないでください。第三者のゲートウェイやローカルサービスについては 互換ベンダー と ローカルモデル を参照してください。

よくある問題​

症状まず確認すること
401 / キーが無効キーがこのアドレスのものか、期限切れや失効がないか、アプリが環境変数を読めるか
モデル一覧が空アカウントの権限、モデル検出の対応。正確な ID が分かれば手入力する
404 / model not foundAPI プレフィックスとモデル ID。表示名を ID として使っていないか
テストは通るがタスクが失敗ツール呼び出し、ストリーミング、モデルの能力。ネットワークだけを見ない
残量に関するエラー実際のベンダーで API の請求を確認する。Newton へのチャージは第三者の残量を増やさない

さらに詳しくは モデル接続の問題 を参照してください。キーが漏えいしたら、発行元のプラットフォームで失効させて設定し直してください。表示名を変えたりスクリーンショットを消したりするだけでは足りません。