SpeakNotesSpeakNotes
Başlayın

SpeakNotes API dokümantasyonu

SpeakNotes API, ses, video, YouTube bağlantıları ve belgeleri transkriptlere ve yapılandırılmış özetlere dönüştürür. OpenAPI 3.1 spesifikasyonuna, bir temsilci beceri dosyasına ve yapay zeka istemcileri için bir MCP sunucusuna sahip bir REST API'dir.

Temel URL

Her SpeakNotes API isteği, HTTPS üzerinden tek bir ana bilgisayara gider.

https://api.speaknotes.io

Kimlik Doğrulama

Her uç nokta kimlik doğrulaması gerektirir. Bir SpeakNotes API anahtarını taşıyıcı belirteç (bearer token) olarak veya oturum açmış bir oturumdan çağrı yapıyorsanız bir Firebase kimlik belirteci gönderin. Kimliği doğrulanmamış istekler reddedilir.

Authorization: Bearer YOUR_API_KEY

Anahtarları şurada oluşturun ve iptal edin: Ayarlar, API anahtarları. Oturum açmış her kullanıcı sayfayı görüntüleyebilir; anahtar oluşturmak aktif bir Pro planı gerektirir.

Uç Noktalar

Yüklemeler ve YouTube işleri eşzamansız çalışır: notu oluşturun, ardından işleme bitene kadar durumunu sorgulayın.

  • GET/v1Describe the API
  • GET/v1/healthCheck the API is up
  • GET/v1/notesList notes
  • POST/v1/notesCreate a note from text
  • GET/v1/notes/{id}Get a note
  • PATCH/v1/notes/{id}Update a note
  • DELETE/v1/notes/{id}Delete a note
  • GET/v1/notes/{id}/statusGet processing status
  • GET/v1/notes/{id}/transcriptGet a transcript
  • POST/v1/notes/{id}/questionsAsk a question about a note
  • GET/v1/foldersList folders
  • POST/v1/foldersCreate a folder
  • GET/v1/folders/{id}Get a folder
  • PATCH/v1/folders/{id}Rename a folder
  • DELETE/v1/folders/{id}Delete a folder
  • POST/v1/uploadsStart a media upload
  • POST/v1/uploads/{id}/completeFinish an upload and start processing
  • POST/v1/transcriptionsTranscribe audio from a URL
  • POST/v1/summariesSummarize text
  • POST/v1/youtube-summariesSummarize a YouTube video
  • GET/v1/usageGet credit balance and usage

MCP sunucusu

SpeakNotes, Streamable HTTP üzerinden bir Model Context Protocol sunucusu çalıştırır, böylece MCP istemcileri transkripsiyon ve özetleme işlemlerini araç olarak çağırabilir. REST API ile aynı taşıyıcı (bearer) API anahtarını kullanır.

https://api.speaknotes.io/mcp

Geliştirici kaynakları