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

Minds

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

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

Knowledge

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

• GET /api/v1/minds/{mindId}/knowledge - Bilgi öğelerini listele
• POST /api/v1/minds/{mindId}/knowledge - Bilgi ekle (bağlantılar, dosyalar veya anahtar kelime araması)
• PUT /api/v1/minds/{mindId}/knowledge/{itemId} - Bir bilgi öğesini güncelle
• DELETE /api/v1/minds/{mindId}/knowledge/{itemId} - Bir bilgi öğesini sil
• POST /api/v1/minds/{mindId}/knowledge/enrich - Anahtar kelime araması ile zenginleştir (kısayol)
• GET /api/v1/minds/{mindId}/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/minds/{mindId}/completion - Mesaj gönder ve yanıt al

Studies

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

• GET /api/v1/studies - Tüm studyleri listele
• POST /api/v1/studies - Yeni bir study oluştur
• GET /api/v1/studies/{studyId} - Mesaj geçmişiyle birlikte study detaylarını al
• POST /api/v1/studies/{studyId}/ask - Studydeki tüm mind'lara bir soru sor (SSE stream)
• POST /api/v1/studies/{studyId}/export - Study sonuçlarını rapor olarak dışa aktar
• GET /api/v1/studies/{studyId}/export-status - Dışa aktarma job durumunu kontrol et
• GET /api/v1/studies/{studyId}/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/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. Sosyal profilden bir mind oluştur (clone modu)
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. Mind ile sohbet et
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?"
      }
    ]
  }'

Sonraki Adımlar

• Authentication hakkında bilgi edinin
• Minds endpoint'lerini keşfedin
• Bilgi yönetimi hakkında okuyun
• Chat tamamlamalarını anlayın
• Çoklu mind anketleri için Studies 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 ve MCP erişimi desteklenen ücretli planlarda sunulur. Entegrasyonunuzda limitleri sabit kodlamak yerine yapılandırılmış plan_limited ve 429 yanıtlarını işleyin. Individual planı API payload'larında "premium" olarak görünür.

Aşağıdaki herkese açık varsayılanlar, ürünün kullandığı plan limiti ve özellik erişimi sözleşmesinden oluşturulur. Üründe gösterilen hesaba veya Enterprise sözleşmesine özel geçersiz kılmalar önceliklidir.

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