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

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

Δώστε στον βοηθό τεχνητής νοημοσύνης ή στον δικό σας κώδικα άμεση πρόσβαση σε 130.000+ φάσματα αναφοράς, συλλογισμό κορυφών γράφου γνώσης και ερμηνεία υποστηριζόμενη από βιβλιογραφία. Επιλέξτε έναν από τρεις τρόπους σύνδεσης — MCP για βοηθούς τεχνητής νοημοσύνης, 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. Αντιγράψτε και αποθηκεύστε το κλειδί αμέσως Το πλήρες κλειδί (ξεκινά με ftir_) εμφανίζεται μόνο μία φορά. Αποθηκεύστε το σε ασφαλές μέρος. Εάν το χάσετε, απλώς δημιουργήστε ένα νέο.
🔑 Έτοιμοι; Ανοίξτε τον Πίνακα Ελέγχου Κλειδιών API σε μια νέα καρτέλα, στη συνέχεια επιστρέψτε και ακολουθήστε τη διαδρομή που επιλέξατε παραπάνω.
⚠️ Ο φιλοξενούμενος διακομιστής MCP δέχεται μόνο ένα κλειδί API λογαριασμού που δημιουργείται στο FTIR.fun API Keys Dashboard (ξεκινά με ftir_). Τα κύρια κλειδιά διακομιστή προορίζονται για χειριστές REST και δεν μπορούν να συνδεθούν στο φιλοξενούμενο MCP.

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

Και οι τρεις συνδέονται στον ίδιο μηχανισμό: 130.000+ φάσματα, συλλογιστική γράφου γνώσης και βιβλιογραφικές αναφορές. Χρειάζεστε μόνο ένα. Επιλέξτε με βάση τον τρόπο εργασίας σας — δεν είστε σίγουροι; Το MCP είναι η πιο δημοφιλής επιλογή για όσους χρησιμοποιούν βοηθό τεχνητής νοημοσύνης.

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

Οι τρέχουσες διανομές MCP, REST, n8n και LangChain εκθέτουν επτά λειτουργίες. Το δημοσιευμένο πρόσθετο Coze εκθέτει τρία εργαλεία (analyze, find, explain), και άλλα πρότυπα ενδέχεται να εκθέτουν ένα μικρότερο δηλωμένο σύνολο· ελέγξτε κάθε κάρτα πλατφόρμας πριν από τη χρήση. Οι παρακάτω λειτουργίες μοιράζονται τις ίδιες υπηρεσίες FTIR.fun.

Εργασία Εργαλείο MCP REST endpoint Πείτε αυτό στο 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 να επιλέξει τον σωστό αναλυτή.

παράδειγμα απόκρισης 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 
{
  "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 (ολοκληρώθηκε) 
    {"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 και συνεχίστε την περιοδική αναζήτηση. Μην δημιουργείτε διπλότυπες εργασίες αναφοράς.
422 ή missing_input Το σώμα του αιτήματος λείπει απαραίτητα πεδία ή έχει μη έγκυρη μορφή. Για analyze_spectrum, πρέπει να παρέχετε τουλάχιστον ένα από τα: peaks, query, ή file_base64. Βεβαιωθείτε ότι το JSON σας είναι έγκυρο, η Content-Type είναι application/json, και τα απαιτούμενα πεδία υπάρχουν. Δείτε τα παραδείγματα αιτημάτων παραπάνω.
413 file_too_large Το μεταφορτωμένο αρχείο φάσματος υπερβαίνει το όριο μεγέθους. Εξάγετε ένα μικρότερο αρχείο ή χρησιμοποιήστε μόνο θέσεις κορυφών μέσω του πεδίου spectrum.peaks.

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

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

Υποβολή Αιτήματος Φόρμα