SpeakNotes API, MCP sunucusu ve OAuth platformu
Ses, video ve YouTube bağlantılarını kendi kodunuzdan transkriptlere ve yapılandırılmış özetlere dönüştürün veya bir yapay zeka aracısının bunu MCP aracılığıyla yapmasına izin verin. Her hesap bir anahtar oluşturabilir ve sandbox ortamında ücretsiz olarak başlayabilir.
- Panodan kendi anahtarınızı oluşturun. Satış görüşmesi yok, bekleme listesi yok.
- Sandbox anahtarları sabit çıktı döndürür, kredi harcamaz ve gerçek notlarınıza asla dokunmaz.
- Claude, ChatGPT ve Cursor'ın SpeakNotes'u yerel olarak kullanabilmesi için barındırılan bir MCP sunucusu.
İlk özetinize ulaşmak için üç istek
Yapıyı öğrenmek için bir sandbox anahtarıyla başlayın, ardından yanıtlar doğru göründüğünde canlı bir anahtara geçin.
- 1
Bir anahtar oluşturun
Ayarlar'ı, API anahtarlarını açın ve bir tane oluşturun. Deneme yapmak için sandbox'ı veya gerçek sesleri işlemek için canlı olanı seçin.
# Any signed-in account can create one. Sandbox keys start sn_test_. open https://speaknotes.io/settings/api-keys
- 2
API'yi çağırın
Anahtarı bearer token olarak gönderin. Özetler, transkripsiyonlar ve YouTube işleri satır içi olarak yanıt verir.
curl -X POST https://api.speaknotes.io/v1/summaries \ -H "Authorization: Bearer $SPEAKNOTES_API_KEY" \ -H "Content-Type: application/json" \ -d '{"text": "...your transcript...", "styleId": "meeting-notes"}' - 3
Daha uzun medya yükleyin
Yüklemeler arka planda çalışır: yüklemeyi oluşturun, dosyayı PUT ile gönderin, tamamlayın ve not bitene kadar sorgulayın.
# 1. create the upload curl -X POST https://api.speaknotes.io/v1/uploads \ -H "Authorization: Bearer $SPEAKNOTES_API_KEY" \ -H "Content-Type: application/json" \ -d '{"fileName": "standup.m4a", "contentType": "audio/mp4"}' # 2. PUT the file to uploadUrl, then complete it curl -X POST https://api.speaknotes.io/v1/uploads/NOTE_ID/complete \ -H "Authorization: Bearer $SPEAKNOTES_API_KEY" # 3. poll until status is Done curl https://api.speaknotes.io/v1/notes/NOTE_ID/status \ -H "Authorization: Bearer $SPEAKNOTES_API_KEY"
Platform size neler sunuyor
Okuma ve yazma yapabilen bir REST API
Notları ve klasörleri listeleyin, oluşturun, güncelleyin ve silin. Sesleri yazıya dökün, metinleri özetleyin ve YouTube bağlantılarını özetleyin. Her işlem OpenAPI 3.1 spesifikasyonundadır.
Barındırılan bir MCP sunucusu
api.speaknotes.io/mcp adresinde, aynı okuma ve yazma işlemlerini kapsayan on üç araçla yayınlanabilir HTTP. Ajanlar OAuth üzerinden veya bir anahtarla bağlanır.
PKCE ile OAuth 2.1
Diğer SpeakNotes kullanıcıları adına hareket eden bir uygulama oluşturun. Dinamik istemci kaydı, bir MCP istemcisinin kendi kendini kaydedebileceği ve kimse anahtar yapıştırmadan bağlanabileceği anlamına gelir.
Gerçek bir sandbox
sn_test_ ile başlayan anahtarlar, her rotayı, doğrulama kuralını ve yanıt şeklini sabit çıktıya karşı çalıştırır. Kredi yok, model çağrısı yok ve yazma işlemleri ayrı bir sandbox kütüphanesine kaydedilir.
Görebileceğiniz krediler
Bir kredi, bir dakikalık medyanın işlenmesidir. Ücretli olan her yanıt, ne kadar ücret kesildiğini ve ne kadar kaldığını döndürür, böylece bir ajan başlamadan önce kontrol edebilir.
Kapsamlı kimlik bilgileri
Bir anahtara veya uygulamaya yalnızca ihtiyacı olanı verin. Salt okunur bir anahtar notları listeleyebilir ancak asla birini silemez.
Fiyatlandırma
Her hesap, her ay sıfırlanan aylık bir kredi hibesi alır. Pro hesaplar çok daha fazlasını alır. Bunun ötesinde, krediler ön ödemelidir, bu nedenle kontrolsüz bir yeniden deneme döngüsü asla fatura çıkaramaz.
Referans
- Hızlı başlangıçSıfırdan çalışan bir özete, curl ile.
- Kimlik doğrulama ve kapsamlarAPI anahtarları, sandbox anahtarları, kapsamlar ve hız sınırları.
- OAuth 2.1PKCE ile yetkilendirme kodu, dinamik istemci kaydı, yenileme ve iptal.
- Hata kodlarıAPI'nin döndürebileceği her kod ve her biri hakkında ne yapılması gerektiği.
- Krediler ve fiyatlandırmaHer işlemin maliyeti ve nasıl yükleme yapılacağı.
- OpenAPI 3.1 spesifikasyonuHer işlem için makine tarafından okunabilir sözleşme.
- MCP manifestosu/.well-known/mcp.json adresinde sunucu adı, taşıma ve araç listesi.
- Ajan yetenek dosyasıAjan çalışma zamanları için hazır SKILL.md dosyası.
Geliştiricilerin sorduğu sorular
- SpeakNotes API'sini kullanmak ücretsiz mi?
- Her hesap her ay ücretsiz olarak 60 kredi alır ve sandbox anahtarları sonsuza kadar sınırsız ve ücretsizdir. Pro hesaplar ayda 2.000 kredi alır. Aylık verilen kredinin ötesinde, ön ödemeli kredi paketleri satın alırsınız.
- Nasıl SpeakNotes API anahtarı alabilirim?
- Oturum açın ve Ayarlar, API anahtarları bölümünü açın. Anahtarı kendiniz oluşturursunuz ve hemen çalışır. Başvuru süreci veya iletişim formu yoktur.
- SpeakNotes'un bir sandbox ortamı var mı?
- Evet. Sandbox seçeneğiyle oluşturduğunuz her anahtar sn_test_ ile başlar. Bir modeli çağırmadan, kredi harcamadan veya gerçek notlarınıza yazmadan her rotayı çalıştırır ve sabit, gerçekçi bir çıktı döndürür.
- SpeakNotes'u Claude veya başka bir MCP istemcisine nasıl bağlarım?
- İstemciyi Streamable HTTP üzerinden https://api.speaknotes.io/mcp adresine yönlendirin. OAuth destekleyen istemciler kendilerini kaydeder ve sizden yetkilendirme ister; desteklemeyen istemciler ise bir SpeakNotes API anahtarını bearer token olarak gönderebilir.
- SpeakNotes API, OAuth destekliyor mu?
- Evet. SpeakNotes; PKCE, yenileme belirteci rotasyonu, dinamik istemci kaydı ve iptal özelliklerine sahip bir OAuth 2.1 yetkilendirme sunucusu çalıştırır. Meta veriler https://speaknotes.io/.well-known/oauth-authorization-server adresinde yayınlanmaktadır.
- SpeakNotes API hız sınırları nelerdir?
- Kimlik bilgisi başına hesaplanan dakikada 120 okuma isteği, 30 yazma isteği ve 10 işleme isteği sınırı vardır. Her yanıt, hız sınırı başlıklarında kalan bütçeyi taşır ve 429 hatası size tam olarak ne kadar beklemeniz gerektiğini söyler.