Uygulamayı aç
Moonborn — Developers

Hızlı başlangıç

Beş dakikada ilk persona'nı (karakter) üret ve onunla bir mesaj alışverişi yap.

Bu rehber, Moonborn'la ilk persona'nı (karakter) üretip onunla bir sohbet oturumunda mesaj alışverişi yapmana yardım eder. Yaklaşık beş dakika sürer. Bilgisayarında sadece curl olması yeterli — TypeScript veya Python tercih edersen her adımın SDK karşılığı da var.

Sonunda elinde şunlar olacak:

  • Bir persona kimliği (per_...)
  • Bir sohbet oturumu (chat session) kimliği (ses_...)
  • Persona'nın kendi sesinde verdiği ilk yanıt mesajı

1. API anahtarı oluştur

moonborn.co adresine kaydol; ardından Settings → API Keys → New key ile bir API anahtarı (API key) üret. Hızlı başlamak için bir test anahtarı seç — test çalışma alanına (workspace) bağlıdır ve production (üretim) verisinden izoledir.

Anahtarı bir ortam değişkenine kaydet:

export MOONBORN_API_KEY=sk_test_...

Üretime çıktığında sk_live_* ile başlayan bir anahtar kullanacaksın; bunu bir veritabanı parolası gibi sakla. Detaylı kurulum için Kimlik doğrulama sayfasına bak.

2. İlk persona'yı üret

Bir cümlelik niyet metni (intent) yeter. Moonborn bu cümleden içten dışa kurulan dört katmanlı bir karakter çıkarır.

curl -X POST https://api.moonborn.co/v1/personas \
  -H "Authorization: Bearer $MOONBORN_API_KEY" \
  -H "Content-Type: application/json" \
  -d "{
    \"intent\": \"İstanbul'da yaşayan, altmışlı yaşlarında, bahçesine takıntılı emekli bir cerrah.\"
  }"

Beklenen yanıt (kısaltılmış):

{
  "id": "per_01H...",
  "surface": { "name": { "display": "Cem Aksoy" } },
  "soul": { "desire": "...", "fear": "..." },
  "self": { "traits": ["methodical", "patient"] },
  "mask": { "voice": "..." },
  "audit": { "score": 4.3, "passed": true }
}

id alanını kopyala — sonraki adımda kullanacaksın. Üretim genelde 30–90 saniye sürer; arka planda Soul (motivasyon), Self (özellikler), Mask (ses) ve Surface (demografi) katmanları sırayla kurulur, ardından denetim (audit) ve voice fingerprint (sesin parmak izi) hesaplanır.

3. Bir sohbet oturumu başlat

Oturum aç ve ilk mesajı gönder. Persona kimliğini önceki adımdan al.

SESSION=$(curl -s -X POST https://api.moonborn.co/v1/chat/sessions \
  -H "Authorization: Bearer $MOONBORN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"personaId": "per_01H..."}' | jq -r .id)
 
curl -X POST https://api.moonborn.co/v1/chat/messages \
  -H "Authorization: Bearer $MOONBORN_API_KEY" \
  -H "Content-Type: application/json" \
  -d "{\"sessionId\": \"$SESSION\", \"content\": \"Seni en çok ne tetikler?\"}"

Beklenen yanıt (kısaltılmış):

{
  "id": "msg_01H...",
  "content": "Düzen. Bir günü plansız bırakırsam ertesi gün başkasının olur.",
  "driftScore": 0.12,
  "driftAlert": false
}

content persona'nın kendi sesinde verdiği yanıt. driftScore mesajın karakterin voice fingerprint'ine ne kadar yakın olduğunu söyler — 0'a yakınsa karakterde, eşiğin (threshold) üstündeyse uyarı tetiklenir (varsayılan eşik 0.30).

Başardın

Terminalde bir per_... kimliği, bir ses_... kimliği ve son adımda content alanı dolu bir mesaj döndüyse hızlı başlangıç bitti. Persona'yı bir kez ürettin, oturum açtın ve karakterden kendi sesinde bir yanıt aldın.

Sonraki adım

Geldiğin yere göre öneri: