FTIR.fun FTIR.fun
Kehittäjä- ja tekoälyintegraatio

Yhdistä FTIR.fun mihin tahansa tekoälytyökaluun tai -sovellukseen

Anna tekoälyassistentillesi tai omalle koodillesi suora pääsy yli 130 000 viitespektriin, tietografiikkapiikkien päättelyyn ja kirjallisuuteen perustuvaan tulkintaan. Valitse yksi kolmesta yhdistämistavasta — MCP tekoälyassistenteille, REST API koodille tai valmis taito koodittomille alustoille. Jokaisella polulla on vaiheittaiset ohjeet, jotka on kirjoitettu ensimmäistä kertaa käyttäville.

1. Valitse polkusi 2. MCP-asetukset 3. REST API 4. Taidot ja liitännäiset 5. Mitä tekoälysi voi tehdä 6. Vianmääritys
Arvioitu ja listattu

Ennen aloitusta — hanki API-avaimesi

MCP ja REST-rajapinta käyttävät molemmat yhtä FTIR.fun API-avainta. Coze/Doubao käyttää liitännäisen julkaisijan määrittämää palveluavainta, joten loppukäyttäjät eivät liitä henkilökohtaista avainta. Henkilökohtaisen avaimen saaminen kestää noin minuutin:

  1. Kirjaudu sisään FTIR.funiin Luo ilmainen tili, jos sinulla ei ole sellaista. Uudet tilit sisältävät ilmaisia kokeilupisteitä.
  2. Avaa API-avainten hallintapaneeli Siirry Tili → API-avaimet ja napsauta Luo.
  3. Kopioi ja tallenna avain välittömästi Täysi avain (alkaa ftir_) näytetään vain kerran. Tallenna se turvalliseen paikkaan. Jos kadotat sen, luo uusi.
🔑 Valmis? Avaa API-avainten hallintapaneeli uudessa välilehdessä, palaa sitten takaisin ja seuraa yllä valitsemaasi polkua.
⚠️ Isännöity MCP-palvelin hyväksyy vain FTIR.fun API-avainten hallintapaneelissa luodun tilin API-avaimen (alkaa ftir_). Palvelinpuolen pääavaimet ovat REST-operaattoreita varten, eivätkä ne voi kirjautua isännöityyn MCP:hen.

Vaihe 1 — Mikä yhteys sopii sinulle?

Kaikki kolme yhdistävät samaan moottoriin: 130 000+ spektriä, tietograafipäättely ja kirjallisuusviittaukset. Tarvitset vain yhden. Valitse työskentelytapasi mukaan – etkö ole varma? MCP on suosituin valinta kenelle tahansa tekoälyassistenttia käyttävälle.

Mitä tekoälysi voi todella tehdä

Nykyiset MCP-, REST-, n8n- ja LangChain-jakelut paljastavat seitsemän toimintoa. Julkaistu Coze-laajennus paljastaa kolme työkalua (analyze, find, explain), ja muut mallipohjat saattavat paljastaa pienemmän ilmoitetun joukon; tarkista jokainen alustakortti ennen käyttöä. Alla olevat toiminnot käyttävät samoja FTIR.fun-palveluita.

Tehtävä MCP-työkalu REST-päätepiste Sano tämä tekoälyllesi
Lue instrumenttitiedosto parse_ftir_spectrum POST /parse-spectrum Jäsennä sample.spc ja luettele havaitut piikit.
Tunnista tuntematon spektri analyze_ftir_spectrum POST /ftir/analyze_spectrum Tunnista, mikä polymeeri tämä spektri on.
Lähetä täydellinen kolmiakseliraportti submit_ftir_report POST /ftir/reports Lähetä sample.spa täydellistä raporttia varten ATR-tilassa.
Kysely ja hae tuo raportti get_ftir_report_status GET /ftir/reports/{task_id} Tarkista raporttitehtävä ja anna minulle linkki, kun se on valmis.
Selitä piikit explain_peaks POST /ftir/explain_peak_assignments Mitä piikit aallonpituuksilla 1715 ja 1450 cm-1 osoittavat?
Etsi tunnettu referenssispektri find_spectra POST /ftir/find_spectra Etsi vertailuspektrit polystyreenille.
Avaa aiempi tulos uudelleen fetch_result GET /ftir/result/{result_num} Hae tulos 20260528100755416137536.

Tuetut tiedostot: SPA, SPC, OPUS, JCAMP-DX, CSV, TSV, Excel, JSON. Kelvolliset sampling_mode-arvot ovat KBr Pellet, Vapor, Solvent, Thin Film, Paraffin Mull, ATR, Diffuse Reflectance, Micro IR ja Others. Transmission ei ole kelvollinen arvo. Säilytä alkuperäinen tiedostopääte, jotta FTIR.fun valitsee oikean jäsentimen.

find_spectra-vastausesimerkki

find_spectra-vastaus 
{
  "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-vastausesimerkki

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

Täydellisen raportin hankkiminen (async)

Pikaseulonta (analyze_spectrum) palaa välittömästi. Täydellinen kolmiakseliraportti toimii taustalla ja kestää yleensä 30–90 sekuntia. Älä lähetä uudelleen, kun raportti on käynnissä — säilytä task_id ja kysy sitä.

  1. Lähetä Kutsu submit_ftir_report (MCP) tai POST /ftir/reports (REST). Saat takaisin task_id-tunnuksen ja varatun result_num-arvon. file_base64-kenttä on pakollinen; muut kentät (sampling_mode, prior_context, language_code, sample_name, sample_order_no) ovat valinnaisia.
    Lähetä esimerkki (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"}'
    Lähetä vastaus 
    {"success": true, "task_id": "rpt_abc123...", "result_num": "20260713...", "status": "queued"}
  2. Kysely Kutsu get_ftir_report_status (MCP) tai GET /ftir/reports/{task_id} 5–10 sekunnin välein, kunnes completed on true. Valmis vastaus sisältää report_url, report_view (strukturoitu raporttisisältö) ja result_num.
    Kyselyesimerkki 
    curl https://ftir.fun/ftir/reports/rpt_abc123 \
  -H "X-API-Key: ftir_your_key_here"
    Kyselyvastaus (käynnissä) 
    {"success": true, "task_id": "rpt_abc123", "status": "running", "progress": 45, "completed": false}
    Poll-vastaus (valmis) 
    {"success": true, "task_id": "rpt_abc123", "status": "completed", "completed": true,
 "result_num": "20260713...", "report_url": "https://ftir.fun/outputdata/?num=20260713..."}
  3. Avaa lopullinen raportti Avaa koko URL https://ftir.fun/outputdata/?num={result_num} selaimessa nähdäksesi FTIR.funin renderöimän täydellisen kolmiakselitulosivun.
⚠️ Älä lähetä samaa raporttia uudelleen, kun se on jonossa tai käynnissä. Säilytä task_id ja jatka kyselyä, kunnes se on valmis tai epäonnistunut. Kopiolähetykset tuhlaavat pisteitä.

Vianmääritys

Mitä näet Mitä se tarkoittaa Mitä tehdä
Asiakas avaa selaimen valtuutussivun tai ilmoittaa, ettei valtuutussivua ole olemassa. Asiakkaasi käyttää vanhaa OAuth-tyylistä palvelintietuetta. FTIR.fun ei käytä OAuthia – vain API-avainta. Poista vanha ftirfun-palvelinmerkintä, liitä tarkka konfiguraatio tältä sivulta, lataa asiakasohjelma uudelleen ja käynnistä ftirfun uudelleen.
401 (MCP) / 401 invalid_api_key (REST) API-avain puuttuu, on vanhentunut, peruutettu tai liitetty väärin. Käynnistä palvelin uudelleen ja liitä vain raaka-avain (alkaa ftir_). Luo uusi avain API-avainten hallintapaneeli tarvittaessa.
Palvelin käynnistyy, mutta työkaluja ei näy. Asiakas ei ole päivittänyt luetteloaan, tai konfiguraatio käyttää väärää avaimen nimeä. Varmista VS Codea varten, että mcp.json käyttää servers (ei mcpServers). Pysäytä ja käynnistä ftirfun uudelleen tai lataa ikkuna uudelleen.
403 insufficient_balance Tilillä ei ole tarpeeksi pisteitä tähän analyysiin. Tarkista saldosi tai tilauksesi FTIR.funissa, yritä sitten uudelleen.
429 rate_limit_exceeded REST-analyysi ja jäsentäminen sallivat 60 pyyntöä minuutissa API-avainta kohti; REST-tulosten ja raporttitilan lukemiset käyttävät erillistä 120 pyyntöä minuutissa -säiliötä; MCP sallii 60 kutsua minuutissa kutakin API-avainta ja työkalua kohti. Odota työkalun ilmoittamaa uudelleenyritysjaksoa ennen uutta kutsua.
Raportti pysyy jonossa tai käynnissä. Täydelliset raportit suoritetaan asynkronisesti ja kestävät kauemmin kuin nopea seulonta. Pidä sama task_id ja jatka pollaamista. Älä luo päällekkäisiä raporttitehtäviä.
422 tai missing_input Pyynnön runko puuttuu vaadittuja kenttiä tai on virheellisessä muodossa. analyze_spectrum-toimintoa varten sinun on annettava vähintään yksi seuraavista: peaks, query tai file_base64. Tarkista, että JSON on kelvollinen, Content-Type on application/json ja vaadittavat kentät ovat läsnä. Katso yllä olevia esimerkkipyyntöjä.
413 file_too_large Ladattu spektritiedosto ylittää kokorajoituksen. Vie pienempi tiedosto tai käytä vain huippujen sijainteja spectrum.peaks-kentän kautta.

Valmis rakentamaan?

Täydellinen REST-viite sisältää kaikki päätepisteet, pyyntö- ja vastausmuodot, todennuksen, nopeusrajoitukset, virhekoodit, MCP-työkalujen määritelmät ja koodiesimerkit Pythonilla ja curlilla.

Lähetä pyyntö Lomake