Minds Team

API 개요

minds 및 지식 관리에 프로그래밍 방식으로 액세스하기 위한 Minds API 소개.

Minds API 문서에 오신 것을 환영합니다. Minds API를 사용하면 프로그래밍 방식으로 AI minds를 생성 및 관리하고, 지식을 업로드하며, 이들과 상호작용할 수 있습니다.

시작하기

Minds API는 REST 원칙을 기반으로 설계되었습니다. 예측 가능한 리소스 지향적 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 키를 통한 인증이 필요합니다. Settings → API Keys에서 API 키를 생성하고 관리할 수 있습니다.

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 minds(에이전트)를 생성하고 관리합니다.

  • 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

minds를 위한 지식을 관리합니다.

  • 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

챗 컴플리션(chat completions)을 통해 minds와 상호작용합니다.

  • POST /api/v1/minds/{mindId}/completion - 메시지 전송 및 응답 수신

Studies

여러 minds 그룹을 조사하기 위한 AI studies를 생성하고 관리합니다.

  • GET /api/v1/studies - 모든 study 목록 조회
  • POST /api/v1/studies - 새로운 study 생성
  • GET /api/v1/studies/{studyId} - 메시지 기록을 포함한 study 상세 정보 조회
  • POST /api/v1/studies/{studyId}/ask - 모든 study minds에 질문하기 (SSE 스트림)
  • POST /api/v1/studies/{studyId}/export - study 결과를 보고서로 내보내기
  • 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 - 공유 가능한 minds 목록 조회

API Keys

인증용 API 키를 관리합니다.

  • GET /api/v1/api-keys - API 키 목록 조회
  • POST /api/v1/api-keys - 새로운 API 키 생성
  • DELETE /api/v1/api-keys/{keyId} - API 키 삭제

빠른 예시

다음은 mind를 생성하고 대화를 나누는 간단한 예시입니다:

# 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 좌석/월당, 팀 공유
Enterprise포함맞춤형맞춤형맞춤형

요금제 보기

도움이 필요하신가요?

API와 관련하여 질문이 있거나 지원이 필요한 경우:

  • 가이드 확인하기
  • 피드백 양식을 통해 문의하기
  • 커뮤니티 토론 참여하기

n8n 워크플로우

n8n용 Minds 커뮤니티 노드를 사용하여 Study를 생성하고, 연구 계획을 미리 보고, Study 및 저장된 요약을 검색하거나, 작업을 AI 에이전트에 노출하세요. 자체 호스팅 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는 암호화폐 결제 자격과 결제 중개 서비스 설정도 필요하며 Base USDC로 USD 청구서를 지원하고 mppx 경로 바인딩 확장을 요구합니다. 이 확장이 없는 지갑은 이 경로를 결제할 수 없습니다.

Minds 인증에는 Authorization: Bearer를 유지하고 MPP 자격 증명은 Payment-Authorization, x402는 PAYMENT-SIGNATURE로 보냅니다. 네이티브 MPP 클라이언트는 이 경로에서만 Authorization: Payment와 Minds bearer가 담긴 Minds-Authorization을 사용할 수 있습니다. 모델에 보이는 MCP 인수에 결제 자격 증명을 넣지 마세요. 결과가 불확실한 결제는 원래 자격 증명으로 재시도하며 새 자격 증명으로 추가 청구를 만들지 않습니다. Stripe 확인과 서명된 웹훅이 서비스 제공을 결정합니다.

/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