FTIR.funFTIR.fun
Ενσωμάτωση Προγραμματιστή & AI

Συνδέστε το FTIR.fun με οποιοδήποτε εργαλείο ή εφαρμογή τεχνητής νοημοσύνης

Δώστε στον βοηθό AI ή στον δικό σας κώδικα άμεση πρόσβαση σε 320,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 και κάντε κλικ στο Generate.
  3. Προβολή ή αντιγραφή του κλειδιού API σας Το πλήρες κλειδί (ξεκινά με ftir_) παραμένει διαθέσιμο στον πίνακα ελέγχου API Keys. Μπορείτε να επιστρέψετε εκεί για να το δείτε, να το αντιγράψετε ή να το ανακαλέσετε.
🔑 Έτοιμοι; Ανοίξτε τον Πίνακα Ελέγχου Κλειδιών API σε μια νέα καρτέλα, στη συνέχεια επιστρέψτε και ακολουθήστε τη διαδρομή που επιλέξατε παραπάνω.

Βήμα 1 — Ποια σύνδεση είναι κατάλληλη για εσάς;

Και οι τρεις συνδέονται στην ίδια μηχανή: 320,000+ φάσματα, συλλογισμός μέσω γράφου γνώσης και παραπομπές σε βιβλιογραφία. Χρειάζεστε μόνο μία. Επιλέξτε τη διαδρομή που ταιριάζει στον τρόπο εργασίας σας· το MCP είναι μια πρακτική επιλογή για χρήστες βοηθών AI.

Τι μπορεί πραγματικά να κάνει το AI σας

Οι ενοποιημένες υπηρεσίες MCP και REST εκθέτουν τον ίδιο κατάλογο λειτουργιών του FTIR.fun. Τα κλειδιά API ενδέχεται να λαμβάνουν μικρότερο εύρος δυνατοτήτων, ενώ οι δηλώσεις που αφορούν συγκεκριμένες πλατφόρμες μπορούν σκόπιμα να δημοσιεύουν μόνο ένα υποσύνολο. Οι παρακάτω λειτουργίες χρησιμοποιούν τις ίδιες υπηρεσίες του FTIR.fun.

Εργασία Εργαλείο MCP REST endpoint Πείτε αυτό στο AI σας
Διαβάστε ένα αρχείο οργάνου parse_ftir_spectrum POST /parse-spectrum Αναλύστε το sample.spc και καταγράψτε τις ανιχνευμένες κορυφές.
Μετατροπή native δεδομένων και διατήρηση μεταδεδομένων convert_native_spectrum POST /native-spectrum/convert Μετατροπή sample.spa σε JDX και διατήρηση των μεταδεδομένων πηγής.
Αναγνωρίστε ένα άγνωστο φάσμα 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.
🎓 Ακαδημαϊκή Αντιστοίχιση Κορυφών — Για δείγματα με γνωστή σύνθεση, η προηγμένη δυνατότητα FTIR.fun REST/MCP αντιστοιχίζει κάθε μετρούμενη κορυφή σε τεκμηριωμένα από τη βιβλιογραφία στοιχεία. Κάθε υποβολή κοστίζει 30 πόντους ή είναι δωρεάν με ενεργή συνδρομή· τα ερωτήματα κατάστασης δεν χρεώνονται. Περιγράψτε την εργασία φυσικά (για παράδειγμα: «Αντιστοιχίστε όλες τις μετρημένες κορυφές FTIR για αυτό το φάσμα· το δείγμα είναι γνωστό PMMA· στείλτε μου την αναφορά με email») — ο πελάτης παρέχει το αρχείο και ποτέ δεν χρειάζεται να κατασκευάσετε JSON ή Base64 μόνοι σας. Τα ολοκληρωμένα αποτελέσματα επιστρέφουν τόσο την κατάσταση JSON όσο και τις προστατευμένες διευθύνσεις αναφοράς· οι αναφορές δεν εκτίθενται σε δημόσια διαδρομή λήψης.

Υποστηριζόμενες επεκτάσεις ονομάτων αρχείων φάσματος (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. Διατηρήστε την αρχική επέκταση ονόματος αρχείου. Τα μη υποστηριζόμενα ή μη αναγνώσιμα αρχεία επιστρέφουν supported_extensions και supported_formats. Οι έγκυρες τιμές sampling_mode είναι: KBr Pellet, Vapor, Solvent, Thin Film, Paraffin Mull, ATR, Diffuse Reflectance, Micro IR και Others. Το Transmission δεν είναι έγκυρη τιμή.

παράδειγμα απόκρισης 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": "instrument_import",
     "peaks": [697, 756, 1028, ...], "x": [...], "y": [...]}
  ]
}

παράδειγμα απόκρισης explain_peaks

απάντηση 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..."
}

Λήψη της πλήρους αναφοράς (ασύγχρονα)

Η γρήγορη προκαταρκτική εξέταση (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", "status_url": "https://ftir.fun/ftir/reports/rpt_abc123..."}
  2. Δημοσκόπηση Καλέστε το get_ftir_report_status (MCP) ή το GET /ftir/reports/{task_id} κάθε 5–10 δευτερόλεπτα έως ότου το completed είναι true. Η ολοκληρωμένη απάντηση περιλαμβάνει το report_url, ένα αντικείμενο report (δομημένο περιεχόμενο αποτελέσματος, με το λεπτομερές 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 (ολοκληρώθηκε) 
    {"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 χρησιμοποιεί διακομιστές (όχι mcpServers). Στη συνέχεια, σταματήστε και ξεκινήστε το ftirfun, ή επαναφορτώστε το παράθυρο.
403 insufficient_balance Ο λογαριασμός δεν έχει αρκετούς πόντους για αυτήν την ανάλυση. Ελέγξτε το υπόλοιπο ή τη συνδρομή σας στο FTIR.fun και, στη συνέχεια, δοκιμάστε ξανά.
429 rate_limit_exceeded Ανάλυση REST και ανάλυση επιτρέπουν 60 αιτήματα ανά λεπτό ανά κλειδί API· οι αναγνώσεις αποτελεσμάτων REST και κατάστασης αναφοράς χρησιμοποιούν ξεχωριστό κάδο 120 αιτημάτων ανά λεπτό· Το MCP επιτρέπει 60 κλήσεις ανά λεπτό για κάθε κλειδί API και εργαλείο. Περιμένετε την περίοδο επανάληψης που αναφέρει το εργαλείο πριν καλέσετε ξανά.
Μια αναφορά παραμένει σε ουρά ή σε εκτέλεση. Οι πλήρεις αναφορές εκτελούνται ασύγχρονα και διαρκούν περισσότερο από τον γρήγορο έλεγχο. Διατηρήστε το ίδιο task_id και εκτελέστε polling. Αν χάσατε το task_id, καλέστε το GET /ftir/tasks για να εμφανίσετε τις πρόσφατες εργασίες σας και να το εντοπίσετε ξανά.
422 ή missing_input Το σώμα του αιτήματος λείπει απαραίτητα πεδία ή έχει μη έγκυρη μορφή. Για analyze_spectrum, πρέπει να παρέχετε τουλάχιστον ένα από τα: peaks, query, ή file_base64. Βεβαιωθείτε ότι το JSON σας είναι έγκυρο, η Content-Type είναι application/json, και τα απαιτούμενα πεδία υπάρχουν. Δείτε τα παραδείγματα αιτημάτων παραπάνω.
413 file_too_large Το μεταφορτωμένο αρχείο φάσματος υπερβαίνει το όριο μεγέθους. Εξάγετε ένα μικρότερο αρχείο ή χρησιμοποιήστε μόνο θέσεις κορυφών μέσω του πεδίου spectrum.peaks.

Έτοιμοι να δημιουργήσετε;

Η πλήρης αναφορά REST περιέχει κάθε τελικό σημείο, μορφές αιτήματος και απόκρισης, έλεγχο ταυτότητας, όρια ρυθμού, κωδικούς σφάλματος, ορισμούς εργαλείων MCP και παραδείγματα κώδικα σε Python και curl.

Υποβολή Απαίτησης Φόρμα