AIプロバイダーへの接続
チャットするには、Marinara EngineにAIモデルが必要です。AIサービスのアカウントを追加し、そのAPIキーを貼り付けて、モデルを選びます。APIキーとは、サービスが発行する秘密のコードで、Marinaraがそのサービスで自分のアカウントを使えるようにするものです。パスワードと同じように扱ってください。キーなしで自分のコンピューター上で動く小さなモデル、内蔵モデルを使うこともできます。
アカウントを追加する
始める前に、使いたいサービスでAPIキーを取得してください。Add account(アカウントの追加)ウィンドウには、サービスごとにWhere do I find my key?(キーの入手先)のリンクがあります。主なサービスでは、このリンクから次のページが開きます。
- OpenRouter(無料のモデルあり):
openrouter.ai/keys - NanoGPT:
nano-gpt.com/api - OpenAI:
platform.openai.com/api-keys - Anthropic:
console.anthropic.com/settings/keys - Google Gemini:
aistudio.google.com/apikey
キーを使えるようにするには、たいていのサービスで登録が必要です。クレジットの追加を求めるサービスもあります。ほかのサービスについては、対応しているAIプロバイダーを参照してください。キーなしで自分のコンピューター上のモデルを使うには、内蔵モデルのセットアップを参照してください。
- 上部バーのConnections(接続)をクリックします。右側にパネルが開きます。アカウントがまだない場合は、Where do your models come from?(モデルの入手元)と表示され、いくつかのサービスが並びます。サービスをクリックします(Built-in model(内蔵モデル)以外)。Add accountウィンドウがキーのステップで開きます。手順4に進んでください。
- Add(追加)をクリックします。Add accountウィンドウが開きます。
- 使いたいサービスをクリックします。探すときは、Search providers(プロバイダーを検索)という欄に入力します。一覧には、Chat(チャット)、Images & video(画像と動画)、Voice(音声)、Decisions(判定)のセクションがあります。通常のチャットモデルはChatの下にあります。
- API key(APIキー)をクリックして、キーを貼り付けます。目のボタンをクリックすると、キーをすべて貼り付けたかどうかを確認できます。
- Connect(接続)をクリックします。Marinaraがキーをテストします。うまくいくと、Connectedと、見つかったモデルの数が表示されます。
- 次に起きることは、Mainのモデルがすでにあるかどうかで変わります。Mainとは、チャットの返信を書く役割です。
- Mainのモデルがまだない場合、または新しいチャットからAddを開いた場合: ウィンドウに、そのサービスのモデルが表示されます。Recommended(おすすめ)のモデルが上に並びます。モデルをクリックして追加するか、Search or enter model ID…(検索またはモデルIDを入力…)に名前を入力します。どれを選べばよいかわからない場合は、Recommendedのモデルを選んでください。あとから変更できます。Make … my Main model(…をメインのモデルにする)はチェックしたままにします。これは、Mainのモデルがないときだけ表示されます。新しいチャットからAddを開き、すでにMainのモデルがある場合は、代わりにSet … as Main(…をメインに設定)ボタンが表示されます。最後にDone(完了)をクリックします。新しいチャットから開いた場合は、Start chatting(チャットを始める)をクリックします。
- Mainのモデルがすでにある場合: ウィンドウが閉じ、アカウントが追加されたことと、そのモデルの数がメッセージで表示されます。モデルをさらに追加するには、アカウントの⋯をクリックし、Add model(モデルを追加)を選びます。
パネルにアカウントが表示されます。手順5のConnectedは、キーが機能していることをすでに示しています。新しいモデルがMainのモデルなら、チャットを始めてメッセージを送ってください。返信が来れば、すべて正しく動いています。すでにMainのモデルがあった場合、新しいチャットは引き続きそのモデルを使います。新しいアカウントを使うには、そのアカウントにモデルを追加し(⋯ → Add model)、そのモデルをチャットか役割に選んでください(役割ごとのモデルを選ぶを参照)。
うまくいかなかった場合:
- The key was not accepted. Check that you copied all of it.と表示された場合は、キーを貼り直してTry again(もう一度試す)をクリックします。キーは、選んだサービスで発行されたものである必要があります。
- The service is busy, or your credit is used up.と表示された場合は、サービスのWebサイトでクレジットを追加するか、時間をおいてもう一度試してください。
- サービスについてMarinara could not reachと表示された場合は、インターネット接続を確認してから、Try againをクリックします。
アカウントの任意項目
キーのステップには、次の項目も表示されます。必要な場合を除き、空のままにしてください。
- Name (optional)(名前、任意): パネルに表示される名前です。空の場合は、サービスの名前になります。同じサービスの2つ目のアカウントには、キーの末尾4文字が付きます。たとえば
OpenAI · …a1b2です。 - Address(アドレス): Marinaraがリクエストを送る先です。空の場合、Marinaraはサービス自身のアドレスを使います。入力するのは、プロキシ、ゲートウェイ、または自分で運用するサーバーを使う場合だけです。自分のコンピューターでサインインするサービスには表示されません。
- Requests per minute(1分あたりのリクエスト数): このアカウントでのMarinaraのリクエストの速度を落とします。空の場合は無制限です。指定できる値は1から600です。
- Parallel jobs(同時に実行する処理の数): 同時に実行するリクエストの数です。空の場合は無制限です。指定できる値は1から16です。Edit account(アカウントの編集)では、同じ設定がParallel requests(同時リクエスト数)という名前になります。
一部のサービスは、キーの代わりに自分のコンピューターでのサインインを使います。これらにはSign in(サインイン)のタグが付いていて、キーの欄はありません。Claude、ChatGPT、Grokのサブスクリプション接続を参照してください。自分のコンピューター上のサーバーについては、ローカルモデルやセルフホストモデルへの接続を参照してください。テストが失敗すると、Continue anyway(それでも続ける)が表示されます。これを使うと、テストに合格しないままアカウントを保存します。
アカウントなしでチャットを始める
モデルがまだない状態でチャットを始めると、Marinaraは先にAdd account(アカウントの追加)ウィンドウを開きます。Connect(接続)のあとでモデルをクリックし、Start chatting(チャットを始める)をクリックします。
Connectionsパネル
アカウントの管理はConnections(接続)パネルで行います。パネルには、上から順に次のものが表示されます。
- 入力に合わせて一覧を絞り込む検索欄。ラベルはSearch models and accounts(モデルとアカウントを検索)です。
- Add(追加)とMore actions(その他の操作、3つの点のアイコン)。AddはAdd account(アカウントの追加)を開きます。More actionsには、Import account(アカウントのインポート)、Export all accounts(すべてのアカウントをエクスポート)、折りたたみ、グループ化の操作があります。パネルの幅が広いときは、並べ替えのドロップダウンが検索欄の横にあります。幅が狭いときは、並べ替えはMore actionsの中にあります。
- Jobs(役割)ボックス。どのモデルがどの役割を担当するかを示します。
- Built-in model(内蔵モデル)のカード。内蔵モデルのセットアップを参照してください。
- 自分のアカウント。それぞれのアカウントの下に、保存したモデルが並びます。接続の整理を参照してください。
アカウントとは、1つのサービスについて保存した1つのキー、サインイン、またはアドレスのことです。同じサービスで2つのキーを使う場合は、アカウントが2つになります。モデルとは、アカウントから保存した1つのAIモデルのことです。保存したモデルは、それぞれ独自の設定を持ちます。
役割ごとのモデルを選ぶ
役割とは、モデルが代わりに行う仕事のことです。Jobs(役割)ボックスには、役割が4つのグループに分かれて並びます。
| グループ | 役割 |
| Chat(チャット) | Main(メイン)はチャットの返信を書きます。Agents(エージェント)は補助エージェントを動かします。Impersonateは自分の代わりに文章を書きます。 |
| Omnibar | Professor MariとQuick answers(クイック回答)。 |
| Pictures & sound(画像と音声) | Images(画像)、Video(動画)、Voice (Text to Speech)(音声合成)、および利用できる場合はDictation (Speech to Text)(音声入力)。 |
| Behind the scenes(裏方の処理) | Decision、Embeddings(埋め込み)、Image reading(画像の読み取り)。 |
各行には、その役割を担当しているモデルが表示されます。モデルがない場合は、Follows MainやOffのように、その役割がモデルなしでどう動くかが表示されます。モデルが必要な役割には、Choose a modelと表示されます。Jobsをクリックすると、ボックスを折りたためます。
役割のモデルを変えるには、その行をクリックします。その役割のModel for(役割に使うモデル)が開きます。ただし、3つの行は例外です。DecisionとEmbeddingsは、それぞれ専用の操作画面を開きます(Decisionモデルと対応しているAIプロバイダーを参照)。Dictation (Speech to Text)は、音声入力の設定を開きます。
Model forでは、次のようにします。
- 一覧を確認します。
- モデルをクリックします。一覧では、そのモデルがNow(現在)の下に表示され、続いてStarred(星付き)のモデル、そのあとに保存したモデルがアカウントごとに並びます。アカウントの下にあるAll models(すべてのモデル)をクリックすると、そのアカウントの一覧全体が開きます。Search all models or paste a model ID(すべてのモデルを検索、またはモデルIDを貼り付け)に入力すると、すべてのアカウントをまとめて検索できます。先にモデルを保存しておく必要はありません。
ウィンドウ上部のIf it fails(失敗したとき)では、1つ目のモデルが失敗したときに代わりに答える2つ目のモデルを選びます。下部のAdd account(アカウントの追加)をクリックすると、追加用のウィンドウが開きます。
機能にモデルが必要なとき
ある種類のモデルがないと動かない機能には、Needs an image modelのラベルが表示されます(動画、音声、判定、チャットの場合もあります)。このラベルは、Agents(エージェント)パネルのエージェントのカード、Chat Settings(チャット設定)、エージェントエディター、画像と動画のウィンドウに表示されます。横にあるSet up(セットアップ)をクリックし、モデルを選ぶかAdd account(アカウントの追加)をクリックします。役割にモデルが設定されると、ラベルは消えます。
アカウントをテストする
Connect(接続)の時点で、キーはすでにテストされています。あとからもう一度テストするには、パネルでアカウントの⋯メニューを開き、Test(テスト)をクリックします。アカウントエディターであるEdit account(アカウントの編集)にはTest account(アカウントをテスト)があり、保存する前に、入力したとおりのキーとアドレスを確認できます。
1つのチャットで使うモデルを選ぶ
新しいチャットはMain(メイン)のモデルを使います。1つのチャットだけ別のモデルにするには、チャット入力欄のモデルボタン(リンクのアイコンで、現在のモデル名が書かれたボタン)をクリックするか、Chat Settings → Connection(チャット設定 → 接続)のModel(モデル)欄を使います。どちらもModel for this chat(このチャットのモデル)を開きます。
- Now(現在)には、チャットが使っているモデルが表示されます。This chat onlyは、チャットが独自に選んでいることを示します。follows Mainは、Mainを使っていることを示します。
- Recent(最近)とStarred(星付き)には、自分のモデルがアカウントごとに並びます。
- Search models or paste an ID…(モデルを検索、またはIDを貼り付け…)は、すべてのアカウントを検索します。Browse(参照)は、1つのアカウントの一覧全体を開きます。
- Follow Main(メインに従う)は、チャット独自の選択を解除します。Shuffle(シャッフル)は、毎回違うモデルを選びます。
選んだモデルが変わるのは、そのチャットだけです。選んだあとに表示されるメッセージには、Make it my Main model(これをメインのモデルにする)とUndo(元に戻す)があります。Game Modeでは、この欄にGame Master model(ゲームマスターのモデル)というラベルが付きます。
よくあるエラー
テストやメッセージが失敗したときは、まず次の点を確かめてください。
- キーが間違っているか、期限が切れている。アカウントの⋯をクリックし、Replace key(キーを置き換える)を選んで、キーを貼り直します。キーのないアカウントにはNeeds keyと表示されます。
- アカウントがオフになっている。その場合はOffと表示されます。⋯メニューのTurn on(オンにする)をクリックしてください。
- 別のサービスのキーを使っている。サービスごとに専用のキーが必要です。
- Address(アドレス)がブロックされている。空の場合は、サービス自身のアドレスを使います。
ほかの対処法については、Marinara Engineのトラブルシューティングを参照してください。
関連ガイド
- 接続の整理
- 対応しているAIプロバイダー
- Claude、ChatGPT、Grokのサブスクリプション接続
- ローカルモデルやセルフホストモデルへの接続