FTIR.funFTIR.fun
Integrasi Pembangun & AI

Sambungkan FTIR.fun ke Mana-mana Alat atau Aplikasi AI

Berikan pembantu AI anda atau kod anda sendiri akses terus kepada 320,000+ spektrum rujukan, penaakulan puncak berasaskan graf pengetahuan dan tafsiran yang disokong oleh literatur. Pilih salah satu daripada tiga cara untuk berhubung — MCP untuk pembantu AI, REST API untuk kod atau Skill siap guna untuk platform tanpa kod. Setiap laluan di bawah mempunyai arahan langkah demi langkah yang ditulis untuk pengguna kali pertama.

1. Pilih laluan anda 2. Persediaan MCP 3. REST API 4. Kemahiran & pemalam 5. Apa yang AI anda boleh lakukan 6. Penyelesaian Masalah
Disenaraikan pada

Sebelum anda mula — dapatkan kunci API anda

MCP dan REST API kedua-duanya menggunakan satu kunci API FTIR.fun. Coze/Doubao menggunakan kunci perkhidmatan yang dikonfigurasikan oleh penerbit pemalam, jadi pengguna akhir menggunakan pemalam tanpa menampal kunci peribadi. Mendapatkan kunci peribadi mengambil masa kira-kira seminit:

  1. Log masuk ke FTIR.fun Cipta akaun percuma (akaun baharu termasuk kredit percubaan percuma).
  2. Buka papan pemuka Kunci API Pergi ke Akaun → Kunci API dan klik Jana.
  3. Lihat atau salin kunci API anda Kunci penuh (ia bermula dengan ftir_) masih tersedia dalam papan pemuka Kunci API. Anda boleh kembali ke sana untuk melihat, menyalin, atau membatalkannya.
🔑 Sedia? Buka Papan Pemuka Kunci API dalam tab baharu, kemudian kembali dan ikuti laluan yang anda pilih di atas.

Langkah 1 — Sambungan mana yang sesuai untuk anda?

Ketiga-tiganya bersambung ke enjin yang sama: 320,000+ spektrum, penaakulan graf pengetahuan dan petikan literatur. Anda hanya memerlukan satu. Pilih laluan yang sepadan dengan cara anda bekerja; MCP ialah pilihan yang mudah untuk pengguna pembantu AI.

Apa yang AI anda boleh lakukan sebenarnya

Perkhidmatan MCP dan REST bersatu mendedahkan katalog operasi FTIR.fun yang sama. Kunci API mungkin menerima skop keupayaan yang lebih kecil, manakala pengisytiharan khusus platform boleh menerbitkan hanya subset dengan sengaja. Operasi di bawah berkongsi perkhidmatan FTIR.fun yang sama.

Tugas Alat MCP Titik akhir REST Katakan ini kepada AI anda
Baca fail instrumen parse_ftir_spectrum POST /parse-spectrum Hurai sample.spc dan senaraikan puncak yang dikesan.
Konversi data asal dan kekekalan metadata convert_native_spectrum POST /native-spectrum/convert Tukar sample.spa ke JDX dan simpan metadata sumber.
Kenal pasti spektrum yang tidak diketahui analyze_ftir_spectrum POST /ftir/analyze_spectrum Kenal pasti polimer apakah spektrum ini.
Hantar laporan tri-paksi penuh submit_ftir_report POST /ftir/reports Hantar sample.spa untuk laporan penuh dalam mod ATR.
Undi dan ambil laporan tersebut get_ftir_report_status GET /ftir/reports/{task_id} Semak tugasan laporan dan beri saya pautan setelah selesai.
Terangkan puncak explain_peaks POST /ftir/explain_peak_assignments Apakah yang ditunjukkan oleh puncak pada 1715 dan 1450 cm-1?
Cari spektrum rujukan yang diketahui find_spectra POST /ftir/find_spectra Cari spektrum rujukan untuk polistirena.
Buka semula hasil terdahulu fetch_result GET /ftir/result/{result_num} Ambil keputusan 20260528100755416137536.
🎓 Penugasan Puncak Akademik — Bagi sampel dengan komposisi yang diketahui, keupayaan REST/MCP FTIR.fun lanjutan menetapkan setiap puncak yang diukur dengan bukti berasaskan literatur yang boleh dijejaki. Setiap penghantaran berharga 30 mata, atau percuma dengan langganan aktif; pertanyaan status tidak dikenakan caj. Terangkan tugasan secara semula jadi (contohnya: ＂Tetapkan semua puncak FTIR yang diukur untuk spektrum ini; sampel dikenali sebagai PMMA; emel laporan kepada saya＂) — pelanggan membekalkan fail dan anda tidak perlu membina JSON atau Base64 sendiri. Hasil yang lengkap mengembalikan kedua-dua status JSON dan alamat laporan yang dilindungi; laporan tidak didedahkan pada laluan muat turun awam.

Sambungan nama fail spektrum yang disokong (36): .spa, .spc, .sp, .abs, .irf, .irs, .dt, .jws, .jdx, .dx, .asc, .dpt, .opju, .opus, .ispd, .[0-9]+, .xlsx, .xls, .ods, .csv, .dat, .txt, .tsv, .json, .tab, .a2r, .asp, .spe, .map, .bsp, .spg, .srs, .smf, .ird, .fsm, .mat. Kekalkan sambungan nama fail asal. Fail yang tidak disokong atau tidak boleh dibaca akan mengembalikan supported_extensions dan supported_formats. Nilai sampling_mode yang sah ialah KBr Pellet, Vapor, Solvent, Thin Film, Paraffin Mull, ATR, Diffuse Reflectance, Micro IR, dan Others. Transmission bukan nilai yang sah.

contoh respons find_spectra

respons 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": "instrument_import",
     "peaks": [697, 756, 1028, ...], "x": [...], "y": [...]}
  ]
}

contoh respons explain_peaks

respon explain_peaks 
{
  "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..."
}

Mendapatkan laporan penuh (tak segerak)

Saringan pantas (analyze_spectrum) dikembalikan serta-merta. Laporan tiga paksi penuh dijalankan di latar belakang dan biasanya mengambil masa 30–90 saat. Simpan task_id dan lakukan pengundian terhadapnya, bukannya menghantar semula.

  1. Hantar Panggil submit_ftir_report (MCP) atau POST /ftir/reports (REST). Anda akan mendapat task_id dan result_num yang dikhaskan. Medan file_base64 diperlukan; medan lain (sampling_mode, prior_context, language_code, sample_name, sample_order_no) adalah pilihan.
    Contoh hantar (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"}'
    Hantar respons 
    {"success": true, "task_id": "rpt_abc123...", "result_num": "20260713...",
 "status": "queued", "status_url": "https://ftir.fun/ftir/reports/rpt_abc123..."}
  2. Undian Panggil get_ftir_report_status (MCP) atau GET /ftir/reports/{task_id} setiap 5–10 saat sehingga completed adalah true. Respons yang lengkap termasuk report_url, objek report (kandungan hasil berstruktur, dengan report_view terperinci di dalamnya), dan result_num.
    Contoh polling 
    curl https://ftir.fun/ftir/reports/rpt_abc123 \
  -H "X-API-Key: ftir_your_key_here"
    Respons polling (dalam proses) 
    {"success": true, "task_id": "rpt_abc123", "status": "running", "progress": 45, "completed": false}
    Jawapan undian (selesai) 
    {"success": true, "task_id": "rpt_abc123", "status": "completed", "completed": true,
 "result_num": "20260713...", "report_url": "https://ftir.fun/outputdata/?num=20260713..."}
  3. Buka laporan akhir Buka URL penuh https://ftir.fun/outputdata/?num={result_num} dalam pelayar untuk melihat halaman hasil tri-paksi lengkap yang diberikan oleh FTIR.fun.
⚠️ Simpan task_id dan lakukan pengundian sehingga selesai atau gagal. Penghantaran pendua semasa dalam baris gilir atau sedang berjalan akan membazirkan mata.

Penyelesaian Masalah

Apa yang anda lihat Apa maksudnya Apa yang perlu dilakukan
Klien membuka halaman pengesahan penyemak imbas, atau mengatakan halaman pengesahan tidak wujud. Klien anda menggunakan entri pelayan gaya OAuth lama. FTIR.fun tidak menggunakan OAuth — hanya kunci API. Padam entri pelayan ftirfun lama, tampal konfigurasi tepat dari halaman ini, muat semula klien, dan mulakan ftirfun semula.
401 (MCP) / 401 invalid_api_key (REST) Kunci API hilang, tamat tempoh, dibatalkan, atau ditampal dengan salah. Mulakan semula pelayan dan tampal hanya kunci mentah (bermula dengan ftir_). Jana kunci baharu daripada Papan Pemuka Kunci API jika perlu.
Pelayan bermula tetapi tiada alat muncul. Pelanggan tidak menyegarkan katalognya, atau konfigurasi menggunakan nama kunci yang salah. Untuk VS Code, sahkan mcp.json menggunakan pelayan (bukan mcpPelayan). Kemudian hentikan dan mulakan ftirfun, atau muat semula tetingkap.
403 insufficient_balance Akaun tidak mempunyai mata yang mencukupi untuk analisis itu. Semak baki atau langganan anda di FTIR.fun, kemudian cuba lagi.
429 rate_limit_exceeded Analisis dan penghuraian REST membenarkan 60 permintaan seminit bagi setiap kunci API; bacaan hasil REST dan status laporan menggunakan baldi 120 permintaan seminit yang berasingan; MCP membenarkan 60 panggilan seminit bagi setiap kunci API dan alat. Tunggu tempoh percubaan semula yang dilaporkan oleh alat sebelum memanggil lagi.
Laporan kekal dalam baris gilir atau berjalan. Laporan penuh berjalan secara tak segerak dan mengambil masa lebih lama daripada saringan pantas. Kekalkan task_id yang sama dan lakukan pengundian. Jika anda kehilangan task_id, panggil GET /ftir/tasks untuk menyenaraikan tugas terkini anda dan mencarinya semula.
422 atau missing_input Badan permintaan tidak mengandungi medan yang diperlukan atau mempunyai format yang tidak sah. Untuk analyze_spectrum, anda mesti menyediakan sekurang-kurangnya satu daripada: peaks, query, atau file_base64. Pastikan JSON anda sah, Content-Type adalah application/json, dan medan yang diperlukan ada. Lihat contoh permintaan di atas.
413 file_too_large Fail spektrum yang dimuat naik melebihi had saiz. Eksport fail yang lebih kecil atau gunakan hanya kedudukan puncak melalui medan spectrum.peaks.

Bersedia untuk membina?

Rujukan REST penuh mempunyai setiap titik akhir, format permintaan dan respons, pengesahan, had kadar, kod ralat, definisi alat MCP, dan contoh kod dalam Python dan curl.

Hantar Keperluan Borang