API Genel Bakış

Minds API dokümantasyonuna hoş geldiniz. API'miz, AI mind'ları programatik olarak oluşturup yönetmenizi, bilgi yüklemenizi ve onlarla etkileşim kurmanızı sağlar.

Başlarken

Minds API, REST prensipleri etrafında düzenlenmiştir. API'miz öngörülebilir kaynak odaklı URL'lere sahiptir, JSON kodlanmış istek body'leri kabul eder, JSON kodlanmış yanıtlar döndürür ve standart HTTP yanıt kodları, kimlik doğrulama ve verbler kullanır.

Base URL

Production: https://getminds.ai/api/v1 veya https://api.getminds.ai/v1

Yerel Geliştirme: http://localhost:3000/api/v1

Her iki production base URL'i tamamen eşdeğerdir. Daha temiz entegrasyon URL'leri için api.getminds.ai subdomain'i önerilir.

Kimlik Doğrulama

Tüm API endpoint'leri API key ile kimlik doğrulaması gerektirir. API key'lerinizi Settings → API Keys sayfasında oluşturup yönetebilirsiniz.

API key'inizi Authorization header'ına ekleyin:

Authorization: Bearer minds_your_api_key_here

OpenAPI Spesifikasyonu

Makine tarafından okunabilir bir OpenAPI 3.1.0 spesifikasyonu /_openapi.json adresinde yayımlanır. Spesifikasyonu tip güvenli istemciler (TypeScript, Python vb.) üretmek veya tek seferlik entegrasyon kodu için bir LLM'e bırakmak amacıyla kullan. Örnekler için OpenAPI sayfasına bak.

Content Type

Veri gönderen tüm istekler Content-Type header'ını içermelidir:

Content-Type: application/json

Dosya yüklemeleri için şunu kullanın:

Content-Type: multipart/form-data

Mevcut Endpoint'ler

Sparks

Özel yapılandırmalarla AI mind'lar (ajanlar) oluşturun ve yönetin.

GET /api/v1/sparks - Tüm spark'ları listele
GET /api/v1/sparks/{sparkId} - Spark detaylarını al
POST /api/v1/sparks - Yeni bir spark oluştur
PUT /api/v1/sparks/{sparkId} - Bir spark'ı güncelle
DELETE /api/v1/sparks/{sparkId} - Bir spark'ı sil
POST /api/v1/sparks/{sparkId}/regenerate-prompt - Bilgilerden system prompt'u yeniden oluştur

Knowledge

Mind'larınız için bilgi yönetin.

GET /api/v1/sparks/{sparkId}/knowledge - Bilgi öğelerini listele
POST /api/v1/sparks/{sparkId}/knowledge - Bilgi ekle (bağlantılar, dosyalar veya anahtar kelime araması)
PUT /api/v1/sparks/{sparkId}/knowledge/{itemId} - Bir bilgi öğesini güncelle
DELETE /api/v1/sparks/{sparkId}/knowledge/{itemId} - Bir bilgi öğesini sil
POST /api/v1/sparks/{sparkId}/knowledge/enrich - Anahtar kelime araması ile zenginleştir (kısayol)
GET /api/v1/sparks/{sparkId}/knowledge/patterns - Çerçeveye göre bilgi örüntülerini al

Chat

Chat tamamlamaları aracılığıyla mind'larınızla etkileşim kurun.

POST /api/v1/sparks/{sparkId}/completion - Mesaj gönder ve yanıt al

Panels

Mind gruplarını anketlemek için AI paneller oluşturun ve yönetin.

GET /api/v1/panels - Tüm panelleri listele
POST /api/v1/panels - Yeni bir panel oluştur
GET /api/v1/panels/{panelId} - Mesaj geçmişiyle birlikte panel detaylarını al
POST /api/v1/panels/{panelId}/ask - Paneldeki tüm mind'lara bir soru sor (SSE stream)
POST /api/v1/panels/{panelId}/export - Panel sonuçlarını rapor olarak dışa aktar
GET /api/v1/panels/{panelId}/export-status - Dışa aktarma job durumunu kontrol et
GET /api/v1/panels/{panelId}/export-download - Dışa aktarılan PDF'i indir

User

Kullanıcıyla ilgili endpoint'ler.

GET /api/v1/auth/me - Şu anki kimliği doğrulanmış kullanıcıyı al
GET /api/v1/user/shareable-sparks - Paylaşım için uygun mind'ları listele

API Keys

Kimlik doğrulama için API key'lerinizi yönetin.

GET /api/v1/api-keys - API key'lerinizi listele
POST /api/v1/api-keys - Yeni bir API key oluştur
DELETE /api/v1/api-keys/{keyId} - Bir API key'i sil

Hızlı Örnek

Bir mind oluşturup onunla sohbet etmenin hızlı bir örneği:

# 1. Bir mind oluştur (keywords modu)
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. Sosyal profilden bir mind oluştur (clone modu)
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. Mind ile sohbet et
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?"
      }
    ]
  }'

Sonraki Adımlar

Authentication hakkında bilgi edinin
Sparks endpoint'lerini keşfedin
Bilgi yönetimi hakkında okuyun
Chat tamamlamalarını anlayın
Çoklu mind anketleri için Panels oluşturun
Latency ve Performans bölümünü inceleyin
MCP Entegrasyonu üzerinden bağlanın
Hatalar ve Limitler bölümünü inceleyin

Plan Limitleri

API kullanımı, abonelik planınıza tabidir:

Plan	Mind	Flow	Mesaj/Flow
Free	1	0 (kilitli)	100
Premium	Sınırsız	Sınırsız	Sınırsız
Team	Sınırsız	Sınırsız	Sınırsız

Planları Görüntüle

Yardıma mı İhtiyacınız Var?

API ile ilgili sorularınız varsa veya destek gerekiyorsa:

Rehberimizi inceleyin
Geri bildirim formu aracılığıyla bize ulaşın
Topluluk tartışmalarımıza katılın