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

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

Poskytněte svému asistentovi AI nebo vlastnímu kódu přímý přístup k 320,000+ referenčním spektrům, odvozování píků ve znalostním grafu a interpretaci podložené odbornou literaturou. Zvolte jeden ze tří způsobů připojení — MCP pro asistenty AI, REST API pro kód nebo připravený Skill pro platformy bez kódování. Každá níže uvedená možnost obsahuje podrobné pokyny krok za krokem určené uživatelům, kteří je používají poprvé.

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

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

MCP i REST API používají jeden klíč API FTIR.fun. Coze/Doubao používá servisní klíč nakonfigurovaný vydavatelem pluginu, takže koncoví uživatelé pracují prostřednictvím pluginu bez vkládání osobního klíče. Získání osobního klíče trvá přibližně minutu:

  1. Přihlásit se do FTIR.fun Vytvořit bezplatný účet (nové účty zahrnují kredity pro bezplatné zkušební období).
  2. Otevřete dashboard API klíčů Přejít na Účet → API klíče a klikněte na Generovat.
  3. Zobrazit nebo zkopírovat váš API klíč Plný klíč (začíná na ftir_) zůstává k dispozici v panelu API klíčů. Můžete se tam vrátit a zobrazit, zkopírovat nebo jej zrušit.
🔑 Připraveni? Otevřete řídicí panel API klíčů v nové kartě, pak se vraťte a postupujte podle cesty, kterou jste zvolili výše.

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

Všechny tři se připojují ke stejnému enginu: 320,000+ spekter, uvažování pomocí znalostního grafu a citace z literatury. Potřebujete pouze jednu možnost. Vyberte cestu, která odpovídá vašemu způsobu práce; MCP je praktická možnost pro uživatele asistentů AI.

Co váš AI skutečně umí

Jednotné služby MCP a REST zpřístupňují stejný katalog operací FTIR.fun. Klíče API mohou mít užší rozsah oprávnění, zatímco deklarace specifické pro platformu mohou záměrně zveřejňovat pouze podmnožinu. Níže uvedené operace využívají 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.
Převést nativní data a zachovat metadata convert_native_spectrum POST /native-spectrum/convert Převést sample.spa na JDX a zachovat zdrojová metadata.
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.
🎓 Akademické přiřazení píků — U vzorků se známým složením pokročilá funkce REST/MCP služby FTIR.fun přiřadí každý naměřený pík s důkazy dohledatelnými v odborné literatuře. Každé odeslání stojí 30 bodů nebo je zdarma s aktivním předplatným; dotazy na stav nejsou zpoplatněny. Popište úlohu přirozeně (například: „Přiřaďte všechny naměřené píky FTIR pro toto spektrum; vzorek je známý PMMA; pošlete mi sestavu e-mailem“) – klient dodá soubor a vy nikdy nemusíte sami vytvářet JSON ani Base64. Dokončené výsledky vracejí jak stav JSON, tak chráněné adresy sestav; sestavy nejsou vystaveny na veřejné cestě ke stažení.

Podporované přípony souborů spekter (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. Ponechte původní příponu souboru. Nepodporované nebo nečitelné soubory vracejí supported_extensions a supported_formats. Platné hodnoty sampling_mode jsou KBr peleta, pára, rozpouštědlo, tenký film, parafínová suspenze, ATR, difúzní odraz, mikro IR a jiné. Transmitance není platná hodnota.

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": "instrument_import",
     "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) se vrací okamžitě. Úplný report podél tří os běží na pozadí a obvykle trvá 30–90 sekund. Uchovejte task_id a dotazujte se na jeho stav, místo abyste úlohu odesílali znovu.

  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", "status_url": "https://ftir.fun/ftir/reports/rpt_abc123..."}
  2. Anketa Volejte get_ftir_report_status (MCP) nebo GET /ftir/reports/{task_id} každých 5–10 sekund, dokud completed není true. Kompletní odpověď obsahuje report_url, objekt report (strukturovaný obsah výsledků s podrobným report_view uvnitř) 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.
⚠️ Uchovejte task_id a dotazujte stav, dokud nebude úloha dokončena nebo selže. Duplicitní odeslání ve frontě nebo během zpracování zbytečně spotřebovávají 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í. Ponechte stejný task_id a dotazujte se na stav. Pokud jste task_id ztratili, zavolejte GET /ftir/tasks, abyste vypsali své nedávné úlohy a znovu jej našli.
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 požadavek Formulář