AIモデルと独自キー

パネル内のAIはさまざまな場所で動作します。商品や料理の説明、ゲストへの回答、通話の解析、教材の作成、セクション別のアシスタントなどです。デフォルトでは、タスクごとにモデルを当社が選択します。ほとんどの方にはこれで十分です。

**「AIモデル（LLM）」**セクションは、アカウントのアシスタント機能をどのサービスが担当し、どのモデルで動作するかを自分で決めたい方に必要です。すでにプロバイダーとの契約がある場合は、独自キーを接続でき、呼び出しはそれを経由します。

開き方：拡張機能ストア（カテゴリ「アカウント」）の**「AIモデル（LLM）」カード → admin.cenaly.com/ai-models。このセクションにはメニュー項目がありません — これはエラーではなく、入り口はストアからの一つだけです。セクションはアカウント所有者のみ**利用できます。

このセクションの目的#

開始に必要なもの#

ステップ1. 既成AIサービスを接続する#

ページの最初のブロックは**「CenalyのAIサービス」**です：ChatGPT（OpenAI）、Gemini（Google）、Grok（xAI）、DeepSeek。ワンクリックで接続できます：

1. 目的のサービスの**「接続」**を押します — APIキーは不要で、リクエストは当社のインフラを通じて送信されます。
2. 接続したサービスに**「モデル」**行が表示されます — サービスのリストから特定のモデルを選択します（リストはサービスごとに異なり、随時更新されます）。
3. 不要なサービスは**「切断」**ボタンで切断できます。

支払いは他のAI機能と同様、アカウントのAIクレジットです。「ChatGPT接続」に対する別途請求書は発行されず、実際の呼び出しに対して支払います。

ステップ2. 独自キーを接続する#

2番目のブロックは**「カスタムLLM」**です。モデルへの独自アクセスがある方向けです：プロバイダーとの独自契約、社内ゲートウェイ、またはOpenAI互換APIを備えた自社展開モデルなど。

1. **「カスタムLLMを追加」**を押して入力します：名前（識別用）、Base URL API — バージョンを含むアドレス、例：https://api.example.com/v1（httpsのみ）、APIキー、モデル — そのプロバイダーでのモデルID。
2. **「接続確認」**を押します — テストリクエストが送信され、遅延測定付きの「接続あり」または失敗理由が表示されます。確認は保存前にも、保存済みレコードに対しても機能します。
3. 「追加」 — 接続がリストに表示されます。トグルで一時的に無効化したり、削除したりできます（確認付き：レコードとともに保存されたキーも削除されます）。

キーの保存方法：キーはサーバー上に保存され、ブラウザに返されることはありません — インターフェースには「APIキー保存済み」の表示とマスクのみが見えます。キーを差し替えることはできますが、パネルから読み取ることはできません。

費用について：独自キーによる呼び出しにはAIクレジットは消費されません — プロバイダーに直接支払います。ただし、エンドポイントが応答しなかった場合、呼び出しは失敗せず、通常のプラットフォームキューに送られます — そしてこの呼び出しはクレジットで計算されます。予期しない場所で消費が見られる場合は、エンドポイントの可用性を確認してください。

接続は複数（最大10件）可能です — 例えば、異なる実験用に異なるモデルなど。トグルが有効なものが動作します。

ステップ3. 優先モデルを選択する#

3番目のブロックは**「優先モデル」**、アカウント全体の切り替えです：

• 「デフォルト（タスクに応じて推奨）」 — プラットフォームが機能ごとに個別にモデルを選択します。これが初期状態です；
• 特定のサービスまたはカスタム接続 — アシスタント機能がこれを優先的に使用します。

優先設定時の試行順序：まずカスタムエンドポイント（それが優先されている場合）、次に選択したモデルでのプラットフォーム呼び出し、そして通常のフォールバックパス — 一つのプロバイダーの障害で機能が「停止」しないようにするためです。

⚠️ 選択はすべてのAI機能で有効ではありません — 詳細は「制限事項」をご覧ください。

消費の確認方法#

AIの消費はサブスクリプションページの2つのカードに表示されます：「LLMクレジット」 — AIタスクの残高、「AI費用」 — 機能別の月間消費、月末までの請求予測、月間上限。行ごとにどの機能が消費しているか（説明、通話、翻訳、トレーニング）がわかります。

独自キーによる呼び出しの行はそこに表示されません — そのような呼び出しは当社の残高を消費しません。

制限事項#

• cenaly.ru では選択が反映されません。 ロシアの環境ではAI機能は YandexGPT で動作し、このセクションの設定は読み込まれません。ページは開いて保存もできますが、それを適用する先がありません。これはデータ処理要件によるもので、設定の忘れではありません。
• ツールを伴う呼び出しには選択が反映されません。 一部の機能は「モデル＋ツール」として作られています — ゲストチャットのAIボット、管理パネルのコパイロット、メールの文面サジェストなどです。これらはここで何を選んでも独自のモデルで動作します。
• このセクションはオーナー専用です。 従業員はメニューに表示されず、直接リンクで開くと「再試行」ボタン付きの読み込みエラー画面が表示されます。丁寧な「アクセス権がありません」ではありません — 不具合と認識しており、修正中です。
• カスタムキーには有効期限も自動ローテーションもありません。 プロバイダー側でキーを変更したら、ここでも変更してください。そうしないと呼び出しが予備経路に回ります（しかもクレジット消費で）。
• OpenAI 互換の API のみ、かつ https のみ。 エンドポイントはパスバージョンを含めて指定します。任意のプロトコルや独自のレスポンス形式には対応していません。
• お使いのプロバイダーのモデル一覧は把握していません — モデルの id はプロバイダーのドキュメントを見て手入力してください。
• 既成サービスは4つです。 ChatGPT、Gemini、Grok、DeepSeek。それ以外はカスタム接続で対応します。

トラブルシューティング#

症状別の一般的な解説はトラブルシューティングをご覧ください。解決しない場合はご連絡ください — サポートの受け方。

よくある質問#

そもそもこのセクションを開く必要はありますか？#

いいえ。なくてもすべて動作します。プラットフォームが各タスクに合わせてモデルを自動で選びます。このセクションが必要なのは、モデルを自分で選びたい場合や自分のキーを接続したい場合です。

AI を使うには自分の OpenAI キーが必要ですか？#

いいえ。既成サービスはワンクリックで接続でき、当社のインフラを通じて動作し、支払いはアカウントの AI クレジットで行います。自分のキーは代替手段であり、必須条件ではありません。

自分のキーのほうが安くなりますか？#

プロバイダーとの契約によります。技術的には「当社の請求を経由しない」形です。そのような呼び出しに AI クレジットは消費されず、プロバイダーに直接支払います。

私の API キーは誰に見えますか？#

インターフェース上では誰にも見えません。キーはサーバーに書き込まれ、ブラウザには返されません — 保存されたという表示だけが見えます。このセクションはアカウントのオーナーのみ利用できます。

機能ごとに異なるモデルを選べますか？#

いいえ、優先設定はアカウントに1つです。タスクごとに異なるモデルを使うのは、まさにプラットフォームが選ぶ「デフォルト」モードです。

cenaly.ru ではなぜ選択が機能しないのですか？#

ロシアの環境は YandexGPT で動作します。データが環境の外に出ないため、外部プロバイダーや自分のエンドポイントはそこでは接続できません。

自分のエンドポイントが一時的に利用できない場合はどうなりますか？#

機能は壊れません。呼び出しは通常のプラットフォームのキューに回り、AI クレジットで計算されます。リクエストが黙って失われることはありません。

「AI モデル」カード自体に料金はかかりますか？#

カード接続に個別の料金はありません。支払うのは、当社のインフラを通じたモデルの実際の利用分だけです。

関連セクション#

• サブスクリプション — 「LLM クレジット」と「AI の支出」カード：残高、機能別の消費、月間上限
• アプリストア — 「AI モデル」セクションへの唯一の入口
• ナレッジベース — ベース構築のための AI プロバイダーの選択と処理への同意
• 従業員の研修 — 教材と課題をどのモデルが作成するか
• ゲスト向け AI 翻訳 — AI 残高を消費する機能のひとつ
• ゲストとのチャット — この選択に関係なく独自のモデルで動作する AI ボット
• メールと AI 自動応答 — この選択を経由しないもうひとつの「モデル＋ツール」機能
• サポートの受け方 — 接続が確認を通過しない場合