FTIR.fun FTIR.fun
การผสานรวมนักพัฒนาและ AI

เชื่อมต่อ FTIR.fun กับเครื่องมือ AI หรือแอปใดๆ

ให้ผู้ช่วย AI หรือโค้ดของคุณเข้าถึงสเปกตรัมอ้างอิงมากกว่า 130,000 รายการ การใช้เหตุผลพีคจากกราฟความรู้ และการตีความที่ได้รับการสนับสนุนจากวรรณกรรมโดยตรง เลือกหนึ่งในสามวิธีในการเชื่อมต่อ — MCP สำหรับผู้ช่วย AI, REST API สำหรับโค้ด, หรือ Skill สำเร็จรูปสำหรับแพลตฟอร์มที่ไม่ต้องเขียนโค้ด แต่ละเส้นทางด้านล่างมีคำแนะนำทีละขั้นตอนที่เขียนสำหรับผู้ใช้ครั้งแรก

1. เลือกเส้นทางของคุณ 2. การตั้งค่า MCP 3. REST API 4. ทักษะและปลั๊กอิน 5. สิ่งที่ AI ของคุณสามารถทำได้ 6. การแก้ปัญหา
รีวิวและแสดงอยู่ใน

ก่อนเริ่ม — รับคีย์ API ของคุณ

MCP และ REST API ต่างใช้คีย์ API FTIR.fun เดียวกัน Coze/Doubao ใช้คีย์บริการที่ผู้เผยแพร่ปลั๊กอินกำหนดค่าไว้ ดังนั้นผู้ใช้ปลายทางไม่ต้องวางคีย์ส่วนตัว การรับคีย์ส่วนตัวใช้เวลาประมาณหนึ่งนาที:

  1. ลงชื่อเข้าใช้ FTIR.fun สร้างบัญชีฟรีหากคุณยังไม่มี บัญชีใหม่รวมถึงเครดิตทดลองใช้ฟรี
  2. เปิดแดชบอร์ดคีย์ API ไปที่ บัญชี → คีย์ API และคลิกสร้าง
  3. คัดลอกและบันทึกคีย์ทันที คีย์เต็ม (ขึ้นต้นด้วย ftir_) แสดงเพียงครั้งเดียว เก็บไว้ในที่ปลอดภัย หากคุณทำหาย เพียงสร้างใหม่
🔑 พร้อมแล้ว? เปิดแดชบอร์ดคีย์ API ในแท็บใหม่ จากนั้นกลับมาและทำตามเส้นทางที่คุณเลือกไว้ด้านบน
⚠️ เซิร์ฟเวอร์ MCP ที่โฮสต์ยอมรับเฉพาะคีย์ API ของบัญชีที่สร้างขึ้นในแดชบอร์ดคีย์ API ของ FTIR.fun (ขึ้นต้นด้วย ftir_) คีย์มาสเตอร์ฝั่งเซิร์ฟเวอร์มีไว้สำหรับผู้ดำเนินการ REST และไม่สามารถลงชื่อเข้าใช้ MCP ที่โฮสต์ได้

ขั้นตอนที่ 1 — การเชื่อมต่อใดที่เหมาะกับคุณ?

ทั้งสามเชื่อมต่อกับเอนจิ้นเดียวกัน: สเปกตรัม 130,000+ รายการ, การใช้เหตุผลแบบกราฟความรู้, และการอ้างอิงวรรณกรรม คุณต้องการเพียงหนึ่งเดียว เลือกตามวิธีที่คุณทำงาน — ไม่แน่ใจ? MCP เป็นตัวเลือกที่ได้รับความนิยมมากที่สุดสำหรับผู้ที่ใช้ผู้ช่วย AI

สิ่งที่ AI ของคุณทำได้จริง

การแจกจ่าย MCP, REST, n8n และ LangChain ในปัจจุบันเปิดเผยเจ็ดการดำเนินการ ปลั๊กอิน Coze ที่เผยแพร่เปิดเผยสามเครื่องมือ (วิเคราะห์, ค้นหา, อธิบาย) และเทมเพลตอื่นๆ อาจเปิดเผยชุดที่ประกาศไว้เล็กกว่า ตรวจสอบการ์ดแต่ละแพลตฟอร์มก่อนใช้งาน การดำเนินการด้านล่างใช้บริการ FTIR.fun เดียวกัน

งาน เครื่องมือ MCP จุดสิ้นสุด REST พูดสิ่งนี้กับ AI ของคุณ
อ่านไฟล์เครื่องมือ parse_ftir_spectrum POST /parse-spectrum แยกวิเคราะห์ sample.spc และแสดงรายการพีคที่ตรวจพบ
ระบุสเปกตรัมที่ไม่รู้จัก analyze_ftir_spectrum POST /ftir/analyze_spectrum ระบุว่าสเปกตรัมนี้เป็นพอลิเมอร์ชนิดใด
ส่งรายงานสามแกนแบบเต็ม submit_ftir_report POST /ftir/reports ส่ง sample.spa เพื่อรับรายงานแบบเต็มในโหมด ATR
สอบถามและเรียกดูรายงานนั้น get_ftir_report_status GET /ftir/reports/{task_id} ตรวจสอบงานรายงานและให้ลิงก์แก่ฉันเมื่อเสร็จแล้ว
อธิบายพีค explain_peaks POST /ftir/explain_peak_assignments พีคที่ 1715 และ 1450 cm-1 บ่งบอกถึงอะไร?
ค้นหาสเปกตรัมอ้างอิงที่รู้จัก find_spectra POST /ftir/find_spectra ค้นหาสเปกตรัมอ้างอิงสำหรับโพลิสไตรีน
เปิดผลลัพธ์ก่อนหน้าอีกครั้ง fetch_result GET /ftir/result/{result_num} ดึงผลลัพธ์ 20260528100755416137536.

ไฟล์ที่รองรับ: SPA, SPC, OPUS, JCAMP-DX, CSV, TSV, Excel, JSON ค่า sampling_mode ที่ถูกต้องคือ KBr Pellet, Vapor, Solvent, Thin Film, Paraffin Mull, ATR, Diffuse Reflectance, Micro IR และ Others ค่า Transmission ไม่ใช่ค่าที่ถูกต้อง ให้คงนามสกุลไฟล์เดิมไว้เพื่อให้ FTIR.fun เลือก parser ที่ถูกต้อง

ตัวอย่างการตอบสนองของ find_spectra

การตอบสนองของ find_spectra 
{
  "success": true,
  "query": "polystyrene",
  "match_mode": "synonym",
  "match_count": 3,
  "summary": "Found 3 reference spectrum candidates for 'polystyrene'.",
  "results": [
    {"num": 555, "spectrum_number": 555, "name": "PS/PPO",
     "cas": "-", "source_type": "direct_read:spa",
     "peaks": [697, 756, 1028, ...], "x": [...], "y": [...]}
  ]
}

ตัวอย่างการตอบสนองของ explain_peaks

explain_peaks response 
{
  "success": true,
  "search_mode": "peak_explanation",
  "peak_explanations": [
    {"peaks_cm1": [1715, 1450],
     "assignment": "1715 cm-1 suggests C=O stretching (ester or carboxylic acid)...",
     "evidence_type": "llm_general_knowledge"}
  ],
  "summary": "Peak explanation based on general FTIR knowledge..."
}

การรับรายงานแบบเต็ม (อะซิงโครนัส)

การคัดกรองด่วน (analyze_spectrum) จะส่งคืนทันที รายงานสามแกนเต็มทำงานในเบื้องหลังและโดยปกติใช้เวลา 30–90 วินาที อย่าส่งซ้ำในขณะที่รายงานกำลังทำงาน — เก็บ task_id ไว้และสอบถาม

  1. ส่ง เรียก submit_ftir_report (MCP) หรือ POST /ftir/reports (REST) คุณจะได้รับ task_id และ result_num ที่สงวนไว้ ฟิลด์ file_base64 เป็นฟิลด์บังคับ; ฟิลด์อื่นๆ (sampling_mode, prior_context, language_code, sample_name, sample_order_no) เป็นตัวเลือก
    ตัวอย่างการส่ง (REST) 
    curl -X POST https://ftir.fun/ftir/reports \
  -H "X-API-Key: ftir_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{"file_base64": "V2F2ZW51bWJlci...", "filename": "sample.spa", "sampling_mode": "ATR", "language_code": "en"}'
    ส่งการตอบสนอง 
    {"success": true, "task_id": "rpt_abc123...", "result_num": "20260713...", "status": "queued"}
  2. โพล เรียก get_ftir_report_status (MCP) หรือ GET /ftir/reports/{task_id} ทุก 5–10 วินาที จนกว่า completed จะเป็น true การตอบสนองที่เสร็จสมบูรณ์รวมถึง report_url, report_view (เนื้อหารายงานที่มีโครงสร้าง) และ result_num
    ตัวอย่างการสอบถาม 
    curl https://ftir.fun/ftir/reports/rpt_abc123 \
  -H "X-API-Key: ftir_your_key_here"
    การตอบสนองของการสอบถาม (กำลังดำเนินการ) 
    {"success": true, "task_id": "rpt_abc123", "status": "running", "progress": 45, "completed": false}
    Poll response (completed) 
    {"success": true, "task_id": "rpt_abc123", "status": "completed", "completed": true,
 "result_num": "20260713...", "report_url": "https://ftir.fun/outputdata/?num=20260713..."}
  3. เปิดรายงานสุดท้าย เปิด URL เต็ม https://ftir.fun/outputdata/?num={result_num} ในเบราว์เซอร์เพื่อดูหน้าแสดงผลสามแกนที่สมบูรณ์ซึ่งเรนเดอร์โดย FTIR.fun
⚠️ อย่าส่งรายงานเดียวกันอีกในขณะที่กำลังอยู่ในคิวหรือกำลังทำงาน เก็บ task_id ไว้และคอยสอบถามจนกว่าจะเสร็จสมบูรณ์หรือล้มเหลว การส่งซ้ำจะทำให้เสียคะแนน

การแก้ไขปัญหา

สิ่งที่คุณเห็น ความหมาย สิ่งที่ต้องทำ
ไคลเอ็นต์เปิดหน้าอนุญาตในเบราว์เซอร์ หรือแจ้งว่าหน้าอนุญาตไม่มีอยู่ ไคลเอนต์ของคุณใช้รายการเซิร์ฟเวอร์แบบ OAuth แบบเก่า FTIR.fun ไม่ใช้ OAuth — ใช้เฉพาะคีย์ API เท่านั้น ลบรายการเซิร์ฟเวอร์ ftirfun เก่า วางคอนฟิกที่แน่นอนจากหน้านี้ โหลดไคลเอนต์ใหม่ และเริ่ม ftirfun อีกครั้ง
401 (MCP) / 401 invalid_api_key (REST) คีย์ API หายไป หมดอายุ ถูกเพิกถอน หรือวางไม่ถูกต้อง รีสตาร์ทเซิร์ฟเวอร์และวางเฉพาะคีย์ดิบ (ขึ้นต้นด้วย ftir_) สร้างคีย์ใหม่จาก แดชบอร์ดคีย์ API หากจำเป็น
เซิร์ฟเวอร์เริ่มต้นแต่ไม่มีเครื่องมือปรากฏขึ้น ไคลเอนต์ยังไม่รีเฟรชแคตตาล็อก หรือการกำหนดค่าใช้ชื่อคีย์ผิด สำหรับ VS Code ให้ยืนยันว่า mcp.json ใช้ servers (ไม่ใช่ mcpServers) จากนั้นหยุดและเริ่ม ftirfun ใหม่ หรือรีโหลดหน้าต่าง
403 insufficient_balance บัญชีมีคะแนนไม่เพียงพอสำหรับการวิเคราะห์นั้น ตรวจสอบยอดคงเหลือหรือการสมัครสมาชิกใน FTIR.fun จากนั้นลองอีกครั้ง
429 rate_limit_exceeded การวิเคราะห์และการแยกวิเคราะห์ REST อนุญาตให้ 60 คำขอต่อนาทีต่อคีย์ API; การอ่านผลลัพธ์ REST และสถานะรายงานใช้บัคเก็ตแยก 120 คำขอต่อนาที; MCP อนุญาตให้ 60 การเรียกต่อนาทีสำหรับแต่ละคีย์ API และเครื่องมือ รอช่วงเวลาลองใหม่ที่รายงานโดยเครื่องมือก่อนเรียกอีกครั้ง
รายงานจะอยู่ในคิวหรือกำลังทำงาน รายงานแบบเต็มทำงานแบบอะซิงโครนัสและใช้เวลานานกว่าการคัดกรองอย่างรวดเร็ว เก็บ task_id เดิมไว้และรอต่อไป อย่าสร้างงานรายงานซ้ำ
422 หรือ missing_input เนื้อหาคำขอขาดฟิลด์ที่จำเป็นหรือมีรูปแบบที่ไม่ถูกต้อง สำหรับ analyze_spectrum คุณต้องระบุอย่างน้อยหนึ่งรายการจาก: peaks, query หรือ file_base64 ตรวจสอบว่า JSON ของคุณถูกต้อง, Content-Type เป็น application/json, และมีฟิลด์ที่จำเป็น ดูตัวอย่างคำขอด้านบน
413 file_too_large ไฟล์สเปกตรัมที่อัปโหลดเกินขีดจำกัดขนาด ส่งออกไฟล์ที่มีขนาดเล็กลงหรือใช้เฉพาะตำแหน่งจุดสูงสุดผ่านฟิลด์ spectrum.peaks

พร้อมที่จะสร้างหรือยัง?

ข้อมูลอ้างอิง REST แบบเต็มมีทุกจุดสิ้นสุด, รูปแบบคำขอและการตอบกลับ, การรับรองความถูกต้อง, ขีดจำกัดอัตรา, รหัสข้อผิดพลาด, คำจำกัดความของเครื่องมือ MCP, และตัวอย่างโค้ดใน Python และ curl

ส่งคำขอ แบบฟอร์ม