SpeakNotes API, MCP server และแพลตฟอร์ม OAuth

สามขั้นตอนสู่สรุปเนื้อหาแรกของคุณ

เริ่มต้นด้วยคีย์แซนด์บ็อกซ์เพื่อเรียนรู้รูปแบบ แล้วเปลี่ยนเป็นคีย์ใช้งานจริงเมื่อผลลัพธ์ถูกต้องตามต้องการ

1. 1

   สร้างคีย์

   เปิดการตั้งค่า (Settings) ไปที่ API keys แล้วสร้างคีย์ เลือกแซนด์บ็อกซ์เพื่อทดลองใช้งาน หรือเลือกใช้งานจริงเพื่อประมวลผลไฟล์เสียงจริง

   # Any signed-in account can create one. Sandbox keys start sn_test_.
   open https://speaknotes.io/settings/api-keys

2. 2

   เรียกใช้ API

   ส่งคีย์ในรูปแบบ bearer token งานสรุปเนื้อหา การถอดความ และงานจาก YouTube จะตอบกลับแบบอินไลน์

   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. 3

   อัปโหลดสื่อที่มีความยาวมากขึ้น

   การอัปโหลดจะทำงานในเบื้องหลัง: สร้างการอัปโหลด, PUT ไฟล์, ทำให้เสร็จสมบูรณ์ จากนั้นตรวจสอบสถานะโน้ตจนกว่าจะเสร็จสิ้น

   # 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"

สิ่งที่คุณจะได้รับจากแพลตฟอร์ม

ราคา

ทุกบัญชีจะได้รับเครดิตรายเดือนที่จะรีเซ็ตใหม่ บัญชี Pro จะได้รับเครดิตจำนวนมากขึ้น นอกเหนือจากนั้น เครดิตจะเป็นแบบเติมเงิน ดังนั้นการวนซ้ำที่ผิดพลาดจะไม่ทำให้เกิดค่าใช้จ่ายเกินงบ

ข้อมูลอ้างอิง

• เริ่มต้นใช้งานด่วนจากศูนย์สู่การสรุปผลที่ใช้งานได้จริง ด้วย curl
• การยืนยันตัวตนและขอบเขตสิทธิ์คีย์ API, คีย์แซนด์บ็อกซ์, ขอบเขตสิทธิ์ และขีดจำกัดอัตราการเรียกใช้
• OAuth 2.1รหัสการอนุญาตพร้อม PKCE, การลงทะเบียนไคลเอ็นต์แบบไดนามิก, การรีเฟรช และการเพิกถอนสิทธิ์
• รหัสข้อผิดพลาดรหัสทั้งหมดที่ API สามารถส่งกลับได้และวิธีแก้ไขสำหรับแต่ละรหัส
• เครดิตและราคาค่าใช้จ่ายของแต่ละการดำเนินการ และวิธีการเติมเครดิต
• ข้อมูลจำเพาะ OpenAPI 3.1สัญญาที่เครื่องอ่านได้สำหรับการดำเนินการทุกอย่าง
• MCP manifestชื่อเซิร์ฟเวอร์, การขนส่ง และรายการเครื่องมือที่ /.well-known/mcp.json
• ไฟล์ทักษะเอเจนต์ (Agent skill file)ไฟล์ SKILL.md สำหรับรันไทม์ของเอเจนต์

คำถามที่นักพัฒนามักถาม

SpeakNotes API ใช้งานฟรีหรือไม่?

ทุกบัญชีจะได้รับ 60 เครดิตต่อเดือนโดยไม่มีค่าใช้จ่าย และคีย์แซนด์บ็อกซ์นั้นไม่จำกัดและฟรีตลอดไป บัญชี Pro จะได้รับ 2,000 เครดิตต่อเดือน นอกเหนือจากเครดิตรายเดือน คุณสามารถซื้อแพ็กเกจเครดิตแบบเติมเงินได้

ฉันจะรับคีย์ SpeakNotes API ได้อย่างไร?

ลงชื่อเข้าใช้และเปิดไปที่การตั้งค่า (Settings) แล้วเลือกคีย์ API คุณสามารถสร้างคีย์ได้ด้วยตัวเองและใช้งานได้ทันที ไม่ต้องผ่านกระบวนการสมัครและไม่มีแบบฟอร์มติดต่อ

SpeakNotes มีสภาพแวดล้อมแซนด์บ็อกซ์หรือไม่?

มี คีย์ใดก็ตามที่คุณสร้างด้วยตัวเลือกแซนด์บ็อกซ์จะขึ้นต้นด้วย sn_test_ ซึ่งจะทดสอบทุกเส้นทางและส่งคืนผลลัพธ์ที่คงที่และสมจริงโดยไม่ต้องเรียกใช้โมเดล ไม่เสียเครดิต และไม่เขียนลงในโน้ตจริงของคุณ

ฉันจะเชื่อมต่อ SpeakNotes กับ Claude หรือไคลเอ็นต์ MCP อื่นได้อย่างไร?

ชี้ไคลเอ็นต์ไปที่ https://api.speaknotes.io/mcp ผ่าน Streamable HTTP ไคลเอ็นต์ที่รองรับ OAuth จะลงทะเบียนตัวเองและแจ้งให้คุณอนุญาต ส่วนไคลเอ็นต์ที่ไม่รองรับสามารถส่งคีย์ SpeakNotes API เป็น bearer token ได้

SpeakNotes API รองรับ OAuth หรือไม่?

รองรับ SpeakNotes รันเซิร์ฟเวอร์การอนุญาต OAuth 2.1 พร้อม PKCE, การหมุนเวียนรีเฟรชโทเค็น, การลงทะเบียนไคลเอ็นต์แบบไดนามิก และการเพิกถอนสิทธิ์ ข้อมูลเมตาถูกเผยแพร่ที่ https://speaknotes.io/.well-known/oauth-authorization-server

ขีดจำกัดอัตราการเรียกใช้ SpeakNotes API คือเท่าใด?

คำขออ่าน 120 ครั้ง, คำขอเขียน 30 ครั้ง และคำขอประมวลผล 10 ครั้งต่อนาที โดยนับตามข้อมูลรับรอง ทุกการตอบกลับจะมีงบประมาณที่เหลืออยู่ในส่วนหัวของอัตราการเรียกใช้ และรหัส 429 จะบอกคุณว่าต้องรอนานเท่าใด