FTIR.fun FTIR.fun
Integrace pro vývojáře a AI

Připojte FTIR.fun k jakémukoli AI nástroji nebo aplikaci

Poskytněte svému AI asistentovi nebo vlastnímu kódu přímý přístup k více než 130 000 referenčním spektrům, znalostnímu grafu pro vyhodnocování píků a interpretaci podloženou literaturou. Vyberte si jeden ze tří způsobů připojení — MCP pro AI asistenty, REST API pro kód nebo hotovou dovednost pro no-code platformy. Každá cesta níže obsahuje podrobné pokyny pro začátečníky.

1. Zvolte svou cestu 2. Nastavení MCP 3. REST API 4. Dovednosti a pluginy 5. Co váš AI umí 6. Řešení problémů
Recenzováno a uvedeno na

Než začnete — získejte svůj API klíč

MCP i REST API používají jeden FTIR.fun API klíč. Coze/Doubao používá klíč služby nakonfigurovaný vydavatelem pluginu, takže koncoví uživatelé nevkládají osobní klíč. Získání osobního klíče trvá asi minutu:

  1. Přihlásit se do FTIR.fun Vytvořte si bezplatný účet, pokud jej nemáte. Nové účty zahrnují zkušební kredity zdarma.
  2. Otevřete dashboard API klíčů Přejít na Účet → API klíče a klikněte na Generovat.
  3. Zkopírujte a ihned uložte klíč Plný klíč (začíná na ftir_) se zobrazí pouze jednou. Uložte jej na bezpečné místo. Pokud jej ztratíte, jednoduše vygenerujte nový.
🔑 Připraveni? Otevřete řídicí panel API klíčů v nové kartě, pak se vraťte a postupujte podle cesty, kterou jste zvolili výše.
⚠️ Hostovaný server MCP přijímá pouze API klíč účtu vygenerovaný v FTIR.fun API Keys Dashboard (začíná na ftir_). Hlavní klíče na straně serveru jsou určeny pro operátory REST a nemohou se přihlásit k hostovanému MCP.

Krok 1 — Které připojení je pro vás to pravé?

Všechny tři se připojují ke stejnému enginu: 130 000+ spekter, uvažování znalostního grafu a citace literatury. Potřebujete jen jeden. Vyberte podle toho, jak pracujete – nejste si jisti? MCP je nejoblíbenější volbou pro každého, kdo používá AI asistenta.

Co váš AI skutečně umí

Současné distribuce MCP, REST, n8n a LangChain nabízejí sedm operací. Publikovaný plugin Coze nabízí tři nástroje (analyzovat, najít, vysvětlit) a další šablony mohou nabízet menší deklarovanou sadu; před použitím zkontrolujte kartu každé platformy. Níže uvedené operace sdílejí stejné služby FTIR.fun.

Úloha Nástroj MCP REST koncový bod Řekněte to svému AI
Přečíst soubor přístroje parse_ftir_spectrum POST /parse-spectrum Zpracujte sample.spc a vypište detekované píky.
Identifikujte neznámé spektrum analyze_ftir_spectrum POST /ftir/analyze_spectrum Identifikujte, jaký polymer toto spektrum je.
Odeslat úplnou tříosou zprávu submit_ftir_report POST /ftir/reports Odešlete sample.spa pro úplnou zprávu v režimu ATR.
Dotazovat se a získat tuto zprávu get_ftir_report_status GET /ftir/reports/{task_id} Zkontrolujte úlohu sestavy a až bude hotová, dejte mi odkaz.
Vysvětlit píky explain_peaks POST /ftir/explain_peak_assignments Co naznačují píky při 1715 a 1450 cm⁻¹?
Najděte známé referenční spektrum find_spectra POST /ftir/find_spectra Najděte referenční spektra pro polystyren.
Znovu otevřete dřívější výsledek fetch_result GET /ftir/result/{result_num} Načtěte výsledek 20260528100755416137536.

Podporované soubory: SPA, SPC, OPUS, JCAMP-DX, CSV, TSV, Excel, JSON. Platné hodnoty sampling_mode jsou KBr Pellet, Vapor, Solvent, Thin Film, Paraffin Mull, ATR, Diffuse Reflectance, Micro IR a Others. Transmission není platná hodnota. Ponechte původní příponu souboru, aby FTIR.fun vybral správný analyzátor.

příklad odpovědi find_spectra

odpověď 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": [...]}
  ]
}

příklad odpovědi explain_peaks

odpověď 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..."
}

Získání úplné zprávy (asynchronně)

Rychlé screening (analyze_spectrum) vrátí výsledek okamžitě. Plná tříosá zpráva běží na pozadí a obvykle trvá 30–90 sekund. Neodesílejte znovu, dokud zpráva běží — uchovejte task_id a dotažujte se.

  1. Odeslat Zavolejte submit_ftir_report (MCP) nebo POST /ftir/reports (REST). Zpět obdržíte task_id a rezervované result_num. Pole file_base64 je povinné; ostatní pole (sampling_mode, prior_context, language_code, sample_name, sample_order_no) jsou volitelná.
    Příklad odeslání (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"}'
    Odeslat odpověď 
    {"success": true, "task_id": "rpt_abc123...", "result_num": "20260713...", "status": "queued"}
  2. Anketa Volejte get_ftir_report_status (MCP) nebo GET /ftir/reports/{task_id} každých 5–10 sekund, dokud completed není true. Dokončená odpověď obsahuje report_url, report_view (strukturovaný obsah zprávy) a result_num.
    Příklad dotažování 
    curl https://ftir.fun/ftir/reports/rpt_abc123 \
  -H "X-API-Key: ftir_your_key_here"
    Odpověď dotažování (probíhá) 
    {"success": true, "task_id": "rpt_abc123", "status": "running", "progress": 45, "completed": false}
    Odpověď dotazování (dokončeno) 
    {"success": true, "task_id": "rpt_abc123", "status": "completed", "completed": true,
 "result_num": "20260713...", "report_url": "https://ftir.fun/outputdata/?num=20260713..."}
  3. Otevřete konečnou zprávu Otevřete celou URL https://ftir.fun/outputdata/?num={result_num} v prohlížeči pro zobrazení kompletní stránky s výsledky tří os vykreslené službou FTIR.fun.
⚠️ Neodesílejte stejnou zprávu znovu, pokud je ve frontě nebo běží. Uchovejte task_id a dotažujte se, dokud není dokončena nebo selže. Duplicitní odeslání plýtvá body.

Odstraňování problémů

Co vidíte Co to znamená Co dělat
Klient otevře stránku autorizace v prohlížeči nebo oznámí, že autorizační stránka neexistuje. Váš klient používá starý OAuth-stylový serverový záznam. FTIR.fun nepoužívá OAuth – pouze API klíč. Odstraňte starý záznam serveru ftirfun, vložte přesnou konfiguraci z této stránky, znovu načtěte klienta a znovu spusťte ftirfun.
401 (MCP) / 401 invalid_api_key (REST) API klíč chybí, vypršel, byl odvolán nebo je vložen nesprávně. Restartujte server a vložte pouze surový klíč (začíná na ftir_). Vygenerujte nový klíč z Panel API klíčů v případě potřeby.
Server se spustí, ale nástroje se nezobrazí. Klient neobnovil svůj katalog nebo konfigurace používá špatný název klíče. Pro VS Code potvrďte, že mcp.json používá servery (ne mcpServers). Poté zastavte a spusťte ftirfun, nebo obnovte okno.
403 insufficient_balance Účet nemá dostatek bodů pro tuto analýzu. Zkontrolujte svůj zůstatek nebo předplatné v FTIR.fun a poté to zkuste znovu.
429 rate_limit_exceeded REST analýza a parsování umožňují 60 požadavků za minutu na klíč API; REST výsledky a čtení stavu hlášení používají samostatný koš 120 požadavků za minutu; MCP umožňuje 60 volání za minutu pro každý klíč API a nástroj. Počkejte na dobu opakování hlášenou nástrojem, než zavoláte znovu.
Zpráva zůstává ve frontě nebo běží. Úplné zprávy běží asynchronně a trvají déle než rychlé prohledávání. Udržujte stejné task_id a dotazujte se dál. Nevytvářejte duplicitní úkoly zpráv.
422 nebo missing_input Tělo požadavku postrádá povinná pole nebo má neplatný formát. Pro analyze_spectrum musíte poskytnout alespoň jedno z: peaks, query, nebo file_base64. Zkontrolujte, že váš JSON je platný, Content-Type je application/json a povinná pole jsou přítomna. Viz příklady požadavků výše.
413 file_too_large Nahraný spektrální soubor překračuje limit velikosti. Exportujte menší soubor nebo použijte pouze pozice píků pomocí pole spectrum.peaks.

Připraveni tvořit?

Úplná REST reference obsahuje všechny koncové body, formáty požadavků a odpovědí, autentizaci, omezení rychlosti, chybové kódy, definice MCP nástrojů a příklady kódu v Pythonu a curl.

Odeslat žádost Formulář