Minds Team

API概要

マインドのプログラムによる操作とナレッジ管理を可能にするMinds APIの概要。

Minds APIドキュメントへようこそ。当社のAPIを使用すると、AIマインドの作成と管理、ナレッジのアップロード、およびそれらとのインタラクションをプログラムから実行できます。

はじめに

Minds APIはREST原則に基づいて設計されています。当社のAPIは予測可能なリソース指向のURLを採用し、JSONエンコードされたリクエストボディを受け付け、JSONエンコードされたレスポンスを返し、標準的なHTTPレスポンスコード、認証、メソッドを使用します。

ベースURL

本番環境: https://getminds.ai/api/v1 または https://api.getminds.ai/v1

ローカル開発環境: http://localhost:3000/api/v1

どちらの本番環境ベースURLも完全に等価です。よりシンプルな連携URLにするために、api.getminds.aiサブドメインの使用を推奨します。

認証

すべてのAPIエンドポイントで、APIキーによる認証が必要です。APIキーはSettings → API Keysで生成および管理できます。

AuthorizationヘッダーにAPIキーを含めてください：

Authorization: Bearer minds_your_api_key_here

OpenAPI仕様

マシンリーダブルなOpenAPI 3.1.0仕様が/_openapi.jsonで公開されています。この仕様を使用して、型定義されたクライアント（TypeScript、Pythonなど）を生成したり、LLMに読み込ませてワンショットで連携コードを生成したりできます。例についてはOpenAPIを参照してください。

コンテンツタイプ

データを送信するすべてのリクエストには、Content-Typeヘッダーを含める必要があります：

Content-Type: application/json

ファイルのアップロードには以下を使用します：

Content-Type: multipart/form-data

利用可能なエンドポイント

Minds

カスタム設定を持つAIマインド（エージェント）を作成および管理します。

  • GET /api/v1/minds - すべてのMindを一覧表示
  • GET /api/v1/minds/{mindId} - Mindの詳細を取得
  • POST /api/v1/minds - 新規Mindを作成
  • PUT /api/v1/minds/{mindId} - Mindを更新
  • DELETE /api/v1/minds/{mindId} - Mindを削除
  • POST /api/v1/minds/{mindId}/regenerate-prompt - ナレッジからシステムプロンプトを再生成
  • GET /api/v1/minds/{mindId}/patterns - Mindの生の思考パターンを取得

Knowledge

マインドのナレッジを管理します。

  • GET /api/v1/minds/{mindId}/knowledge - ナレッジアイテムを一覧表示
  • POST /api/v1/minds/{mindId}/knowledge - ナレッジを追加（リンク、ファイル、またはキーワード検索）
  • PUT /api/v1/minds/{mindId}/knowledge/{itemId} - ナレッジアイテムを更新
  • DELETE /api/v1/minds/{mindId}/knowledge/{itemId} - ナレッジアイテムを削除
  • POST /api/v1/minds/{mindId}/knowledge/enrich - キーワード検索によるエンリッチ（便利なエイリアス）
  • GET /api/v1/minds/{mindId}/knowledge/patterns - フレームワークごとのナレッジパターンを取得

Chat

チャット補完を介してマインドとインタラクションを行います。

  • POST /api/v1/minds/{mindId}/completion - メッセージを送信してレスポンスを取得

Studies

マインドのグループを調査するためのAIパネルを作成および管理します。

  • GET /api/v1/studies - すべてのパネルを一覧表示
  • POST /api/v1/studies - 新規パネルを作成
  • GET /api/v1/studies/{studyId} - メッセージ履歴を含むパネルの詳細を取得
  • POST /api/v1/studies/{studyId}/ask - パネル内のすべてのマインドに質問を送信（SSEストリーム）
  • POST /api/v1/studies/{studyId}/export - パネル結果をレポートとしてエクスポート
  • GET /api/v1/studies/{studyId}/export-status - エクスポートジョブのステータスを確認
  • GET /api/v1/studies/{studyId}/export-download - エクスポートされたPDFをダウンロード

User

ユーザー関連のエンドポイント。

  • GET /api/v1/auth/me - 現在認証されているユーザーを取得
  • GET /api/v1/user/shareable-sparks - 共有可能なマインドを一覧表示

APIキー

認証用のAPIキーを管理します。

  • GET /api/v1/api-keys - APIキーを一覧表示
  • POST /api/v1/api-keys - 新規APIキーを作成
  • DELETE /api/v1/api-keys/{keyId} - APIキーを削除

クイックサンプル

以下は、マインドを作成してチャットを行う簡単な例です：

# 1. Create a mind (keywords mode)
curl -X POST "https://getminds.ai/api/v1/minds" \
  -H "Authorization: Bearer minds_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Marketing Expert",
    "description": "Expert in digital marketing strategies",
    "mode": "keywords",
    "type": "expert",
    "discipline": "Marketing",
    "keywords": ["SEO", "content marketing", "social media", "analytics"]
  }'

# Response: { "data": { "id": "mind-id", ... }, "processing": { "queued": true, ... } }

# 2. Create a mind from social profile (clone mode)
curl -X POST "https://getminds.ai/api/v1/minds" \
  -H "Authorization: Bearer minds_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Influencer Clone",
    "description": "AI trained on influencer social presence",
    "mode": "clone",
    "type": "creative",
    "discipline": "Social Media Marketing",
    "personaContext": "https://twitter.com/username"
  }'

# 3. Chat with the mind
curl -X POST "https://getminds.ai/api/v1/minds/mind-id/completion" \
  -H "Authorization: Bearer minds_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "messages": [
      {
        "role": "user",
        "content": "What are the top social media trends for 2025?"
      }
    ]
  }'

次のステップ

プラン制限

APIおよびMCPアクセスは、対応する有料プランで利用できます。制限を連携側にハードコードせず、構造化されたplan_limitedおよび429レスポンスを処理してください。StarterプランはAPI payloadでは"premium"と表示されます。

以下の公開デフォルト値は、製品と同じプラン制限・機能アクセス契約から生成されます。製品に表示されるアカウント固有またはEnterprise契約のオーバーライドが優先されます。

プランAPI・MCPStudiesMinds・Audiences合成回答
Free含まれない無制限 Studies · 1 Studyに直接追加するMinds · 無制限 Studyあたりのメッセージ無制限 Minds · 3 Audiences · 20 AudienceあたりのMinds60 月あたり
Starter含まれる無制限 Studies · 7 Studyに直接追加するMinds · 無制限 Studyあたりのメッセージ無制限 Minds · 10 Audiences · 20 AudienceあたりのMinds500 月あたり
Pro含まれる無制限 Studies · 7 Studyに直接追加するMinds · 無制限 Studyあたりのメッセージ無制限 Minds · 25 Audiences · 200 AudienceあたりのMinds5,000 1席/月あたり、チーム共有
Enterprise含まれるカスタムカスタムカスタム

プランを表示

お困りですか？

APIに関するご質問やサポートが必要な場合は、以下をご利用ください：

  • ガイドを確認する
  • フィードバックフォームから問い合わせる
  • コミュニティディスカッションに参加する

n8nワークフロー

n8n用Mindsコミュニティノード を使用して、Studyの作成、リサーチプランのプレビュー、Studyや保存されたサマリーの取得、またはAI Agentへの操作の公開を行います。セルフホスト版n8nに n8n-nodes-minds をインストールし、Minds APIキーを接続します。パッケージはnpmで公開されていますが、n8nの検証は審査中のため、n8n Cloudではまだ利用できません。リサーチの確認と開始はMinds上で個別に行ってください。

エージェント向け Stripe 請求

新規サブスクリプションと回答クレジットには既存の Stripe 価格を使います。購入を提案する前に認証済みカタログを確認してください。資格、アカウント、試用、税、割引は Minds アプリと同じ請求サービスに従います。購入者の承認と、サブスクリプションの規約および撤回権に関する明示的な同意を取得してください。

1–128 文字の英字、数字、アンダースコア、ハイフンで構成される固定の Idempotency-Key を使います。タイムアウト後は同じキーと本文を再利用し、同じキーで異なる購入を送らないでください。応答は data.url と data.checkoutSessionId を返します。URL をそのまま購入者に渡してください。決済 URL は支払完了の証拠ではありません。既存サブスクリプションの変更は Minds の請求設定で行います。

{
  "kind": "subscription",
  "priceId": "price_from_catalog",
  "planType": "premium",
  "billingCountry": "DE",
  "legalAcceptance": { "termsAccepted": true, "withdrawalConsent": true }
}

MPP と x402 は所有する未払いの send_invoice 請求書に対応し、通貨は USD または EUR、残額は最低 50 最小通貨単位です。自動回収は Stripe の請求書ページを使います。支払要求は税と割引を含む実際の残額です。MPP には所有 Stripe アカウントのビジネスプロフィールが必要です。x402 には暗号資産決済資格とファシリテーター設定も必要で、USD 請求書を Base USDC で支払い、mppx のルート結合拡張が必須です。拡張のないウォレットはこのルートを支払えません。

Minds の本人確認には Authorization: Bearer を維持し、MPP 資格情報は Payment-Authorization、x402 は PAYMENT-SIGNATURE に送ります。ネイティブ MPP クライアントはこのルートに限り Authorization: Payment と、Minds bearer を入れた Minds-Authorization を使えます。モデルに見える MCP 引数に支払資格情報を入れないでください。結果不明の支払いは元の資格情報で再試行し、新しい資格情報で二重請求を起こさないでください。Stripe の確認と署名付き Webhook がサービス提供を決定します。

/openapi.json で支払方法を確認し、動的金額は 402 応答で取得します。/.well-known/acp.json は /api/acp のホスト型決済アダプター、バージョン 2026-04-17 を示します。作成時は line_items に Stripe 価格を一つ、対応する currency、capabilities: {} を指定し、metadata に billingCountry、チーム席数 quantity、購読の legalAcceptance を入れます。取得、更新、完了、取消は /checkout_sessions/{id} と /complete または /cancel を使用します。POST には冪等キーが必要です。更新と完了の本文は空です。購入者の操作が必要なら continue_url を返し、Stripe 確認後のみ完了を報告します。

UCP の検出文書は /.well-known/ucp、バージョンは 2026-08-25 です。REST 決済は /api/ucp で、MCP と請求 API と同じ Stripe セッションを使用します。互換性のあるプラットフォーム設定を公開し、同じ HTTPS オリジンにメタデータ文書を持つ Minds OAuth クライアントを使用してください。個人 API キーでは任意のプラットフォーム設定を名乗れません。各リクエストに UCP-Agent: profile="https://your-platform.example/.well-known/ucp"、書き込みには Idempotency-Key も送信します。購入者が Stripe Checkout で支払うため、決済ハンドラーは空です。

準備完了 Webhook の購読

元のリソースと同じ認証済み API キーまたは OAuth 接続を使用します。GET /api/v1/events は許可されたイベントと正確なスキーマを返します。POST /api/v1/events/subscribe は決定的な購読を作成・更新し、POST /api/v1/events/unsubscribe は元のイベント、引数、コールバック URL で購読を停止します。研究は中止しません。オーディエンスには operationId、調査には studyId と runId が必要です。MCP メソッドは events/list、events/subscribe、events/unsubscribe で、プロトコル 2026-07-28 の server/discover から検出されます。

{
  "name": "study.run.finished",
  "arguments": {
    "studyId": "163bcb31-6ca7-4fef-91bd-9b963a9dd39f",
    "runId": "663bcb31-6ca7-4fef-91bd-9b963a9dd39f"
  },
  "delivery": {
    "mode": "webhook",
    "url": "https://receiver.example/mcp-events",
    "secret": "whsec_<base64-encoded-signing-key>"
  },
  "cursor": null
}

HTTPS コールバックは署名付き検証要求の challenge を返す必要があります。Standard Webhooks のヘッダー webhook-id、webhook-timestamp、webhook-signature、X-MCP-Subscription-Id を使用します。whsec_ 鍵は復号後 24–64 バイトでなければなりません。プライベートアドレス、リダイレクト、URL の認証情報は拒否されます。検証失敗は理由付きの MCP -32015 を返し購読を有効にしません。HTTP 2xx は受信確認です。一時的な失敗は固定イベント ID と指数バックオフで有限回再試行し、410 と 413 は配信を停止します。後続操作の前にイベント ID で重複排除してください。

応答は id、refreshBefore、cursor:null、truncated:false を含みます。ttlMs で短い期間を要求でき、省略または null は最大 86400000 ミリ秒の有限の既定期間を与えます。同じ認証主体、コールバック、イベント、引数で同じ ID を更新します。鍵の交換時は短時間、新旧の鍵で署名します。期限切れやアクセス取り消しで配信は停止します。ペイロードには Bearer 認証情報や研究の回答を含めません。

Minds© 2026 Minds. あなたのターゲットオーディエンス。AIを活用し、透明な根拠に基づいています。数分で構築できます。
Minds は以下に参加しています
ESOMARGreenBookInsight PlatformsCapterraG2CSSDA Best UX Design AwardCSSDA Best Innovation AwardCSSDA Best UI Design Award