FTIR.fun FTIR.fun
Integracija za developere i AI

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

Dajte svom AI asistentu ili vlastitom kodu izravan pristup s više od 130.000 referentnih spektara, zaključivanju o vrhovima pomoću grafa znanja i interpretaciji potkrijepljenoj literaturom. Odaberite jedan od tri načina povezivanja — MCP za AI asistente, REST API za kod ili gotovu vještinu za platforme bez kodiranja. Svaki put u nastavku ima upute korak po korak napisane za korisnike početnike.

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
Pregledano i navedeno na

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

MCP i REST API koriste jedan FTIR.fun API ključ. Coze/Doubao koristi ključ usluge koji je konfigurirao izdavač dodatka, tako da krajnji korisnici ne lijepe osobni ključ. Dobivanje osobnog ključa traje otprilike minutu:

  1. Prijavite se na FTIR.fun Stvorite besplatni račun ako ga nemate. 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. Kopirajte i odmah spremite ključ Potpuni ključ (počinje s ftir_) prikazuje se samo jednom. Pohranite ga na sigurno mjesto. Ako ga izgubite, samo generirajte novi.
🔑 Spremni? Otvorite nadzornu ploču API ključeva u novoj kartici, zatim se vratite i slijedite put koji ste odabrali gore.
⚠️ Hostani MCP poslužitelj prihvaća samo API ključ računa generiran u FTIR.fun API Keys Dashboard (počinje s ftir_). Master ključevi na strani poslužitelja su za REST operatere i ne mogu se prijaviti na hostani MCP.

Korak 1 — Koja je veza prava za vas?

Sva tri se povezuju na isti motor: 130.000+ spektara, zaključivanje temeljeno na grafu znanja i literaturne citate. Trebate samo jedan. Odaberite prema načinu rada — niste sigurni? MCP je najpopularniji izbor za svakoga tko koristi AI asistenta.

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

Trenutne distribucije MCP, REST, n8n i LangChain izlažu sedam operacija. Objavljeni Coze dodatak izlaže tri alata (analyze, find, explain), a ostali predlošci mogu izložiti manji deklarirani skup; provjerite karticu svake platforme prije upotrebe. Operacije u nastavku dijele iste FTIR.fun usluge.

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.
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.

Podržane datoteke: SPA, SPC, OPUS, JCAMP-DX, CSV, TSV, Excel, JSON. Važeće vrijednosti sampling_mode su KBr Pellet, Vapor, Solvent, Thin Film, Paraffin Mull, ATR, Diffuse Reflectance, Micro IR i Others. Transmission nije važeća vrijednost. Zadržite izvornu ekstenziju datoteke kako bi FTIR.fun odabrao ispravan parser.

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": "direct_read:spa",
     "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 probir (analyze_spectrum) vraća se odmah. Potpuni izvještaj o tri osi izvodi se u pozadini i obično traje 30–90 sekundi. Nemojte ponovno slati dok se izvještaj izvršava — zadržite task_id i provjeravajte ga.

  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"}
  2. Anketa Pozovite get_ftir_report_status (MCP) ili GET /ftir/reports/{task_id} svakih 5–10 sekundi dok completed ne bude true. Dovršeni odgovor uključuje report_url, report_view (strukturirani sadržaj izvještaja) 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.
⚠️ Ne šaljite isti izvještaj ponovno dok je u redu čekanja ili se izvršava. Zadržite task_id i nastavite s provjerom dok ne bude dovršen ili ne uspije. Duple prijave 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 provjeravati. Nemojte stvarati duplicirane zadatke izvješća.
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.

Podnesi zahtjev Obrazac