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

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

Anna tekoälyavustajallesi tai omalle koodillesi suora pääsy 320,000+ vertailuspektriin, tietämysgraafin huippupäättelyyn ja kirjallisuuteen perustuvaan tulkintaan. Valitse yksi kolmesta yhteystavasta — MCP tekoälyavustajille, REST API koodille tai valmis Skill koodittomille alustoille. Jokainen alla oleva vaihtoehto sisältää vaiheittaiset ohjeet ensikertalaisille.

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

Ennen aloitusta — hanki API-avaimesi

MCP ja REST API käyttävät samaa FTIR.fun-API-avainta. Coze/Doubao käyttää laajennuksen julkaisijan määrittämää palveluavainta, joten loppukäyttäjät työskentelevät laajennuksen kautta liittämättä henkilökohtaista avainta. Henkilökohtaisen avaimen hankkiminen kestää noin minuutin:

  1. Kirjaudu sisään FTIR.funiin Luo maksuton tili (uudet tilit sisältävät maksuttomia kokeilukrediittejä).
  2. Avaa API-avainten hallintapaneeli Siirry Tili → API-avaimet ja napsauta Luo.
  3. Näytä tai kopioi API-avaimesi Täysi avain (se alkaa ftir_:llä) on edelleen saatavilla API-avainten hallintanäkymässä. Voit palata sinne katsoaksesi, kopioidaksesi tai peruuttaaksesi sen.
🔑 Valmis? Avaa API-avainten hallintapaneeli uudessa välilehdessä, palaa sitten takaisin ja seuraa yllä valitsemaasi polkua.

Vaihe 1 — Mikä yhteys sopii sinulle?

Kaikki kolme muodostavat yhteyden samaan moottoriin: 320,000+ spektriä, tietämysgraafipäättely ja kirjallisuusviitteet. Tarvitset vain yhden. Valitse työskentelytapaasi sopiva reitti; MCP on kätevä vaihtoehto tekoälyavustajien käyttäjille.

Mitä tekoälysi voi todella tehdä

Yhdistetyt MCP- ja REST-palvelut tarjoavat saman FTIR.fun-operaatioluettelon. API-avaimet saattavat saada suppeamman käyttöoikeusalueen, kun taas alustakohtaisilla määrittelyillä voidaan tarkoituksellisesti julkaista vain osajoukko. Alla luetellut operaatiot käyttävät samoja FTIR.fun-palveluja.

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.
Muunna natiividata ja säilytä metatiedot convert_native_spectrum POST /native-spectrum/convert Muunna sample.spa JDX-muotoon ja säilytä lähde metadata.
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.
🎓 Akateeminen piikienmääritys — Kun näytteellä on tunnettu koostumus, edistynyt FTIR.fun REST/MCP -toiminto määrittää jokaisen mitatun piikin kirjallisuuslähteisiin jäljitettävällä näytöllä. Jokainen lähetys maksaa 30 pistettä, tai on maksuton aktiivisen tilauksen yhteydessä; tilakyselyistä ei veloiteta. Kuvaile tehtävä luonnollisesti (esimerkiksi: ”Määritä kaikki mitatut FTIR-piikit tälle spektrille; näyte on tunnettu PMMA; lähetä raportti sähköpostitse minulle”) — asiakas toimittaa tiedoston, eikä sinun tarvitse koskaan rakentaa JSONia tai Base64:ää itse. Valmistuneet tulokset palauttavat sekä JSON-tilan että suojatut raporttiosoitteet; raportteja ei ole asetettu julkiselle latauspolulle.

Tuetut spektritiedostopäätteet (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. Säilytä alkuperäinen tiedostopääte. Tukemattomat tai lukukelvottomat tiedostot palauttavat supported_extensions ja supported_formats. 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.

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": "instrument_import",
     "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)

Nopea seulonta (analyze_spectrum) palauttaa tuloksen välittömästi. Täydellinen kolmiakselinen raportti suoritetaan taustalla, ja siihen kuluu yleensä 30–90 sekuntia. Säilytä task_id ja hae sen tila pollausmenetelmällä sen sijaan, että lähettäisit pyynnön uudelleen.

  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", "status_url": "https://ftir.fun/ftir/reports/rpt_abc123..."}
  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-osoitteen, report-objektin (rakenteista tulossisältöä, jonka sisällä on yksityiskohtainen report_view) ja result_num-arvon.
    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.
⚠️ Säilytä task_id ja suorita kyselyitä, kunnes käsittely on valmis tai epäonnistunut. Jonossa olevien tai käynnissä olevien töiden lähettäminen uudelleen kuluttaa pisteitä turhaan.

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. Säilytä sama task_id ja suorita kyselyjä. Jos task_id katosi, kutsu GET /ftir/tasks listataksesi viimeisimmät tehtäväsi ja löytääksesi sen uudelleen.
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ä vaatimus Lomake