FTIR.funFTIR.fun
Integrimi i Zhvilluesit dhe AI

Lidhni FTIR.fun me çdo mjet ose aplikacion AI

Jepini asistentit tuaj të AI-së ose kodit tuaj akses të drejtpërdrejtë në 320,000+ spektra referencë, arsyetim të pikut të grafit të njohurive dhe interpretim të mbështetur nga literatura. Zgjidhni një nga tre mënyrat e lidhjes — MCP për asistentët e AI-së, REST API për kodin ose një Skill të gatshëm për platformat pa kod. Çdo rrugë më poshtë ka udhëzime hap pas hapi të shkruara për përdoruesit fillestarë.

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
Listuar më

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

MCP dhe API-ja REST përdorin të dyja një çelës API të FTIR.fun. Coze/Doubao përdor një çelës shërbimi të konfiguruar nga publikuesi i shtojcës, kështu që përdoruesit përfundimtarë punojnë përmes shtojcës pa futur një çelës personal. Marrja e një çelësi personal zgjat rreth një minutë:

  1. Hyni në FTIR.fun Krijoni një llogari falas (llogaritë e reja përfshijnë kredite prove falas).
  2. Hapni panelin e Çelësave API Shkoni te Llogaria → Çelësat API dhe klikoni Gjenero.
  3. Shikoni ose kopjoni çelësin tuaj API Çelësi i plotë (fillon me ftir_) mbetet i disponueshëm në panelin e çelësave API. Mund të ktheheni atje për ta parë, kopjuar ose revokuar.
🔑 Gati? Hapni Panelin e Çelësave API në një skedë të re, pastaj kthehuni dhe ndiqni rrugën që zgjodhët më lart.

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

Të tre lidhen me të njëjtin motor: 320,000+ spektra, arsyetim me graf njohurish dhe citime nga literatura. Ju nevojitet vetëm njëri. Zgjidhni rrugën që përputhet me mënyrën tuaj të punës; MCP është një mundësi e përshtatshme për përdoruesit e asistentëve të AI-së.

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

Shërbimet e unifikuara MCP dhe REST ekspozojnë të njëjtin katalog operacionesh të FTIR.fun. Çelësat API mund të marrin një fushëveprim më të kufizuar aftësish, ndërsa deklarimet specifike për platformën mund të publikojnë qëllimisht vetëm një nëngrup. Operacionet më poshtë ndajnë të njëjtat shërbime të 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.
Konverto të dhënat origjinale dhe ruaj metadata convert_native_spectrum POST /native-spectrum/convert Konverto sample.spa në JDX dhe mbaj metadata e burimit.
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.
🎓 Caktim i majave akademike — Për mostrat me përbërje të njohur, aftësia e avancuar REST/MCP e FTIR.fun cakton çdo majë të matur me prova të gjurmuara në literaturë. Çdo dorëzim kushton 30 pikë ose është falas me një abonim aktiv; kërkesat për statusin nuk tarifohen. Përshkruani detyrën në mënyrë natyrale (për shembull: “Cakto të gjitha majat FTIR të matura për këtë spektër; kampioni është PMMA i njohur; dërgo raportin me email”) — klienti siguron skedarët dhe ju nuk keni nevojë të ndërtoni JSON ose Base64 vetë. Rezultatet e përfunduara kthejnë si statusin JSON ashtu edhe adresat e mbrojtura të raportit; raportet nuk janë të ekspozuara në një rrugë publike shkarkimi.

Zgjerimet e emrave të skedarëve të spektrit të mbështetur (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. Mbani zgjerimin origjinal të emrit të skedarit. Skedarët e pambështetur ose të palexueshëm kthejnë supported_extensions dhe supported_formats. 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.

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

Ekzaminimi i shpejtë (analyze_spectrum) kthen rezultatin menjëherë. Raporti i plotë me tre boshte ekzekutohet në sfond dhe zakonisht zgjat 30–90 sekonda. Ruajeni task_id dhe kryeni polling në vend që ta dërgoni përsëri.

  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", "status_url": "https://ftir.fun/ftir/reports/rpt_abc123..."}
  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, një objekt report (përmbajtje e strukturuar rezultati, me report_view të detajuar brenda), 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.
⚠️ Mbani task_id dhe kryeni kërkesa periodike derisa të përfundojë ose të dështojë. Dërgimet e dyfishta gjatë vendosjes në radhë ose ekzekutimit shpërdorojnë 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 kryeni polling. Nëse e keni humbur task_id, thërrisni GET /ftir/tasks për të renditur detyrat tuaja të fundit dhe për ta gjetur përsëri.
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.

Dorëzo Kërkesën Formulari