FTIR.funFTIR.fun
Fejlesztői és AI integráció

Csatlakoztassa a FTIR.fun-t bármely AI eszközhöz vagy alkalmazáshoz

Biztosítson AI-asszisztensének vagy saját kódjának közvetlen hozzáférést 320,000+ referencia-spektrumhoz, tudásgráf-alapú csúcselemzéshez és szakirodalommal alátámasztott értelmezéshez. Válasszon a csatlakozás három módja közül — MCP AI-asszisztensekhez, REST API kódhoz vagy egy használatra kész Skill kódolás nélküli platformokhoz. Az alábbi lehetőségek mindegyikéhez lépésről lépésre követhető útmutatót biztosítunk első alkalommal használók számára.

1. Válassza ki az útját 2. MCP beállítás 3. REST API 4. Készségek és bővítmények 5. Mit tud az AI-ja 6. Hibaelhárítás
Közzétéve:

Mielőtt elkezdi – szerezze be az API kulcsát

Az MCP és a REST API ugyanazt az FTIR.fun API-kulcsot használja. A Coze/Doubao a plugin közzétevője által konfigurált szolgáltatási kulcsot használja, így a végfelhasználók a pluginon keresztül dolgozhatnak személyes kulcs beillesztése nélkül. A személyes kulcs beszerzése körülbelül egy percet vesz igénybe:

  1. Jelentkezzen be a FTIR.fun-ba Hozzon létre ingyenes fiókot (az új fiókok ingyenes próbakrediteket tartalmaznak).
  2. Nyissa meg az API-kulcsok irányítópultját Ugorjon a Fiók → API-kulcsok és kattintson a Generálás gombra.
  3. API-kulcs megtekintése vagy másolása A teljes kulcs (ftir_ kezdőbetűvel) továbbra is elérhető az API-kulcsok irányítópultján. Ott visszatérhet, hogy megtekintse, másolja vagy visszavonja.
🔑 Készen áll? Nyissa meg az API-kulcsok irányítópultját egy új lapon, majd térjen vissza és kövesse a fent választott utat.

1. lépés – Melyik kapcsolat a megfelelő Önnek?

Mindhárom ugyanahhoz a motorhoz csatlakozik: 320,000+ spektrum, tudásgráf-alapú következtetés és szakirodalmi hivatkozások. Csak egyre van szüksége. Válassza azt az útvonalat, amely megfelel a munkamódszerének; az MCP kényelmes lehetőség az AI-asszisztenst használók számára.

Mit tud valójában az AI-ja

Az egységesített MCP- és REST-szolgáltatások ugyanazt az FTIR.fun-műveleti katalógust teszik elérhetővé. Az API-kulcsok kisebb képességkört kaphatnak, míg a platformspecifikus deklarációk szándékosan csak egy részhalmazt tehetnek közzé. Az alábbi műveletek ugyanazokat az FTIR.fun-szolgáltatásokat használják.

Feladat MCP eszköz REST végpont Mondja ezt az AI-nak
Egy műszerfájl beolvasása parse_ftir_spectrum POST /parse-spectrum Elemezze a sample.spc fájlt, és sorolja fel az észlelt csúcsokat.
Natív adatok konvertálása és metaadatok megőrzése convert_native_spectrum POST /native-spectrum/convert sample.spa konvertálása JDX-re és a forrás metaadatok megtartása.
Ismeretlen spektrum azonosítása analyze_ftir_spectrum POST /ftir/analyze_spectrum Azonosítsa, milyen polimer ez a spektrum.
Küldjön be egy teljes háromtengelyű jelentést submit_ftir_report POST /ftir/reports Küldje be a sample.spa fájlt a teljes jelentéshez ATR módban.
Kérdezze le és töltse le a jelentést get_ftir_report_status GET /ftir/reports/{task_id} Ellenőrizze a jelentésfeladatot, és adja meg a linket, ha kész.
Csúcsok magyarázata explain_peaks POST /ftir/explain_peak_assignments Mit jeleznek a 1715 és 1450 cm-1 csúcsok?
Keressen egy ismert referenciaspektrumot find_spectra POST /ftir/find_spectra Keressen referencia spektrumokat polisztirolhoz.
Nyisson meg egy korábbi eredményt fetch_result GET /ftir/result/{result_num} Töltse le a 20260528100755416137536 eredményt.
🎓 Akadémiai csúcs hozzárendelés — Ismert összetételű minták esetén a fejlett FTIR.fun REST/MCP-funkció minden mért csúcshoz irodalmi forrásokkal nyomon követett bizonyítékokon alapuló hozzárendelést végez. Minden beküldés 30 pontba kerül, aktív előfizetéssel azonban ingyenes; az állapotlekérdezésekért nem számítunk fel díjat. Írja le a feladatot természetes nyelven (például: „Rendelje hozzá a spektrum összes mért FTIR-csúcsát; a minta ismert PMMA; küldje el nekem a jelentést e-mailben”) – az ügyfél biztosítja a fájlt, és Önnek soha nem kell saját magának JSON-t vagy Base64-et összeállítania. A befejezett eredmények mind a JSON-státuszt, mind a védett jelentéscímeket visszaadják; a jelentések nem nyilvános letöltési útvonalon érhetők el.

Támogatott spektrum fájlnév-kiterjesztések (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. Őrizze meg az eredeti fájlnév-kiterjesztést. A nem támogatott vagy olvashatatlan fájlok a supported_extensions és supported_formats értékeket adják vissza. Érvényes sampling_mode értékek: KBr Pellet, Vapor, Solvent, Thin Film, Paraffin Mull, ATR, Diffuse Reflectance, Micro IR és Others. A Transmission nem érvényes érték.

find_spectra válasz példa

find_spectra válasz 
{
  "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 válasz példa

explain_peaks válasz 
{
  "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..."
}

A teljes jelentés lekérése (aszinkron)

A gyors szűrés (analyze_spectrum) azonnal visszatér. A teljes háromtengelyű jelentés a háttérben fut, és általában 30–90 másodpercet vesz igénybe. Tartsa meg a task_id értéket, és kérdezze le annak állapotát az újbóli beküldés helyett.

  1. Beküldés Hívja a submit_ftir_report (MCP) vagy a POST /ftir/reports (REST) végpontot. Válaszként egy task_id-t és egy fenntartott result_num-ot kap. A file_base64 mező kötelező; a többi mező (sampling_mode, prior_context, language_code, sample_name, sample_order_no) opcionális.
    Beküldési példa (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"}'
    Válasz elküldése 
    {"success": true, "task_id": "rpt_abc123...", "result_num": "20260713...",
 "status": "queued", "status_url": "https://ftir.fun/ftir/reports/rpt_abc123..."}
  2. Szavazás Hívja a get_ftir_report_status (MCP) vagy a GET /ftir/reports/{task_id} végpontot 5–10 másodpercenként, amíg a completed értéke true nem lesz. A befejezett válasz tartalmazza a report_url-t, egy report objektumot (strukturált eredménytartalom, benne a részletes report_view-val), valamint a result_num-ot.
    Lekérdezési példa 
    curl https://ftir.fun/ftir/reports/rpt_abc123 \
  -H "X-API-Key: ftir_your_key_here"
    Lekérdezési válasz (folyamatban) 
    {"success": true, "task_id": "rpt_abc123", "status": "running", "progress": 45, "completed": false}
    Lekérdezés válasza (befejezett) 
    {"success": true, "task_id": "rpt_abc123", "status": "completed", "completed": true,
 "result_num": "20260713...", "report_url": "https://ftir.fun/outputdata/?num=20260713..."}
  3. Nyissa meg a végső jelentést Nyissa meg a teljes URL-t https://ftir.fun/outputdata/?num={result_num} egy böngészőben, hogy megtekintse az FTIR.fun által renderelt teljes háromtengelyű eredményoldalt.
⚠️ Őrizze meg a task_id értékét, és kérdezze le az állapotot a befejezésig vagy a sikertelen állapotig. A várakozó vagy futó feladatok ismételt beküldése pontokat pazarol.

Hibaelhárítás

Amit lát Mit jelent Tennivalók
Az ügyfél megnyit egy böngészős hitelesítési oldalt, vagy azt mondja, hogy a hitelesítési oldal nem létezik. Az ügyfél régi OAuth-stílusú szerverbejegyzést használ. A FTIR.fun nem használ OAuth-ot – csak API-kulcsot. Törölje a régi ftirfun szerver bejegyzést, illessze be a pontos konfigurációt erről az oldalról, töltse újra a klienst, és indítsa újra az ftirfun-t.
401 (MCP) / 401 invalid_api_key (REST) Az API kulcs hiányzik, lejárt, visszavonásra került, vagy helytelenül lett beillesztve. Indítsa újra a szervert, és illesszen be csak a nyers kulcsot (ftir_-rel kezdődik). Hozzon létre egy új kulcsot a API kulcsok irányítópult ha szükséges.
A szerver elindul, de nem jelennek meg eszközök. Az ügyfél nem frissítette a katalógusát, vagy a konfiguráció rossz kulcsnevet használ. VS Code esetén győződjön meg arról, hogy az mcp.json a servers (nem mcpServers) kifejezést használja. Ezután állítsa le és indítsa újra a ftirfun-t, vagy töltse újra az ablakot.
403 insufficient_balance A fióknak nincs elég pontja az adott elemzéshez. Ellenőrizze az egyenlegét vagy előfizetését az FTIR.fun oldalon, majd próbálja újra.
429 rate_limit_exceeded A REST elemzés és feldolgozás API kulcsonként 60 kérést engedélyez percenként; a REST eredmény és jelentésállapot olvasások egy külön 120 kérés/perc gyűjtőt használnak; az MCP 60 hívást engedélyez percenként minden API kulcshoz és eszközhöz. Várja meg az eszköz által jelzett újrapróbálkozási időszakot, mielőtt újra hívná.
Egy jelentés sorban áll vagy fut. A teljes jelentések aszinkron módon futnak, és tovább tartanak, mint a gyors szűrés. Tartsa meg ugyanazt a task_id értéket, és kérdezze le az állapotot. Ha elvesztette a task_id értéket, hívja meg a GET /ftir/tasks végpontot a legutóbbi feladatok listázásához, majd keresse meg újra.
422 vagy missing_input A kérelem törzséből hiányoznak a kötelező mezők, vagy érvénytelen a formátum. Az analyze_spectrum esetében legalább egyet meg kell adnia a következők közül: peaks, query vagy file_base64. Ellenőrizze, hogy a JSON érvényes, a Content-Type application/json, és a kötelező mezők jelen vannak. Lásd a fenti példakéréseket.
413 file_too_large A feltöltött spektrumfájl meghaladja a méretkorlátot. Exportáljon kisebb fájlt, vagy használja csak a csúcspozíciókat a spectrum.peaks mezőn keresztül.

Készen áll az építésre?

A teljes REST-referencia tartalmazza az összes végpontot, kérés- és válaszformátumokat, hitelesítést, sebességkorlátokat, hibakódokat, MCP-eszközdefiníciókat és kódpéldákat Pythonban és curl-ben.

Követelmény beküldése Űrlap