FTIR.funFTIR.fun
Integracija za developere i AI

Povežite FTIR.fun s bilo kojim AI alatom ili aplikacijom

Omogućite svom AI pomoćniku ili vlastitom kodu izravan pristup bazi od 320,000+ referentnih spektara, zaključivanju o vrhovima na temelju grafa znanja i tumačenju potkrijepljenom literaturom. Odaberite jedan od tri načina povezivanja — MCP za AI pomoćnike, REST API za kod ili gotovu vještinu za platforme bez kodiranja. Za svaki od navedenih načina dostupne su detaljne upute korak po korak, napisane za korisnike koji ih upotrebljavaju prvi put.

1. Odaberite svoj put 2. MCP postavke 3. REST API 4. Vještine i dodaci 5. Što vaš AI može učiniti 6. Rješavanje problema
Navedeno na

Prije nego što počnete — nabavite svoj API ključ

MCP i REST API koriste isti FTIR.fun API ključ. Coze/Doubao koristi servisni ključ koji konfigurira izdavač dodatka, pa krajnji korisnici rade putem dodatka bez lijepljenja osobnog ključa. Dobivanje osobnog ključa traje oko jedne minute:

  1. Prijavite se na FTIR.fun Izradite besplatan račun (novi računi uključuju besplatne probne kredite).
  2. Otvorite nadzornu ploču API ključeva Idi na Račun → API ključevi i kliknite Generiraj.
  3. Pogledajte ili kopirajte svoj API ključ Puni ključ (počinje s ftir_) ostaje dostupan na nadzornoj ploči API ključeva. Možete se tamo vratiti da biste ga pregledali, kopirali ili opozvali.
🔑 Spremni? Otvorite nadzornu ploču API ključeva u novoj kartici, zatim se vratite i slijedite put koji ste odabrali gore.

Korak 1 — Koja je veza prava za vas?

Sva tri povezuju se s istim mehanizmom: 320,000+ spektara, zaključivanje na temelju grafa znanja i citati iz literature. Potreban vam je samo jedan. Odaberite put koji odgovara vašem načinu rada; MCP je praktična opcija za korisnike AI asistenata.

Što vaš AI zapravo može učiniti

Objedinjene MCP i REST usluge izlažu isti katalog operacija FTIR.fun. API ključevi mogu imati uži opseg mogućnosti, dok deklaracije specifične za platformu mogu namjerno objaviti samo podskup. Operacije u nastavku dijele iste usluge FTIR.fun.

Zadatak MCP alat REST krajnja točka Recite ovo svom AI-ju
Čitaj datoteku instrumenta parse_ftir_spectrum POST /parse-spectrum Raščlanite sample.spc i navedite otkrivene vrhove.
Pretvori izvorne podatke i očuvaj metapodatke convert_native_spectrum POST /native-spectrum/convert Pretvori sample.spa u JDX i zadrži izvorne metapodatke.
Identificirajte nepoznati spektar analyze_ftir_spectrum POST /ftir/analyze_spectrum Identificirajte koji je polimer ovaj spektar.
Pošaljite potpuno izvješće s tri osi submit_ftir_report POST /ftir/reports Pošaljite sample.spa za potpuno izvješće u ATR načinu rada.
Provjeri i preuzmi to izvješće. get_ftir_report_status GET /ftir/reports/{task_id} Provjerite zadatak izvješća i dajte mi poveznicu kad završi.
Objasni vrhove explain_peaks POST /ftir/explain_peak_assignments Što označavaju vrhovi na 1715 i 1450 cm-1?
Pronađite poznati referentni spektar find_spectra POST /ftir/find_spectra Pronađite referentne spektre za polistiren.
Ponovno otvorite raniji rezultat fetch_result GET /ftir/result/{result_num} Dohvati rezultat 20260528100755416137536.
🎓 Akademsko dodjeljivanje vrhova — Za uzorke s poznatim sastavom, napredna REST/MCP mogućnost FTIR.fun dodjeljuje svaki izmjereni vrh uz dokaze praćene kroz literaturu. Svaka predaja stoji 30 bodova ili je besplatna uz aktivnu pretplatu; upiti o statusu se ne naplaćuju. Opišite zadatak prirodno (na primjer: „Dodijeli sve izmjerene FTIR vrhove za ovaj spektar; uzorak je poznati PMMA; pošalji mi izvješće e-poštom”) — klijent osigurava datoteku i nikada ne morate sami konstruirati JSON ili Base64. Dovršeni rezultati vraćaju i JSON status i zaštićene adrese izvješća; izvješća nisu izložena na javnoj putanji za preuzimanje.

Podržane ekstenzije naziva spektralnih datoteka (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. Zadržite izvornu ekstenziju naziva datoteke. Nepodržane ili nečitljive datoteke vraćaju supported_extensions i supported_formats. Važeće vrijednosti za sampling_mode su KBr Pellet, Vapor, Solvent, Thin Film, Paraffin Mull, ATR, Diffuse Reflectance, Micro IR i Others. Transmission nije važeća vrijednost.

primjer odgovora find_spectra

odgovor 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": [...]}
  ]
}

primjer odgovora explain_peaks

odgovor 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..."
}

Dobivanje potpunog izvješća (asinkrono)

Brzi pregled (analyze_spectrum) vraća rezultat odmah. Potpuno izvješće s tri osi pokreće se u pozadini i obično traje 30–90 sekundi. Sačuvajte task_id i dohvaćajte njegov status umjesto ponovnog slanja.

  1. Pošalji Pozovite submit_ftir_report (MCP) ili POST /ftir/reports (REST). Dobivate natrag task_id i rezervirani result_num. Polje file_base64 je obavezno; ostala polja (sampling_mode, prior_context, language_code, sample_name, sample_order_no) su opcionalna.
    Primjer slanja (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"}'
    Pošalji odgovor 
    {"success": true, "task_id": "rpt_abc123...", "result_num": "20260713...",
 "status": "queued", "status_url": "https://ftir.fun/ftir/reports/rpt_abc123..."}
  2. Anketa Pozovite get_ftir_report_status (MCP) ili GET /ftir/reports/{task_id} svakih 5–10 sekundi dok completed ne postane true. Dovršeni odgovor uključuje report_url, report objekt (strukturirani sadržaj rezultata, s detaljnim report_view unutar njega) i result_num.
    Primjer provjere 
    curl https://ftir.fun/ftir/reports/rpt_abc123 \
  -H "X-API-Key: ftir_your_key_here"
    Odgovor provjere (u tijeku) 
    {"success": true, "task_id": "rpt_abc123", "status": "running", "progress": 45, "completed": false}
    Odgovor poll (dovršeno) 
    {"success": true, "task_id": "rpt_abc123", "status": "completed", "completed": true,
 "result_num": "20260713...", "report_url": "https://ftir.fun/outputdata/?num=20260713..."}
  3. Otvorite konačno izvješće Otvorite puni URL https://ftir.fun/outputdata/?num={result_num} u pregledniku da biste vidjeli cijelu stranicu s rezultatima tri osi koju prikazuje FTIR.fun.
⚠️ Zadržite task_id i provjeravajte status dok postupak ne bude dovršen ili neuspješan. Dvostruka slanja dok je postupak u redu čekanja ili se izvršava uzalud troše bodove.

Rješavanje problema

Što vidite Što to znači Što učiniti
Klijent otvara stranicu za autorizaciju u pregledniku ili kaže da stranica za autorizaciju ne postoji. Vaš klijent koristi stari OAuth stil unosa poslužitelja. FTIR.fun ne koristi OAuth — samo API ključ. Izbrišite stari ftirfun unos poslužitelja, zalijepite točnu konfiguraciju s ove stranice, ponovno učitajte klijenta i ponovno pokrenite ftirfun.
401 (MCP) / 401 invalid_api_key (REST) API ključ nedostaje, istekao je, opozvan je ili je pogrešno zalijepljen. Ponovno pokrenite poslužitelj i zalijepite samo neobrađeni ključ (počinje s ftir_). Generirajte novi ključ iz Nadzorna ploča API ključeva ako je potrebno.
Poslužitelj se pokreće, ali alati se ne pojavljuju. Klijent nije osvježio svoj katalog ili konfiguracija koristi pogrešno ime ključa. Za VS Code, potvrdite da mcp.json koristi servers (ne mcpServers). Zatim zaustavite i pokrenite ftirfun ili ponovno učitajte prozor.
403 insufficient_balance Račun nema dovoljno bodova za tu analizu. Provjerite svoje stanje ili pretplatu u FTIR.fun, zatim pokušajte ponovno.
429 rate_limit_exceeded REST analiza i parsiranje omogućuju 60 zahtjeva po minuti po API ključu; REST rezultati i čitanje statusa izvješća koriste zasebni spremnik od 120 zahtjeva po minuti; MCP omogućuje 60 poziva po minuti za svaki API ključ i alat. Pričekajte razdoblje ponovnog pokušaja koje je prijavio alat prije ponovnog poziva.
Izvješće ostaje u redu čekanja ili se izvodi. Potpuna izvješća izvode se asinkrono i traju dulje od brzog pretraživanja. Zadržite isti task_id i nastavite s provjerom. Ako ste izgubili task_id, pozovite GET /ftir/tasks kako biste izlistali svoje nedavne zadatke i ponovno ga pronašli.
422 ili missing_input Tijelo zahtjeva nedostaje obavezna polja ili ima nevažeći format. Za analyze_spectrum, morate navesti barem jedno od: peaks, query ili file_base64. Provjerite je li vaš JSON valjan, Content-Type je application/json, a obavezna polja su prisutna. Pogledajte primjere zahtjeva iznad.
413 file_too_large Učitana datoteka spektra premašuje ograničenje veličine. Izvezite manju datoteku ili koristite samo položaje vrhova putem polja spectrum.peaks.

Spremni za izgradnju?

Cjelovita REST referenca sadrži svaku krajnju točku, formate zahtjeva i odgovora, autentifikaciju, ograničenja brzine, kodove pogrešaka, definicije MCP alata i primjere koda u Pythonu i curl-u.

Pošaljite zahtjev Obrazac