FTIR.fun FTIR.fun
Integrimi i Zhvilluesit dhe AI

Lidhni FTIR.fun me çdo mjet ose aplikacion AI

Jepni asistentit tuaj AI ose kodit tuaj qasje direkte në 130,000+ spektra reference, arsyetimin e pikut të grafikut të njohurive dhe interpretimin e mbështetur nga literatura. Zgjidhni një nga tre mënyrat për t＇u lidhur — MCP për asistentët AI, API REST për kodin, ose një Skill të gatshëm për platforma pa kod. Çdo rrugë më poshtë ka udhëzime hap pas hapi të shkruara për përdoruesit e hershëm.

1. Zgjidhni rrugën tuaj 2. Konfigurimi MCP 3. REST API 4. Aftësitë dhe shtesat 5. Çfarë mund të bëjë AI-ja juaj 6. Zgjidhja e problemeve
Rishikuar dhe listuar në

Para se të filloni — merrni çelësin tuaj API

MCP dhe REST API të dy përdorin një çelës API FTIR.fun. Coze/Doubao përdor një çelës shërbimi të konfiguruar nga botuesi i shtojcës, kështu që përdoruesit përfundimtarë nuk ngjisin një çelës personal. Marrja e një çelësi personal zgjat rreth një minutë:

  1. Hyni në FTIR.fun Krijoni një llogari falas nëse nuk keni. Llogaritë e reja përfshijnë kredi prove falas.
  2. Hapni panelin e Çelësave API Shkoni te Llogaria → Çelësat API dhe klikoni Gjenero.
  3. Kopjoni dhe ruani çelësin menjëherë Çelësi i plotë (fillon me ftir_) shfaqet vetëm një herë. Ruajeni diku të sigurt. Nëse e humbni, thjesht gjeneroni një të ri.
🔑 Gati? Hapni Panelin e Çelësave API në një skedë të re, pastaj kthehuni dhe ndiqni rrugën që zgjodhët më lart.
⚠️ Serveri i hostuar MCP pranon vetëm një çelës API llogarie të gjeneruar në Pultin e Çelësave API të FTIR.fun (fillon me ftir_). Çelësat master në anën e serverit janë për operatorët REST dhe nuk mund të regjistrohen në MCP të hostuar.

Hapi 1 — Cila lidhje është e duhura për ju?

Të tre lidhen me të njëjtin motor: 130,000+ spektra, arsyetim me graf njohurish dhe citime literaturash. Ju duhet vetëm një. Zgjidhni sipas mënyrës suaj të punës — nuk jeni të sigurt? MCP është zgjedhja më popullore për këdo që përdor një asistent AI.

Çfarë mund të bëjë në të vërtetë AI juaj

Shpërndarjet aktuale MCP, REST, n8n dhe LangChain ekspozojnë shtatë operacione. Plugini i botuar Coze ekspozon tre mjete (analizo, gjej, shpjego), dhe shabllone të tjerë mund të ekspozojnë një grup më të vogël të deklaruar; kontrolloni çdo kartë platforme para përdorimit. Operacionet më poshtë ndajnë të njëjtat shërbime FTIR.fun.

Detyra Mjet MCP Pika fundore REST Thuajini këtë AI-së tuaj
Lexoni një skedar instrumenti parse_ftir_spectrum POST /parse-spectrum Analizoni sample.spc dhe listoni majat e zbuluara.
Identifikoni një spektër të panjohur analyze_ftir_spectrum POST /ftir/analyze_spectrum Identifikoni se çfarë polimeri është ky spektër.
Paraqisni një raport të plotë tri-aksial submit_ftir_report POST /ftir/reports Paraqisni sample.spa për një raport të plotë në modalitetin ATR.
Anketoni dhe merrni atë raport get_ftir_report_status GET /ftir/reports/{task_id} Kontrollo detyrën e raportit dhe më jep linkun kur të përfundojë.
Shpjegoni pikat explain_peaks POST /ftir/explain_peak_assignments Çfarë tregojnë majat në 1715 dhe 1450 cm-1?
Gjeni një spektër referimi të njohur find_spectra POST /ftir/find_spectra Gjeni spektrat e referencës për polistirenin.
Rihapni një rezultat të mëparshëm fetch_result GET /ftir/result/{result_num} Merrni rezultatin 20260528100755416137536.

Skedarët e mbështetur: SPA, SPC, OPUS, JCAMP-DX, CSV, TSV, Excel, JSON. Vlerat e vlefshme të sampling_mode janë KBr Pellet, Vapor, Solvent, Thin Film, Paraffin Mull, ATR, Diffuse Reflectance, Micro IR dhe Others. Transmission nuk është një vlerë e vlefshme. Mbani zgjatjen origjinale të skedarit në mënyrë që FTIR.fun të zgjedhë parser-in e duhur.

shembull përgjigjeje find_spectra

përgjigje 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": "direct_read:spa",
     "peaks": [697, 756, 1028, ...], "x": [...], "y": [...]}
  ]
}

shembull përgjigjeje explain_peaks

përgjigje 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..."
}

Marrja e raportit të plotë (asinkron)

Shqyrtimi i shpejtë (analyze_spectrum) kthehet menjëherë. Raporti i plotë tri-aksial ekzekutohet në sfond dhe zakonisht zgjat 30–90 sekonda. Mos e ripara qitni ndërsa një raport është duke u ekzekutuar — mbaj task_id dhe pyesni për të.

  1. Dorëzo Thirrni submit_ftir_report (MCP) ose POST /ftir/reports (REST). Ju merrni një task_id dhe një result_num të rezervuar. Fusha file_base64 është e detyrueshme; fushat e tjera (sampling_mode, prior_context, language_code, sample_name, sample_order_no) janë opsionale.
    Shembull paraqitjeje (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"}'
    Paraqit përgjigjen 
    {"success": true, "task_id": "rpt_abc123...", "result_num": "20260713...", "status": "queued"}
  2. Sondazh Thirrni get_ftir_report_status (MCP) ose GET /ftir/reports/{task_id} çdo 5–10 sekonda derisa completed të jetë true. Përgjigja e përfunduar përfshin report_url, report_view (përmbajtje raporti e strukturuar), dhe result_num.
    Shembull pyetjeje 
    curl https://ftir.fun/ftir/reports/rpt_abc123 \
  -H "X-API-Key: ftir_your_key_here"
    Përgjigje pyetjeje (në progres) 
    {"success": true, "task_id": "rpt_abc123", "status": "running", "progress": 45, "completed": false}
    Përgjigje polling (i përfunduar) 
    {"success": true, "task_id": "rpt_abc123", "status": "completed", "completed": true,
 "result_num": "20260713...", "report_url": "https://ftir.fun/outputdata/?num=20260713..."}
  3. Hapni raportin përfundimtar Hap URL-në e plotë https://ftir.fun/outputdata/?num={result_num} në një shfletues për të parë faqen e plotë të rezultateve tri-aksiale të paraqitur nga FTIR.fun.
⚠️ Mos e paraqit të njëjtin raport përsëri ndërsa është në radhë ose duke u ekzekutuar. Mbaj task_id dhe vazhdo të pyesësh derisa të përfundojë ose të dështojë. Paraqitjet e dyfishuara harxhojnë pikë.

Zgjidhja e problemeve

Çfarë shihni Çfarë do të thotë Çfarë duhet bërë
Klienti hap një faqe autorizimi në shfletues, ose thotë se faqja e autorizimit nuk ekziston. Klienti juaj po përdor një hyrje të vjetër serveri të stilit OAuth. FTIR.fun nuk përdor OAuth — vetëm një çelës API. Fshini hyrjen e vjetër të serverit ftirfun, ngjisni konfigurimin e saktë nga kjo faqe, ringarkoni klientin dhe filloni përsëri ftirfun.
401 (MCP) / 401 invalid_api_key (REST) Çelësi API mungon, ka skaduar, është revokuar ose është ngjitur gabimisht. Rinisni serverin dhe ngjisni vetëm çelësin e papërpunuar (fillon me ftir_). Gjeneroni një çelës të ri nga Paneli i Çelësave API nëse nevojitet.
Serveri fillon por nuk shfaqen mjete. Klienti nuk ka rifreskuar katalogun e tij, ose konfigurimi përdor emrin e gabuar të çelësit. Për VS Code, konfirmoni që mcp.json përdor servers (jo mcpServers). Më pas ndaloni dhe nisni ftirfun, ose ringarkoni dritaren.
403 insufficient_balance Llogaria nuk ka pikë të mjaftueshme për atë analizë. Kontrolloni balancën ose abonimin tuaj në FTIR.fun, pastaj provoni përsëri.
429 rate_limit_exceeded Analiza dhe interpretimi REST lejojnë 60 kërkesa në minutë për çelës API; leximet e rezultatit dhe raportimit të statusit REST përdorin një kovë të veçantë prej 120 kërkesash në minutë; MCP lejon 60 thirrje në minutë për çdo çelës API dhe mjet. Prisni periudhën e ripërpjekjes të raportuar nga mjeti përpara se të thërrisni përsëri.
Një raport mbetet në radhë ose në ekzekutim. Raportet e plota ekzekutohen në mënyrë asinkrone dhe zgjasin më shumë se kontrolli i shpejtë. Mbani të njëjtin task_id dhe vazhdoni polling-un. Mos krijoni detyra të dyfishta raporti.
422 ose missing_input Trupi i kërkesës mungon në fushat e kërkuara ose ka format të pavlefshëm. Për analyze_spectrum, duhet të siguroni të paktën një nga: peaks, query, ose file_base64. Kontrolloni që JSON-i juaj është i vlefshëm, Content-Type është application/json dhe fushat e kërkuara janë të pranishme. Shihni shembujt e kërkesave më lart.
413 file_too_large Skedari i spektrit i ngarkuar tejkalon kufirin e madhësisë. Eksporto një skedar më të vogël ose përdor vetëm pozicionet e pikave përmes fushës spectrum.peaks.

Gati për të ndërtuar?

Referenca e plotë REST ka çdo pikë fundore, formatet e kërkesës dhe përgjigjes, autentifikimin, kufijtë e shpejtësisë, kodet e gabimit, përkufizimet e mjeteve MCP dhe shembuj kodi në Python dhe curl.

Paraqisni Kërkesën Formulari