# Sonecentral metin asistanı API'si

> Sonecentral metin asistanını kendi uygulamanızdan ve sitenizden çağırmak için genel API. OpenAI Chat Completions, OpenAI Responses ve Vercel AI SDK biçimleriyle çalışır; yanıtı WhatsApp'taki aynı asistan verir.

API adresi: https://pb.sonecentral.com/api/v1. Dokümanın tamamı tek dosyada: https://docs.sonecentral.com/llms-full.txt. Aşağıdaki her bağlantı bir sayfanın Markdown halidir.

## Başlarken

- [Giriş](https://docs.sonecentral.com/index.md): Sonecentral metin asistanınızı kendi uygulamanızdan ve sitenizden, sektörün bildiği OpenAI ve Vercel AI SDK biçimleriyle çağırın.
- [Hızlı başlangıç](https://docs.sonecentral.com/hizli-baslangic.md): Anahtarınızı oluşturun, asistanınızın kimliğini bulun ve ilk mesajı gönderin.
- [Kimlik doğrulama ve anahtarlar](https://docs.sonecentral.com/kimlik-dogrulama.md): Sunucu anahtarı ile tarayıcı anahtarı arasındaki fark, anahtarın nasıl gönderildiği, izin verilen siteler ve anahtarın nasıl iptal edildiği.

## Uç noktalar

- [Asistanlar ve modeller](https://docs.sonecentral.com/asistanlar-ve-modeller.md): model alanına ne yazılır, asistanlar nasıl listelenir ve "default" ne anlama gelir.
- [Chat Completions](https://docs.sonecentral.com/chat-completions.md): POST /chat/completions ile OpenAI Chat Completions biçiminde mesaj gönderin; yanıtın sone alanı sohbetin kimliğini, durumunu ve zengin mesajları taşır.
- [Responses API](https://docs.sonecentral.com/responses.md): POST /responses ile OpenAI Responses biçiminde konuşun; sohbeti previous_response_id ya da conversation ile sürdürün, saklanan yanıtları okuyun ve silin.
- [Vercel AI SDK](https://docs.sonecentral.com/vercel-ai-sdk.md): useChat ile tarayıcıdan doğrudan /chat uç noktasına bağlanın, zengin mesajları tipli veri parçaları olarak çizin; ya da sunucuda OpenAI sağlayıcısıyla generateText ve streamText kullanın.

## Sohbet

- [Akış](https://docs.sonecentral.com/akis.md): Akışlı yanıtlar nasıl gelir, bağlantı nasıl canlı tutulur ve metin neden kelime kelime değil mesaj mesaj ilerler.
- [Zengin mesajlar](https://docs.sonecentral.com/zengin-mesajlar.md): Ürün ve hizmet kartları, düğmeler, hızlı yanıtlar ve dosyalar SoneMessage nesnesi olarak gelir; her birinin düz metin karşılığı da vardır.
- [Sohbet sürekliliği](https://docs.sonecentral.com/sohbet-surekliligi.md): Anonim bir ziyaretçinin sohbeti sayfa yenilense de nasıl sürer, Sonecentral bir isteği hangi sohbete nasıl bağlar ve yeniden gönderilen bir mesajı nasıl tanır.
- [Site içine sohbet penceresi](https://docs.sonecentral.com/sohbet-penceresi.md): Sitenizin köşesinde açılan, asistanınızla konuşan bir sohbet penceresi. Kopyalayıp yapıştırabileceğiniz düz HTML ve JavaScript ile React ve Next.js sürümü.
- [İnsan devri ve ekip yanıtları](https://docs.sonecentral.com/insan-devri.md): Asistan sohbeti ekibinize devrettiğinde ne olur, ekibin yanıtları ziyaretçiye nasıl ulaşır.

## Kurallar

- [Siparişler, randevular ve gizlilik](https://docs.sonecentral.com/siparis-randevu-gizlilik.md): API ziyaretçisi neyi yapabilir, neyi göremez. Sipariş ve randevu talepleri ekibin onayını bekler; kişisel kayıtlar API ziyaretçisine hiç açılmaz.
- [Hatalar](https://docs.sonecentral.com/hatalar.md): Hata yanıtının biçimi, bütün hata kodları, hangisinin yeniden denenebileceği ve her birinde ne yapılacağı.
- [Limitler](https://docs.sonecentral.com/limitler.md): İstek sınırları, otomatik yanıt sınırı, sohbet ve mesaj sınırları, saklanan yanıtlar, dosya ve anahtar sınırları.
- [Sık sorulan sorular](https://docs.sonecentral.com/sss.md): Yanıtların neden mesaj mesaj geldiği, modelin değiştirilip değiştirilemeyeceği, human durumunun anlamı, kaybolan anahtar, yeniden deneme ve benzeri sorular.
- [Sürüm notları](https://docs.sonecentral.com/surum-notlari.md): API'deki değişiklikler, en yenisi üstte.