FTIR.funFTIR.fun
Muunganisho wa Wasanidi Programu na AI

Unganisha FTIR.fun kwa Zana yoyote ya AI au Programu

Mpe msaidizi wako wa AI au msimbo wako mwenyewe ufikiaji wa moja kwa moja wa spectra za marejeleo 320,000+, hoja za kilele za grafu ya maarifa, na tafsiri inayoungwa mkono na machapisho ya kisayansi. Chagua mojawapo ya njia tatu za kuunganisha — MCP kwa wasaidizi wa AI, REST API kwa msimbo, au Skill iliyo tayari kwa majukwaa yasiyohitaji msimbo. Kila njia iliyo hapa chini ina maagizo ya hatua kwa hatua yaliyoandikwa kwa watumiaji wanaotumia kwa mara ya kwanza.

1. Chagua njia yako 2. Usanidi wa MCP 3. API ya REST 4. Ujuzi na programu-jalizi 5. Kile AI yako inaweza kufanya 6. Utatuzi wa matatizo
Imeorodheshwa kwenye

Kabla ya kuanza — pata ufunguo wako wa API

MCP na REST API zote hutumia ufunguo mmoja wa API wa FTIR.fun. Coze/Doubao hutumia ufunguo wa huduma uliosanidiwa na mchapishaji wa programu-jalizi, hivyo watumiaji wa mwisho hutumia programu-jalizi bila kubandika ufunguo wao binafsi. Kupata ufunguo binafsi huchukua takriban dakika moja:

  1. Ingia kwenye FTIR.fun Fungua akaunti bila malipo (akaunti mpya zinajumuisha krediti za majaribio bila malipo).
  2. Fungua dashibodi ya Funguo za API Nenda kwa Akaunti → Funguo za API na bofya Generate.
  3. Tazama au nakili ufunguo wako wa API. Ufunguo kamili (unaoanza na ftir_) unabaki kupatikana katika dashibodi ya Funguo za API. Unaweza kurudi huko kutazama, kunakili, au kuubatilisha.
🔑 Uko tayari? Fungua Dashibodi ya Funguo za API katika kichupo kipya, kisha rudi na ufuate njia uliyochagua hapo juu.

Hatua ya 1 — Ni muunganisho gani unaofaa kwako?

Vyote vitatu huunganisha kwenye injini ileile: spectra 320,000+, hoja za grafu ya maarifa, na marejeo ya machapisho. Unahitaji moja tu. Chagua njia inayolingana na jinsi unavyofanya kazi; MCP ni chaguo linalofaa kwa watumiaji wa wasaidizi wa AI.

Nini AI yako inaweza kufanya kwa kweli

Huduma za MCP na REST zilizounganishwa hufichua katalogi ileile ya utendaji wa FTIR.fun. Vifunguo vya API vinaweza kupokea wigo mdogo wa uwezo, huku matamko mahususi ya jukwaa yakichapisha kwa makusudi sehemu ndogo tu. Operesheni zilizo hapa chini zinashiriki huduma zilezile za FTIR.fun.

Kazi Chombo cha MCP Sehemu ya mwisho ya REST Sema hivi kwa AI yako
Soma faili la chombo parse_ftir_spectrum POST /parse-spectrum Changanua sample.spc na orodhesha vilele vilivyogunduliwa.
Badilisha data ya asili na uhifadhi wa metadata convert_native_spectrum POST /native-spectrum/convert Badilisha sample.spa kuwa JDX na uhifadhi metadata ya chanzo.
Tambua wigo usiojulikana analyze_ftir_spectrum POST /ftir/analyze_spectrum Tambua ni polima gani wigo huu.
Wasilisha ripoti kamili ya mihimili mitatu submit_ftir_report POST /ftir/reports Wasilisha sample.spa kwa ripoti kamili katika hali ya ATR.
Chagua na upate ripoti hiyo. get_ftir_report_status GET /ftir/reports/{task_id} Angalia kazi ya ripoti na nipe kiungo kitakapokamilika.
Elezea kilele explain_peaks POST /ftir/explain_peak_assignments Vilele katika 1715 na 1450 cm-1 vinaonyesha nini?
Tafuta wigo wa marejeleo unaojulikana find_spectra POST /ftir/find_spectra Tafuta spectra za kumbukumbu za polystyrene.
Fungua tena matokeo ya awali fetch_result GET /ftir/result/{result_num} Pata matokeo 20260528100755416137536.
🎓 Uteuzi wa Kilele cha Kielimu — Kwa sampuli zenye muundo unaojulikana, uwezo wa hali ya juu wa FTIR.fun REST/MCP huainisha kila kilele kilichopimwa kwa ushahidi unaofuatiliwa katika machapisho. Kila uwasilishaji hugharimu 30 pointi, au ni bila malipo ukiwa na usajili unaotumika; maswali ya hali hayatozwi. Elezea kazi kwa njia ya asili (kwa mfano: “Weka alama zote za FTIR zilizopimwa kwa spectrum hii; sampuli inajulikana kama PMMA; tuma ripoti kwangu”) — mteja hutoa faili na huhitaji kamwe kuunda JSON au Base64 mwenyewe. Matokeo yaliyokamilika yanarudisha hali ya JSON na anwani za ripoti zilizolindwa; ripoti hazionyeshwi kwenye njia ya umma ya kupakua.

Viendelezi vinavyotumika vya majina ya faili za wigo (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. Weka kiendelezi asili cha jina la faili. Faili zisizotumika au zisizosomika hurudisha supported_extensions na supported_formats. Thamani halali za sampling_mode ni KBr Pellet, Vapor, Solvent, Thin Film, Paraffin Mull, ATR, Diffuse Reflectance, Micro IR, na Others. Transmission si thamani halali.

mfano wa majibu ya find_spectra

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

mfano wa majibu ya explain_peaks

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

Kupata ripoti kamili (async)

Uchunguzi wa haraka (analyze_spectrum) hurejesha matokeo mara moja. Ripoti kamili ya mihimili mitatu huendeshwa chinichini na kwa kawaida huchukua sekunde 30–90. Hifadhi task_id na iulizie hali badala ya kuituma tena.

  1. Wasilisha Piga submit_ftir_report (MCP) au POST /ftir/reports (REST). Utapata task_id na result_num iliyohifadhiwa. Sehemu ya file_base64 inahitajika; sehemu nyingine (sampling_mode, prior_context, language_code, sample_name, sample_order_no) ni za hiari.
    Wasilisha mfano (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"}'
    Wasilisha majibu 
    {"success": true, "task_id": "rpt_abc123...", "result_num": "20260713...",
 "status": "queued", "status_url": "https://ftir.fun/ftir/reports/rpt_abc123..."}
  2. Kura Piga get_ftir_report_status (MCP) au GET /ftir/reports/{task_id} kila sekunde 5–10 mpaka completed iwe true. Jibu la kukamilika linajumuisha report_url, kitu cha report (maudhui ya matokeo yaliyopangwa, na report_view ya kina ndani yake), na result_num.
    Mfano wa kura 
    curl https://ftir.fun/ftir/reports/rpt_abc123 \
  -H "X-API-Key: ftir_your_key_here"
    Jibu la kura (inaendelea) 
    {"success": true, "task_id": "rpt_abc123", "status": "running", "progress": 45, "completed": false}
    Jibu la uchunguzi (limekamilika) 
    {"success": true, "task_id": "rpt_abc123", "status": "completed", "completed": true,
 "result_num": "20260713...", "report_url": "https://ftir.fun/outputdata/?num=20260713..."}
  3. Fungua ripoti ya mwisho Fungua URL kamili https://ftir.fun/outputdata/?num={result_num} kwenye kivinjari ili kutazama ukurasa kamili wa matokeo ya mhimili-tatu uliotolewa na FTIR.fun.
⚠️ Hifadhi task_id na endelea kufanya poll hadi ikamilike au ishindwe. Uwasilishaji wa nakala wakati kazi iko kwenye foleni au inaendeshwa hupoteza pointi.

Utatuzi wa shida

Kile unachokiona Maana yake Nini cha kufanya
Kiteja hufungua ukurasa wa idhini ya kivinjari, au kinasema ukurasa wa idhini haupo. Mteja wako anatumia ingizo la seva la zamani la mtindo wa OAuth. FTIR.fun haitumii OAuth — ufunguo wa API pekee. Futa ingizo la zamani la seva ya ftirfun, bandika usanidi halisi kutoka ukurasa huu, pakia upya mteja, na anza ftirfun tena.
401 (MCP) / 401 invalid_api_key (REST) Ufunguo wa API haupo, umekwisha muda, umeghairiwa, au umebandikwa vibaya. Anzisha upya seva na bandika ufunguo mbichi pekee (unaoanza na ftir_). Tengeneza ufunguo mpya kutoka kwa Dashibodi ya Funguo za API ikihitajika.
Seva inaanza lakini hakuna zana zinazoonekana. Mteja hajaburudisha katalogi yake, au usanidi unatumia jina lisilofaa la ufunguo. Kwa VS Code, thibitisha mcp.json inatumia seva (si mcpServers). Kisha simamisha na uanze ftirfun, au upakie upya dirisha.
403 insufficient_balance Akaunti haina pointi za kutosha kwa uchambuzi huo. Angalia salio lako au usajili katika FTIR.fun, kisha jaribu tena.
429 rate_limit_exceeded Uchambuzi na uchanganuzi wa REST huruhusu maombi 60 kwa dakika kwa kila ufunguo wa API; usomaji wa matokeo na ripoti-hali ya REST hutumia ndoo tofauti ya maombi 120 kwa dakika; MCP huruhusu simu 60 kwa dakika kwa kila ufunguo wa API na zana. Subiri kipindi cha kurudia kinachoripotiwa na zana kabla ya kupiga tena.
Ripoti inabakia kwenye foleni au inaendelea. Ripoti kamili zinaendeshwa kwa njia isiyo ya wakati mmoja na zinachukua muda mrefu kuliko uchunguzi wa haraka. Dumisha task_id ileile na ufanye upigaji kura. Ikiwa umepoteza task_id, piga simu kwa GET /ftir/tasks ili kuorodhesha kazi zako za hivi karibuni na kuipata tena.
422 au missing_input Mwili wa ombi unakosa sehemu zinazohitajika au umbizo si sahihi. Kwa analyze_spectrum, lazima utoe angalau moja ya: peaks, query, au file_base64. Hakikisha JSON yako ni halali, Content-Type ni application/json, na sehemu zinazohitajika zipo. Tazama mifano ya maombi hapo juu.
413 file_too_large Faili ya wigo iliyopakiwa inazidi kikomo cha ukubwa. Hamisha faili ndogo au tumia tu nafasi za kilele kupitia uwanja wa spectrum.peaks.

Tayari kujenga?

Rejeleo kamili la REST lina kila sehemu ya mwisho, fomati za ombi na jibu, uthibitishaji, mipaka ya kiwango, misimbo ya makosa, ufafanuzi wa zana za MCP, na mifano ya msimbo katika Python na curl.

Wasilisha Mahitaji Fomu