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合成回答
従量課金API、MCP、標準連携を含むStudies、調査手法、エクスポートを含むワークスペースごとに 10 件の Audiences を保存 · Audience ごとに最大 200 件の Mindsいつでもチャージ。未使用の回答は繰り越されます。

プランを表示

お困りですか？

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

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

n8nワークフロー

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

エージェント向けStripe請求

レスポンスクレジットの購入を提案する前に、認証された請求カタログを使用してください。新規の顧客は従量課金制（Pay as you go）を使用し、新規のStarterサブスクリプションおよびトライアルは提供を終了しました。既存のサブスクリプション管理は引き続きMindsの請求設定で行われます。選択したレスポンスパックと最終的なStripeチェックアウト金額を承認するよう購入者に求めてください。

新しい従量課金制（Pay as you go）ワークスペースの場合、価格が正しいStripeアカウントから取得されるように、カタログの読み取りおよびチェックアウトの開始時に購入者の請求国を指定してください。購入単位はレスポンス数のままであり、各パックの単価は同じです。国が変更された場合はカタログを再度読み取ってください。

1〜128文字の英数字、アンダースコア、またはハイフンで構成される安定した Idempotency-Key でチェックアウトを開始してください。タイムアウト後も同じキーと本文を保持してください。そのキーでの購入内容の変更は拒否されます。購入者には data.url をそのまま返してください。チェックアウトURLはお支払いを証明するものではありません。署名されたStripeの履行によって共有レスポンス残高が更新されます。

{
  "kind": "response_credits",
  "amountMinor": 10000,
  "priceId": "price_from_customTopUp",
  "billingCountry": "DE"
}

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 認証情報や研究の回答を含めません。

金額を指定して回答をチャージ

請求通貨で予算を入力し、最小の定額パックと同じ単価と最低金額で、購入前に整数の回答数と正確な請求額を確認できます。購入した回答は既存の残高に加算され、明示的に承認した自動チャージにも選択できます。

responseCredits.customTopUp.priceId → priceId; amountMinor = EUR/USD × 100.

自動チャージの設定

カタログは最初の支払い前でも標準ワークスペースをprepaidとして返します。含まれる使用枠はゼロで、支払い済みの回答注文が購入数を付与します。解約は請求設定で確認し、支払い済み期間の終了時に有効になります。

自動チャージを要求する前に最新の請求カタログを取得します。kind: auto_recharge と responseCredits.customTopUp の基本価格を使い、予算、残高のしきい値、月間上限を最小通貨単位の整数で送信してください。Idempotency-Key により再試行で同じ同意セッションが返されます。応答はStripe設定URLであり、請求管理者がセッションを完了するまで自動請求は有効になりません。予約済みの自動請求がある場合、通貨変更は競合を返すことがあります。

{
  "kind": "auto_recharge",
  "priceId": "price_from_customTopUp",
  "amountMinor": 10000,
  "thresholdAmountMinor": 500,
  "monthlyAmountLimit": 19992
}

responseCredits.customTopUp.priceId → priceId; amountMinor, thresholdAmountMinor, monthlyAmountLimit = EUR/USD × 100; monthlyAmountLimit: "none".

POST /api/v1/billing/checkout + Idempotency-Key / start_billing_checkout + idempotencyKey → Stripe Checkout mode=setup.

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