SpeakNotesSpeakNotes
Mulai

Dokumentasi API SpeakNotes

API SpeakNotes mengubah audio, video, tautan YouTube, dan dokumen menjadi transkrip dan ringkasan terstruktur. Ini adalah REST API dengan spesifikasi OpenAPI 3.1, file keterampilan agen, dan server MCP untuk klien AI.

Base URL

Setiap permintaan API SpeakNotes ditujukan ke satu host melalui HTTPS.

https://api.speaknotes.io

Otentikasi

Setiap endpoint memerlukan otentikasi. Kirim kunci API SpeakNotes sebagai token pembawa (bearer token), atau token ID Firebase jika Anda memanggil dari sesi yang sudah masuk. Permintaan yang tidak terotentikasi akan ditolak.

Authorization: Bearer YOUR_API_KEY

Buat dan cabut kunci di Pengaturan, kunci API. Setiap pengguna yang masuk dapat melihat halaman tersebut; membuat kunci memerlukan paket Pro aktif.

Endpoint

Unggahan dan pekerjaan YouTube berjalan secara asinkron: buat catatan, lalu polling statusnya hingga pemrosesan selesai.

  • POST/youtube-checkValidasi URL YouTube dan periksa batas durasi
  • POST/youtube-summaryBuat catatan dari YouTube dan mulai peringkasan
  • POST/upload-urlBuat catatan dan dapatkan URL unggahan media yang ditandatangani
  • POST/upload-completeKonfirmasi unggahan media dan mulai pemrosesan
  • POST/pdf-upload-urlBuat catatan dan dapatkan URL unggah dokumen yang ditandatangani
  • POST/pdf-upload-completeKonfirmasi unggahan dokumen dan mulai pemrosesan
  • GET/api/v1/notesDaftar catatan Anda
  • GET/api/v1/notes/{id}Ambil satu catatan
  • GET/api/v1/notes/{id}/statusPeriksa status pemrosesan untuk sebuah catatan
  • GET/api/v1/foldersDaftar folder Anda
  • GET/api/v1/folders/{id}Ambil satu folder

Server MCP

SpeakNotes menjalankan server Model Context Protocol melalui HTTP yang dapat dialirkan, sehingga klien MCP dapat memanggil transkripsi dan ringkasan sebagai alat. Server ini menggunakan kunci API bearer yang sama dengan REST API.

https://api.speaknotes.io/mcp

Sumber daya pengembang