SpeakNotesSpeakNotes
เริ่มต้นใช้งาน

เอกสารประกอบ SpeakNotes API

SpeakNotes API ช่วยเปลี่ยนไฟล์เสียง วิดีโอ ลิงก์ YouTube และเอกสารให้เป็นข้อความถอดความและสรุปเนื้อหาที่มีโครงสร้าง เป็น REST API ที่มีสเปก OpenAPI 3.1 ไฟล์ทักษะสำหรับเอเจนต์ และเซิร์ฟเวอร์ MCP สำหรับไคลเอ็นต์ AI

Base URL

คำขอ SpeakNotes API ทุกรายการจะส่งไปยังโฮสต์เดียวผ่าน HTTPS

https://api.speaknotes.io

การยืนยันตัวตน

ทุก Endpoint จำเป็นต้องมีการยืนยันตัวตน โปรดส่ง SpeakNotes API key ในรูปแบบ Bearer token หรือ Firebase ID token หากคุณเรียกใช้จากเซสชันที่ลงชื่อเข้าใช้แล้ว คำขอที่ไม่มีการยืนยันตัวตนจะถูกปฏิเสธ

Authorization: Bearer YOUR_API_KEY

สร้างและเพิกถอนคีย์ได้ใน การตั้งค่า (Settings), API keys. ผู้ใช้ที่ลงชื่อเข้าใช้ทุกคนสามารถดูหน้านี้ได้ แต่การสร้างคีย์จำเป็นต้องมีแผน Pro ที่ใช้งานอยู่

Endpoints

งานอัปโหลดและงานจาก YouTube จะทำงานแบบอะซิงโครนัส: สร้างบันทึกย่อ จากนั้นตรวจสอบสถานะจนกว่าการประมวลผลจะเสร็จสิ้น

  • 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

SpeakNotes รันเซิร์ฟเวอร์ Model Context Protocol ผ่าน Streamable HTTP เพื่อให้ไคลเอ็นต์ MCP สามารถเรียกใช้การถอดความและการสรุปเนื้อหาเป็นเครื่องมือได้ โดยใช้ Bearer API key เดียวกันกับ REST API

https://api.speaknotes.io/mcp

ทรัพยากรสำหรับนักพัฒนา