FTIR.funFTIR.fun
Entwickler- und KI-Integration

Verbinden Sie FTIR.fun mit jedem KI-Tool oder jeder App

Geben Sie Ihrem KI-Assistenten oder Ihrem eigenen Code direkten Zugriff auf 320,000+ Referenzspektren, Peak-Analysen aus Wissensgraphen und literaturgestützte Interpretationen. Wählen Sie eine von drei Verbindungsmöglichkeiten – MCP für KI-Assistenten, die REST API für Code oder einen fertigen Skill für No-Code-Plattformen. Für jeden unten aufgeführten Weg gibt es Schritt-für-Schritt-Anleitungen für Erstbenutzer.

1. Wählen Sie Ihren Pfad 2. MCP-Einrichtung 3. REST-API 4. Fähigkeiten & Plugins 5. Was Ihr KI-Assistent kann 6. Fehlerbehebung
Aufgeführt am

Bevor Sie beginnen — holen Sie Ihren API-Schlüssel

MCP und die REST API verwenden beide einen FTIR.fun-API-Schlüssel. Coze/Doubao verwendet einen vom Plugin-Herausgeber konfigurierten Dienstschlüssel, sodass Endbenutzer über das Plugin arbeiten können, ohne einen persönlichen Schlüssel einzufügen. Einen persönlichen Schlüssel zu erhalten dauert etwa eine Minute:

  1. Bei FTIR.fun anmelden Erstellen Sie ein kostenloses Konto (neue Konten enthalten kostenlose Test-Credits).
  2. Öffnen Sie das API-Schlüssel-Dashboard Gehen Sie zu Konto → API-Schlüssel und klicken Sie auf Generieren.
  3. API-Schlüssel anzeigen oder kopieren Der vollständige Schlüssel (er beginnt mit ftir_) bleibt im API-Keys-Dashboard verfügbar. Sie können dorthin zurückkehren, um ihn anzusehen, zu kopieren oder zu widerrufen.
🔑 Bereit? Öffnen Sie das API-Schlüssel-Dashboard in einem neuen Tab, kehren Sie dann zurück und folgen Sie dem von Ihnen oben gewählten Pfad.

Schritt 1 — Welche Verbindung ist die richtige für Sie?

Alle drei verbinden sich mit derselben Engine: 320,000+ Spektren, wissensgraphbasierte Schlussfolgerungen und Literaturzitate. Sie benötigen nur eine Option. Wählen Sie den Pfad, der Ihrer Arbeitsweise entspricht; MCP ist eine praktische Option für Nutzer von KI-Assistenten.

Was Ihre KI tatsächlich tun kann

Die einheitlichen MCP- und REST-Dienste stellen denselben FTIR.fun-Operationskatalog bereit. API-Schlüssel können einen kleineren Berechtigungsumfang erhalten, während plattformspezifische Deklarationen absichtlich nur eine Teilmenge veröffentlichen können. Die unten aufgeführten Operationen nutzen dieselben FTIR.fun-Dienste.

Aufgabe MCP-Tool REST-Endpunkt Sagen Sie dies Ihrer KI.
Eine Instrumentendatei lesen parse_ftir_spectrum POST /parse-spectrum Analysieren Sie sample.spc und listen Sie die erkannten Peaks auf.
Native Daten konvertieren und Metadaten erhalten convert_native_spectrum POST /native-spectrum/convert sample.spa zu JDX konvertieren und Quellmetadaten beibehalten.
Identifizieren Sie ein unbekanntes Spektrum analyze_ftir_spectrum POST /ftir/analyze_spectrum Identifizieren Sie, welches Polymer dieses Spektrum ist.
Senden Sie einen vollständigen Drei-Achsen-Bericht. submit_ftir_report POST /ftir/reports Reichen Sie sample.spa für einen vollständigen Bericht im ATR-Modus ein.
Bericht abfragen und abrufen get_ftir_report_status GET /ftir/reports/{task_id} Überprüfen Sie den Berichtsauftrag und geben Sie mir den Link, wenn er fertig ist.
Peaks erklären explain_peaks POST /ftir/explain_peak_assignments Was zeigen die Peaks bei 1715 und 1450 cm-1 an?
Ein bekanntes Referenzspektrum finden find_spectra POST /ftir/find_spectra Referenzspektren für Polystyrol finden.
Öffnen Sie ein früheres Ergebnis erneut fetch_result GET /ftir/result/{result_num} Ergebnis 20260528100755416137536 abrufen.
🎓 Akademische Peakzuordnung — Bei Proben mit bekannter Zusammensetzung ordnet die erweiterte REST/MCP-Funktionalität von FTIR.fun jedem gemessenen Peak anhand literaturgestützter, nachvollziehbarer Belege eine Zuordnung zu. Jede Einreichung kostet 30 Punkte oder ist mit einem aktiven Abonnement kostenlos; Statusabfragen werden nicht berechnet. Beschreiben Sie die Aufgabe natürlich (zum Beispiel: „Weisen Sie alle gemessenen FTIR-Peaks für dieses Spektrum zu; die Probe ist bekannterweise PMMA; senden Sie den Bericht per E-Mail an mich“) — der Client liefert die Datei und Sie müssen selbst nie JSON oder Base64 erstellen. Abgeschlossene Ergebnisse liefern sowohl den JSON-Status als auch geschützte Berichtsadressen; Berichte sind nicht über einen öffentlichen Downloadpfad zugänglich.

Unterstützte Spektrum-Dateinamenerweiterungen (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. Behalten Sie die ursprüngliche Dateinamenerweiterung bei. Nicht unterstützte oder nicht lesbare Dateien geben supported_extensions und supported_formats zurück. Gültige sampling_mode-Werte sind KBr-Pressling, Dampf, Lösungsmittel, Dünner Film, Paraffin-Mull, ATR, Diffuse Reflexion, Mikro-IR und Andere. Transmission ist kein gültiger Wert.

Beispielantwort für find_spectra

find_spectra-Antwort 
{
  "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": [...]}
  ]
}

Beispielantwort für explain_peaks

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

Den vollständigen Bericht erhalten (asynchron)

Das schnelle Screening (analyze_spectrum) liefert sofort ein Ergebnis. Der vollständige dreiachsige Bericht wird im Hintergrund erstellt und dauert typischerweise 30–90 Sekunden. Bewahren Sie die task_id auf und fragen Sie deren Status ab, anstatt die Anfrage erneut zu senden.

  1. Absenden Rufen Sie submit_ftir_report (MCP) oder POST /ftir/reports (REST) auf. Sie erhalten eine task_id und eine reservierte result_num zurück. Das Feld file_base64 ist erforderlich; andere Felder (sampling_mode, prior_context, language_code, sample_name, sample_order_no) sind optional.
    Beispiel für Übermittlung (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"}'
    Antwort übermitteln 
    {"success": true, "task_id": "rpt_abc123...", "result_num": "20260713...",
 "status": "queued", "status_url": "https://ftir.fun/ftir/reports/rpt_abc123..."}
  2. Umfrage Rufen Sie get_ftir_report_status (MCP) oder GET /ftir/reports/{task_id} alle 5–10 Sekunden auf, bis completed true ist. Die abgeschlossene Antwort enthält report_url, ein report-Objekt (strukturierter Ergebnistext mit der detaillierten report_view darin) und result_num.
    Abfragebeispiel 
    curl https://ftir.fun/ftir/reports/rpt_abc123 \
  -H "X-API-Key: ftir_your_key_here"
    Abfrageantwort (in Bearbeitung) 
    {"success": true, "task_id": "rpt_abc123", "status": "running", "progress": 45, "completed": false}
    Poll-Antwort (abgeschlossen) 
    {"success": true, "task_id": "rpt_abc123", "status": "completed", "completed": true,
 "result_num": "20260713...", "report_url": "https://ftir.fun/outputdata/?num=20260713..."}
  3. Öffnen Sie den endgültigen Bericht Öffnen Sie die vollständige URL https://ftir.fun/outputdata/?num={result_num} in einem Browser, um die vollständige Tri-Achsen-Ergebnisseite von FTIR.fun anzuzeigen.
⚠️ Behalten Sie die task_id bei und führen Sie die Abfrage so lange durch, bis der Vorgang abgeschlossen ist oder fehlschlägt. Doppelte Übermittlungen während der Warteschlange oder Ausführung verbrauchen unnötig Punkte.

Fehlerbehebung

Was Sie sehen Was es bedeutet Was zu tun ist
Der Client öffnet eine Browser-Autorisierungsseite oder meldet, dass die Autorisierungsseite nicht existiert. Ihr Client verwendet einen alten OAuth-ähnlichen Servereintrag. FTIR.fun verwendet kein OAuth — nur einen API-Schlüssel. Löschen Sie den alten ftirfun-Servereintrag, fügen Sie die genaue Konfiguration von dieser Seite ein, laden Sie den Client neu und starten Sie ftirfun erneut.
401 (MCP) / 401 invalid_api_key (REST) Der API-Key fehlt, ist abgelaufen, wurde widerrufen oder falsch eingefügt. Starten Sie den Server neu und fügen Sie nur den rohen Schlüssel ein (beginnt mit ftir_). Generieren Sie einen neuen Schlüssel über das API-Schlüssel-Dashboard falls erforderlich.
Der Server startet, aber es werden keine Tools angezeigt. Der Client hat seinen Katalog nicht aktualisiert oder die Konfiguration verwendet den falschen Schlüsselnamen. Bestätigen Sie für VS Code, dass mcp.json servers (nicht mcpServers) verwendet. Stoppen und starten Sie dann ftirfun oder laden Sie das Fenster neu.
403 insufficient_balance Das Konto hat nicht genügend Punkte für diese Analyse. Überprüfen Sie Ihr Guthaben oder Abonnement in FTIR.fun und versuchen Sie es erneut.
429 rate_limit_exceeded REST-Analyse und -Parsing erlauben 60 Anfragen pro Minute pro API-Schlüssel; REST-Ergebnis- und Report-Status-Lesevorgänge verwenden einen separaten Bucket mit 120 Anfragen pro Minute; MCP erlaubt 60 Aufrufe pro Minute für jeden API-Schlüssel und jedes Tool. Warten Sie die vom Tool gemeldete Wartezeit ab, bevor Sie es erneut aufrufen.
Ein Bericht bleibt in der Warteschlange oder läuft. Vollständige Berichte werden asynchron ausgeführt und dauern länger als die Schnellsuche. Behalten Sie dieselbe task_id bei und führen Sie Abfragen durch. Wenn Sie die task_id verloren haben, rufen Sie GET /ftir/tasks auf, um Ihre letzten Aufgaben aufzulisten und sie erneut zu finden.
422 oder missing_input Der Anforderungstext enthält nicht die erforderlichen Felder oder hat ein ungültiges Format. Für analyze_spectrum müssen Sie mindestens eines der folgenden Felder angeben: peaks, query oder file_base64. Überprüfen Sie, ob Ihr JSON gültig ist, der Content-Type application/json ist und die erforderlichen Felder vorhanden sind. Siehe die obigen Beispielanfragen.
413 file_too_large Die hochgeladene Spektrumdatei überschreitet die Größenbeschränkung. Exportieren Sie eine kleinere Datei oder verwenden Sie nur Peakpositionen über das Feld spectrum.peaks.

Bereit zu bauen?

Die vollständige REST-Referenz enthält jeden Endpunkt, Anfrage- und Antwortformate, Authentifizierung, Ratenbegrenzungen, Fehlercodes, MCP-Tooldefinitionen und Codebeispiele in Python und curl.

Anforderung einreichen Formular