導入ガイド

プロバイダー導入ガイド

ツール別の設定手順やトラブルシューティングを見る。

プロバイダー導入ガイド/まずはAIとプロバイダーの基本用語を理解しよう

まずはAIとプロバイダーの基本用語を理解しよう

API Key、Base URL、モデル名、倍率、エラーコードなどで迷った時は、まずこちらで用語を確認してから設定やトラブルシューティングを進めてください。

AIの基本用語

用語わかりやすい解説初心者が注意すべきポイント
モデル (Model)質問への回答、コード作成、画像や動画の生成を実際に担当するAIの本体。モデル名はプロバイダーの管理画面から正確にコピーしてください。大文字・小文字、ハイフン、バージョン番号を勝手に変更してはいけません。
大規模言語モデル (LLM)自然言語、コード、画像などのタスクを処理できるモデルの総称。高価なモデルが必ずしも自分に適しているとは限りません。文章作成、プログラミング、画像、動画など、用途によって適したモデルが異なります。
マルチモーダル (Multimodal)テキスト、画像、音声、動画など、異なる種類の入力を同じモデルで処理できること。使用するツールがマルチモーダル対応であっても、契約しているプロバイダーや選択中のモデルが対応しているとは限りません。
プロンプト / 指示文 (Prompt)「この内容を要約してください」など、AIに送信するリクエストや指示。プロンプトが具体的であるほど、期待通りの実用的な結果が得られやすくなります。
システムプロンプト (System Prompt)通常の質問よりも優先度が高いルール。AIの役割、トーン、安全基準などを規定するために使われます。コード作成ツール内のシステムプロンプトは、ファイルの読み取り方やコードの修正方法に影響します。
コンテキストウィンドウ (Context Window)モデルが一度に記憶・処理できる情報量（会話履歴や文書の長さ）。コンテキストが大きいからといって賢いとは限りませんが、長文ドキュメント、大規模プロジェクト、継続的な複数ターンの対話の処理に適しています。
自動圧縮 / 自動要約会話やファイルの内容がコンテキスト制限を超えそうになった際、一部のツールが過去の内容を短い要約にまとめてからモデルに再送信する機能。自動圧縮によって会話は継続できますが、要約によって細部が失われる可能性があります。問題のトラブルシューティング、コード修正、設定確認の際は、モデルが原文のすべてを覚えていると思い込まないようにしてください。
トークン (Token)モデルの課金や長さ計算の基本単位。テキストを細かく分解した小さな断片として大まかに理解できます。入力と出力の両方でトークンを消費します。長文ドキュメントや長い会話はコストが大幅に増加します。
Temperature (温度)回答のランダム性（創造性）を制御するパラメータ。安定性と再現性を重視する場合は低めに設定し、発散的な創造性・アイデア出しを求める場合は適切に上げてください。

AIプロバイダー（中継）関連

用語わかりやすい解説初心者が注意すべきポイント
AIプロバイダー（中転站）ツールからのリクエストを、1つまたは複数のモデルサービスプラットフォームに転送・中継するサービス。モデルそのものではありません。対応モデル、安定性、価格、リスク履歴などを重視して選択する必要があります。
プロバイダー (Provider)AIインターフェース、モデル、課金、バックエンド管理を提供するプラットフォーム。公式事業者または中継プロバイダーを指します。プロバイダーごとに、APIアドレス、Key、モデル名、課金方式がすべて異なる場合があります。
公式ルートOpenAI、Anthropic、Googleなど、モデル開発元自身が提供する公式サービス。安定性やルールは明確ですが、決済手段、地域制限、価格、クォータなどのハードルがある場合があります。
ミラー / プロキシ (Mirror / Proxy)リクエストを目的のサービスの中間層へ転送する仕組み。この用語を見かけた場合は、プライバシー、安定性、リクエスト内容が保存されていないかに特に注意してください。
New API / カスタム管理パネル多くのAIプロバイダーがオープンソースの管理パネルをベースに構築・二次開発しているバックエンドシステム。メニュー名がトークン、チャネル、グループ、モデル倍率などと呼ばれており、公式プラットフォームの表記と必ずしも一致しない場合があります。
チャネル (Channel)バックエンドで特定の上流モデルサービスと接続している回線・ルート。チャネルに障害が発生している場合、Keyが正しくてもリクエストが失敗することがあります。
モデルグループ (Grouping)異なるモデルや権限をグループごとに割り当てる機能。お使いのKeyが対応するグループに追加されていない場合、モデルが利用不可になったり「model not found」エラーが発生したりします。
モデルマッピング (Mapping)プロバイダーが表示用の名称を実際の上流モデルに対応付ける設定。画面上の表示名と実際の上流モデル名が異なる場合があります。設定時は管理画面の指定に従ってください。

設定フィールド

設定項目わかりやすい解説入力方法
APIアプリケーションがモデルのAPIを呼び出す方式。ツールはWebチャットを開くのではなく、API経由でプロバイダーに質問を送信します。ツールが明示的にAPI設定をサポートしている場合にのみ入力が必要です。
API Key / Key / Secret「このアカウントの利用者である」ことをツールが証明するための文字列（認証キー）。プロバイダーの管理画面から完全にコピーしてください。公開の場にスクリーンショットを投稿したり、前後に余計な空白を含めたりしないでください。
Token多くのAIプロバイダーが管理画面でKeyのことを指して呼ぶ名称。token、Token、API Key、secretといった表記は、通常すべて同じ「アクセス認証情報」を指しています。
Base URL / APIアドレスツールがモデルにリクエストを送るために、プロバイダーが提供するインターフェースのアドレス。API接続用のURLです。Webサイトのトップページのように見える場合もあれば、末尾に /v1 が必要な場合もあります。管理画面の記入例に従ってください。
Endpointインターフェースアドレスの別名。プロバイダーのドキュメントでEndpointと記載されている場合は、通常APIアドレスまたはBase URLを探してください。
Provider (プロバイダー)ツール内のプロバイダー設定項目。「どのプロバイダーの、どのKeyとAPIアドレスを使用するか」という設定として理解できます。
Model / Model ID / モデル名呼び出したいモデルのAPI名をプロバイダーに指示する項目。管理画面のモデルリストに従って正確にコピーしてください。モデルリストの自動取得に失敗した場合にのみ手動で入力します。
OpenAI互換 (Compatible with OpenAI)プロバイダーのAPI形式がOpenAI APIを模倣しており、多くのツールで「OpenAI Provider」としてそのまま入力できる仕様。OpenAI互換であっても、Claude、Gemini、画像、動画などのすべての独自インターフェースをサポートしているとは限りません。

課金と制限

用語わかりやすい解説初心者が注意すべきポイント
残高 (Balance)プロバイダーのアカウントで利用可能な残りの金額またはポイント。残高不足になるとリクエストが失敗します。必ずしも設定ミスとは限りません。
料金倍率 (Multiplier)AIプロバイダーで広く使われる課金係数。特定のモデルが基準価格の何倍で課金されるかを示します。モデルが高性能であるほど、コンテキストが大きいほど、画像や動画などの複雑なタスクであるほど、倍率が高く設定される傾向があります。
入力価格 (Input price)モデルに送信したコンテンツによって発生するコスト。長文ドキュメント、長いコード、長いチャット履歴は入力コストを増加させます。
出力価格 (Output Price)モデルが生成・返答したコンテンツによって発生するコスト。モデルに非常に長い文章を作成させた場合、出力コストも増加します。
同時実行数 (Concurrency)同時に開始できるリクエストの数。同時実行数が低すぎる場合、複数のツールを起動したり複数人で共有したりすると、キュー待ちやエラーが発生します。
RPM / TPM1分あたりのリクエスト数制限 (RPM) / 1分あたりのトークン数制限 (TPM)。レート制限エラーが表示された場合、通常はリクエスト頻度が高すぎるか、送信コンテンツが長すぎることが原因です。
コンテキスト長1回のリクエストに含めることができる最大データ量。上限を超えると、ツール側でコンテンツが切り捨てられたり、直接エラーになったり、過去の会話が自動圧縮・要約されてから送信されたりします。
キャッシュ (Cache)コスト削減や高速化のために、プロバイダーやモデルがすでに処理されたコンテンツを再利用する仕組み。キャッシュは必ずしも自動的に適用されるわけではなく、完全に無料とは限りません。プロバイダーとモデルのルールに依存します。
キャッシュ価格キャッシュ関連費用の総称。バックエンドによっては、作成、ヒット、読み取りなどの異なる価格に細分化されています。キャッシュ価格を見かけた際は、書き込みキャッシュなのか、読み取りキャッシュなのか、複数の項目を合算表示しているのかをまず確認してください。
キャッシュ作成価格 / キャッシュ書き込み価格再利用可能なコンテンツを初めてキャッシュに書き込む際に発生するコスト。長いシステムプロンプト、長文ドキュメント、固定コンテキストを初めて使用する際に、この費用が発生する場合があります。
キャッシュヒット価格 / キャッシュ読み取り価格後続のリクエストですでにキャッシュされたコンテンツを再利用した際に発生するコスト。通常は通常の入力価格より安価ですが、費用が発生する場合もあります。キャッシュヒット＝必ず無料と思い込まないでください。
キャッシュヒット (Cache hit)今回のリクエストの一部が前回と同じであるとプロバイダーに認識され、キャッシュが直接再利用された状態。同じプレフィックスを持つ、十分な長さがある、有効期間内に再利用されるなど、プロバイダーのキャッシュルールを満たした場合にのみヒットします。
キャッシュ有効期限キャッシュを再利用できる有効期間。期限切れ後に再度リクエストすると、通常の入力として課金されるか、再びキャッシュ作成費用が発生する場合があります。

よくあるエラー用語

エラー表示一般的な意味優先して確認すべき点
401 / Unauthorized認証に失敗しました。Keyが完全か、有効期限が切れていないか、前後に余計な空白がコピーされていないか。
403 / ForbiddenアカウントまたはKeyにアクセス権限がありません。モデル権限、グループ権限、地域制限、アカウント残高の状態。
404 / model not foundモデルが存在しないか、現在のKeyではこのモデルを使用できません。モデル名が管理画面から正しくコピーされているか、Keyが対応するモデルグループに追加されているか。
429 / rate limitリクエストが頻繁すぎるか、クォータ上限に達しました。同時実行数、RPM、TPM、プロバイダーの制限。時間を置いてから再試行してください。
timeout / タイムアウトリクエストが時間内に応答しませんでした。Base URL、ネットワーク環境、プロバイダーの稼働状況、モデルのキュー待ち状態。
invalid api keyKeyの形式または権限が正しくありません。Keyを再コピーしてください。Keyの名前（メモ）とKey本体を取り違えていないか確認してください。
invalid base urlインターフェースのアドレスが正しくありません。管理画面のURLではなくAPIアドレスであるか確認してください。末尾に /v1 が必要かどうかは管理画面の表記を優先してください。
insufficient quota利用枠または残高が不足しています。アカウント残高、モデル倍率、チャージが正常に反映されているか。
エラーメッセージの意味がよくわからない時は、一度に複数の項目を変更しないでください。Key、Base URL、モデル名、残高、モデル権限、プロバイダーの稼働状況の順に1つずつ確認しましょう。