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

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

Adjon közvetlen hozzáférést AI-asszisztensének vagy saját kódjának 130 000+ referenciaspektrumhoz, tudásgráf csúcselemzéshez és irodalommal alátámasztott értelmezéshez. Válasszon a három csatlakozási mód közül – MCP-t AI-asszisztenseknek, REST API-t kódhoz, vagy kész Skillt no-code platformokhoz. Az alábbi útvonalak mindegyike lépésről lépésre tartalmaz útmutatást 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
Felülvizsgálva és listázva

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

Az MCP és a REST API is egy FTIR.fun API-kulcsot használ. A Coze/Doubao a bővítmény kiadója által konfigurált szolgáltatáskulcsot használ, így a végfelhasználók nem illesztenek be személyes kulcsot. Személyes kulcs beszerzése körülbelül egy percet vesz igénybe:

  1. Jelentkezzen be a FTIR.fun-ba Hozzon létre egy ingyenes fiókot, ha nincs még ilyenje. Az új fiókok ingyenes próba krediteket 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. Másolja ki és mentse el a kulcsot azonnal A teljes kulcs (ftir_-rel kezdődik) csak egyszer jelenik meg. Tárolja biztonságos helyen. Ha elveszíti, egyszerűen generáljon újat.
🔑 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.
⚠️ A tárolt MCP szerver csak az FTIR.fun API Kulcsok Irányítópultján generált fiók API-kulcsot fogad el (ftir_-vel kezdődik). A szerveroldali főkulcsok a REST üzemeltetők számára készültek, és nem jelentkezhetnek be a tárolt MCP-be.

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

Mindhárom ugyanahhoz a motorhoz csatlakozik: 130 000+ spektrum, tudásgráf-alapú érvelés és irodalmi hivatkozások. Csak egyre van szüksége. Válasszon aszerint, hogyan dolgozik – nem biztos? Az MCP a legnépszerűbb választás az AI-asszisztenst használók számára.

Mit tud valójában az AI-ja

A jelenlegi MCP, REST, n8n és LangChain disztribúciók hét műveletet tesznek elérhetővé. A publikált Coze plugin három eszközt tesz elérhetővé (analyze, find, explain), és más sablonok kisebb deklarált készletet tehetnek elérhetővé; használat előtt ellenőrizze az egyes platformkártyákat. 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.
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.

Támogatott fájlok: SPA, SPC, OPUS, JCAMP-DX, CSV, TSV, Excel, JSON. É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. Tartsa meg az eredeti fájlkiterjesztést, hogy az FTIR.fun a megfelelő elemzőt válassza.

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": "direct_read:spa",
     "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. Ne küldje újra, amíg egy jelentés fut – tartsa meg a task_id-t, és kérdezze le.

  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"}
  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, report_view (strukturált jelentés tartalom) és result_num mezőket.
    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.
⚠️ Ne küldje be ugyanazt a jelentést, amíg az sorban áll vagy fut. Tartsa meg a task_id-t, és kérdezze le folyamatosan, amíg be nem fejeződik vagy meg nem hiúsul. A duplikált beküldések pontokat pazarolnak.

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-t, és folytassa a lekérdezést. Ne hozzon létre ismétlődő jelentésfeladatokat.
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érelem benyújtása Űrlap