FTIR.funFTIR.fun
Иштеп чыгуучу жана AI интеграциясы

FTIR.fun＇ду ар кандай AI куралына же колдонмосуна туташтыруу

AI жардамчыңызга же өзүңүздүн кодуңузга 320,000+ маалымдама спектрине, билим графигиндеги чокулар боюнча логикалык талдоого жана адабияттар менен бекемделген интерпретацияга түз жеткиликтүүлүк бериңиз. Туташуу үчүн үч ыкманын бирин тандаңыз — AI жардамчылары үчүн MCP, код үчүн REST API же кодсуз платформалар үчүн даяр Skill. Төмөндө ар бир жол боюнча биринчи жолу колдонгон колдонуучулар үчүн кадам-кадам нускамалар берилген.

1. Жолуңузду тандаңыз 2. MCP орнотуу 3. REST API 4. Көндүмдөр жана плагиндер 5. Сиздин AI эмне кыла алат 6. Көйгөйлөрдү чечүү
Тизмеге киргизилген күнү

Баштоодон мурун — API ачкычыңызды алыңыз

MCP жана REST API экөө тең бир FTIR.fun API ачкычын колдонот. Coze/Doubao плагинди жарыялоочу тарабынан конфигурацияланган кызмат ачкычын колдонот, ошондуктан акыркы колдонуучулар жеке ачкычын киргизбестен плагин аркылуу иштешет. Жеке ачкыч алуу болжол менен бир мүнөткө созулат:

  1. FTIR.fun＇га кирүү Акысыз эсеп түзүңүз (жаңы эсептерге акысыз сыноо кредиттери берилет).
  2. API ачкычтар панелин ачыңыз Барыңыз Каттоо эсеби → API ачкычтары жана Generate баскычын басыңыз.
  3. API ачкычыңызды көрүү же көчүрүү Толук ачкыч (ал ftir_ менен башталат) API Keys панелинде сакталат. Сиз ал жакка кайтып, аны көрүп, көчүрүп же жокко чыгара аласыз.
🔑 Даярбы? API ачкычтар панелин ачыңыз жаңы өтмөктө, анан кайра келип, жогоруда тандаган жолду аткарыңыз.

1-кадам — Кайсы байланыш сизге ылайыктуу?

Үчөө тең бир эле кыймылдаткычка туташат: 320,000+ спектр, билим графына негизделген ой жүгүртүү жана адабияттардагы цитаталар. Сизге бирөө гана керек. Иштөө ыкмаңызга туура келген жолду тандаңыз; MCP жасалма интеллект жардамчыларынын колдонуучулары үчүн ыңгайлуу вариант.

Сиздин AI чындап эмне кыла алат

Бирдиктүү MCP жана REST кызматтары FTIR.fun операцияларынын бирдей каталогун сунуштайт. API ачкычтары мүмкүнчүлүктөрдүн тар чөйрөсүнө ээ болушу мүмкүн, ал эми платформага мүнөздүү декларациялар атайылап бир бөлүгүн гана жарыялай алат. Төмөндө көрсөтүлгөн операциялар бир эле FTIR.fun кызматтарын колдонушат.

Тапшырма MCP куралы REST акыркы чекити Муну AI＇иңизге айтыңыз
Аспап файлын окуу parse_ftir_spectrum POST /parse-spectrum sample.spcти талдап, аныкталган чокуларды тизмелеңиз.
Түпнуска маалыматтарды конвертациялоо жана метадайындарды сактоо convert_native_spectrum POST /native-spectrum/convert sample.spa файлын JDX форматына конвертациялап, булактык метамаалыматты сактаңыз.
Белгисиз спектрди аныктаңыз analyze_ftir_spectrum POST /ftir/analyze_spectrum Бул спектр кайсы полимер экенин аныктаңыз.
Толук үч огу боюнча отчетту жөнөтүңүз submit_ftir_report POST /ftir/reports ATR режиминде толук отчет үчүн sample.spa өткөрүңүз.
Ошол отчетту сурап жана алыңыз. get_ftir_report_status GET /ftir/reports/{task_id} Отчет тапшырмасын текшерип, бүткөндө шилтемени бериңиз.
Чокуларды түшүндүрүү explain_peaks POST /ftir/explain_peak_assignments 1715 жана 1450 см-1 чокулары эмнени билдирет?
Белгилүү эталондук спектрди табыңыз find_spectra POST /ftir/find_spectra Полистирол үчүн шилтеме спектрлерин табыңыз.
Мурдагы жыйынтыкты кайра ачыңыз fetch_result GET /ftir/result/{result_num} 20260528100755416137536 натыйжасын алуу.
🎓 Академиялык чокуларды дайындоо — Курамы белгилүү үлгүлөр үчүн өркүндөтүлгөн FTIR.fun REST/MCP мүмкүнчүлүгү адабият булактары аркылуу көзөмөлдөнгөн далилдер менен өлчөнгөн ар бир чокуга дайындоо жүргүзөт. Ар бир жөнөтүү 30 упай турат же активдүү жазылуу болсо акысыз; абал боюнча суроо-талаптар үчүн акы алынбайт. Тапшырманы табигый түрдө сүрөттөңүз (мисалы: “Бул спектр үчүн бардык өлчөнгөн FTIR чокуларын дайыңыз; үлгү белгилүү PMMA; отчетту мага электрондук почта менен жөнөтүңүз”) — кардар файлды берет жана сизге JSON же Base64 түзүүнүн кажети жок. Аяктаган натыйжалар JSON статусун жана корголгон отчет даректерин кайтарат; отчеттор ачык жүктөө жолунда көрсөтүлбөйт.

Колдоого алынган спектр файл аталыштарынын кеңейтүүлөрү (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. Баштапкы файл кеңейтүүсүн сактаңыз. Колдоого алынбаган же окулбаган файлдар supported_extensions жана supported_formats кайтарат. Жарактуу sampling_mode маанилери: KBr Pellet, Vapor, Solvent, Thin Film, Paraffin Mull, ATR, Diffuse Reflectance, Micro IR жана Others. Transmission жарактуу маани эмес.

find_spectra жооп үлгүсү

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

explain_peeks жооп үлгүсү

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

Толук отчетту алуу (асинхрондуу)

Ыкчам скрининг (analyze_spectrum) дароо кайтарат. Толук үч октуу отчет фондо иштетилет жана адатта 30–90 секунд талап кылат. task_id маанисин сактап, кайра жөнөтпөстөн анын абалын сурамжылаңыз.

  1. Жөнөтүү Call submit_ftir_report (MCP) or POST /ftir/reports (REST). You get back a task_id and a reserved result_num. The file_base64 field is required; other fields (sampling_mode, prior_context, language_code, sample_name, sample_order_no) are optional.
    Жөнөтүү үлгүсү (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"}'
    Жоопту жөнөтүү 
    {"success": true, "task_id": "rpt_abc123...", "result_num": "20260713...",
 "status": "queued", "status_url": "https://ftir.fun/ftir/reports/rpt_abc123..."}
  2. Сурамжылоо get_ftir_report_status (MCP) же GET /ftir/reports/{task_id} чакырыңыз, completed true болгонго чейин ар 5–10 секундда. Аяктаган жоопто report_url, report объектиси (структураланган натыйжа мазмуну, ичинде деталдуу report_view менен) жана result_num камтылат.
    Сурамжылоо үлгүсү 
    curl https://ftir.fun/ftir/reports/rpt_abc123 \
  -H "X-API-Key: ftir_your_key_here"
    Сурамжылоо жообу (иштеп жатканда) 
    {"success": true, "task_id": "rpt_abc123", "status": "running", "progress": 45, "completed": false}
    Текшерүү жообу (бүттү) 
    {"success": true, "task_id": "rpt_abc123", "status": "completed", "completed": true,
 "result_num": "20260713...", "report_url": "https://ftir.fun/outputdata/?num=20260713..."}
  3. Акыркы отчетту ачуу Толук URLди https://ftir.fun/outputdata/?num={result_num} браузерде ачып, FTIR.fun тарабынан көрсөтүлгөн толук үч октуу натыйжа баракчасын көрүңүз.
⚠️ task_id маанисин сактап, аяктаганга же ката кеткенге чейин сурамжылоону улантыңыз. Кезекте турган же аткарылып жаткан учурда кайталанган жөнөтүүлөр упайларды текке кетирет.

Көйгөйлөрдү чечүү

Сиз эмнени көрөсүз Бул эмнени билдирет Эмне кылуу керек
Клиент браузердин авторизация баракчасын ачат же авторизация баракчасы жок деп айтат. Сиздин карdarыңыз эски OAuth стилиндеги сервер жазуусун колдонуп жатат. FTIR.fun OAuth колдонбойт — жөн гана API ачкычы. Эски ftirfun сервер жазуусун жок кылыңыз, ушул барактан так конфигурацияны чаптаңыз, клиентти кайра жүктөңүз жана ftirfun＇ду кайра баштаңыз.
401 (MCP) / 401 invalid_api_key (REST) API ачкычы жок, мөөнөтү өткөн, жокко чыгарылган же туура эмес чапталган. Серверди кайра иштетип, жөн гана чийки ачкычты (ftir_ менен башталат) чаптаңыз. Жаңы ачкычты түзүү үчүн API ачкычтарынын панели керек болсо.
Сервер иштейт, бирок эч кандай куралдар көрүнбөйт. Клиент каталогун жаңырткан жок же конфиг туура эмес ачкыч атын колдонот. VS Code үчүн, mcp.json ＇servers＇ колдонгонун (mcpServers эмес) текшериңиз. Андан кийин ftirfun токтотуп, кайра иштетиңиз же терезени кайра жүктөңүз.
403 insufficient_balance Аккаунтта аналитика үчүн жетиштүү упайлар жок. FTIR.fun＇дагы балансыңызды же жазылууңузду текшерип, андан кийин кайра аракет кылыңыз.
429 rate_limit_exceeded REST анализи жана парсинг ар бир API ачкычы үчүн мүнөтүнө 60 өтүнүчкө уруксат берет; REST натыйжасы жана отчет-статус окуулары өзүнчө мүнөтүнө 120 өтүнүч челегин колдонот; MCP ар бир API ачкычы жана куралы үчүн мүнөтүнө 60 чакырууга уруксат берет. Кайра чакырардан мурун, курал тарабынан билдирилген кайталоо мөөнөтүн күтүңүз.
Отчет кезекте же иштеп жатат. Толук отчеттор асинхрондуу түрдө иштетилет жана тез текшерүүгө караганда көбүрөөк убакыт алат. Ошол эле task_id сактап, сурамжылоо жүргүзүңүз. Эгер task_id жоголуп кетсе, акыркы тапшырмаларыңызды тизмелөө жана аны кайра табуу үчүн GET /ftir/tasks чакырыгын колдонуңуз.
422 же missing_input Сурамдын денесинде талап кылынган талаалар жок же туура эмес форматта. analyze_spectrum үчүн, peaks, query же file_base64 дегендердин жок дегенде бирин берүү керек. JSONиңиздин жарактуу экенин, Content-Type application/json экенин жана талап кылынган талаалардын бар экенин текшериңиз. Жогорудагы мисал сурамдарды караңыз.
413 file_too_large Жүктөлгөн спектр файлы өлчөм чегинен ашкан. Кичирээк файлды экспорттоңуз же спектрдин чоку позицияларын гана spectrum.peeks талаасы аркылуу колдонуңуз.

Курууга даярсызбы?

Толук REST шилтемесинде ар бир endpoint, сурам жана жооп форматтары, аутентификация, ылдамдык чектөөлөрү, ката коддору, MCP курал аныктамалары жана Python жана curl менен код мисалдары бар.

Талапты жөнөтүү Форма