Source: https://ailoot.ai/docs/ja/integrations/mastra/
Canonical: https://ailoot.ai/docs/ja/integrations/mastra/
Language: ja

[SDKとフレームワーク](https://ailoot.ai/docs/ja/integrations/#sdk) 

# Mastra

[Markdown](https://ailoot.ai/docs/ja/integrations/mastra/index.md)

エージェントフレームワーク · OpenAI Chat, OpenAI Responses

| 形式 | 設定場所 |
| --- | --- |
| OpenAI Chat, OpenAI Responses | Agent内：model: { id: "\<プロバイダー\>/\<モデル\>", url: "\<ベースアドレス\>", apiKey, api?: "chat" \| "responses" } |

## [](https://ailoot.ai/docs/ja/integrations/mastra/#setup)設定

設定をコピーし、 `sk-...` を、Ailootのダッシュボードで取得した自分のキーに置き換えてください。キーは、次の環境変数で保管することを推奨します：`AILOOT_API_KEY`。アプリケーションが対応している場合に使用してください。

実行前に、AilootキーでGET /v1/modelsを取得します。対応メソッドにPOST /v1/chat/completions, POST /v1/responsesを含む正確なモデルIDを選び、設定に使用してください。エージェントでは、クライアントのバージョンに必要なツールと機能の対応も確認します。

```js
import { Agent } from "@mastra/core/agent";
const agent = new Agent({
  id: "ailoot-agent",
  name: "Ailoot Agent",
  instructions: "ロシア語で回答してください",
  model: {
    id: "ailoot/claude-sonnet-5-5",
    url: "https://api.ailoot.ai/v1",
    apiKey: process.env.AILOOT_API_KEY
    // api: "responses"  // responsesメソッドを持つモデルのみ
  }
});
```

この設定は、次の変数からキーを取得します：`AILOOT_API_KEY`。アプリケーションの起動前に設定してください：

```bash
export AILOOT_API_KEY="sk-..."   # ~/.zshrcまたは~/.bashrcに追加する
```

```powershell
setx AILOOT_API_KEY "sk-..."   # その後、ターミナルを再起動する
```

モデルの例：`ailoot/claude-sonnet-5-5, ailoot/gpt-6.1-sol`。別のモデルを選ぶ際の参照先：[カタログ](https://ailoot.ai/models/ja/) 。必要な形式に対応しているか確認してください。

## [](https://ailoot.ai/docs/ja/integrations/mastra/#notes)注意事項

urlには/v1を含むベースアドレスを指定し、/chat/completionsの完全なパスは指定しません。デフォルトはChat Completionsで、api: "responses"がResponses APIに切り替えます。idの"プロバイダー/モデル"形式では、プレフィックスなしのモデルidがゲートウェイに送られます。modelオブジェクトのapiKeyは、ヘッダーの例で示されていますが、urlと合わせた設定は別途説明されていません。

## [](https://ailoot.ai/docs/ja/integrations/mastra/#check)確認

- OpenAI形式のアドレス：`https://api.ailoot.ai/v1` （アプリケーションが完全なアドレスを求める場合は、完全なパス）。
- 短い質問を送信してください。エラーが返った場合は、コードとRequest IDを確認し、次のページと照合してください：[エラーと制限](https://ailoot.ai/docs/ja/errors/)。
- 設定直後の404は、ほとんどの場合、アドレスの間違いです。追加しすぎ、または不足している部分：`/v1`。
- 402は、仮確保に必要な残高の不足です。エージェントはチャットより多くの金額を仮確保します。参照：[理由](https://ailoot.ai/docs/ja/billing/reserve/)。

アプリケーションのドキュメント：[https://mastra.ai/models](https://mastra.ai/models)

ご不明な点はありますか？Request IDと状況の説明をお送りください。調査をお手伝いします。[サポートに問い合わせる](mailto:support@ailoot.ai)

## Ailoot · 企業とそのプロジェクト群





Ailootは、蓄積した運営経験、幅広い顧客基盤、安定したサービス、継続的なKPI管理を基盤としています。





企業とそのプロジェクト群：数百万の顧客、毎月数十億規模の売上。





Ailootはこの運営経験を、お客様の製品、エージェント、アプリケーション、自動化でAI機能を利用するためのAPIアクセスに活かしています。