OverviewAuthenticationMindsKnowledgeChatLatencyErrors
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

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

Sparks

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

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

Knowledge

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

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

Chat

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

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

Panels

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

  • GET /api/v1/panels - すべてのパネルを一覧表示
  • POST /api/v1/panels - 新規パネルを作成
  • GET /api/v1/panels/{panelId} - メッセージ履歴を含むパネルの詳細を取得
  • POST /api/v1/panels/{panelId}/ask - パネル内のすべてのマインドに質問を送信（SSEストリーム）
  • POST /api/v1/panels/{panelId}/export - パネル結果をレポートとしてエクスポート
  • GET /api/v1/panels/{panelId}/export-status - エクスポートジョブのステータスを確認
  • GET /api/v1/panels/{panelId}/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/sparks" \
  -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": "spark-id", ... }, "processing": { "queued": true, ... } }

# 2. Create a mind from social profile (clone mode)
curl -X POST "https://getminds.ai/api/v1/sparks" \
  -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/sparks/spark-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の使用制限は、ご契約のサブスクリプションプランによって異なります：

プランマインドフローメッセージ/フロー
Free10（ロック）100
Premium無制限無制限無制限
Team無制限無制限無制限

プランを表示

お困りですか？

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

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