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

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

AI жардамчыңызга же өз кодуңузга 130,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. Ачкычты дароо көчүрүп, сактаңыз Толук ачкыч (ftir_ менен башталат) бир гана жолу көрсөтүлөт. Аны коопсуз жерде сактаңыз. Эгер жоготуп алсаңыз, жаңысын түзүңүз.
🔑 Даярбы? API ачкычтар панелин ачыңыз жаңы өтмөктө, анан кайра келип, жогоруда тандаган жолду аткарыңыз.
⚠️ Хосттолгон MCP сервери FTIR.fun API Ключтер Dashboard＇да түзүлгөн (ftir_ менен башталган) эсептик API ачкычын гана кабыл алат. Сервер тараптагы мастер ачкычтар REST операторлоруна арналган жана хосттолгон MCPге кире албайт.

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

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

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

Учурдагы MCP, REST, n8n жана LangChain бөлүштүрүүлөрү жети операцияны сунуштайт. Жарыяланган Coze плагини үч куралды (анализ, табуу, түшүндүрүү) сунуштайт, ал эми башка шаблондор кичинерек жарыяланган топтомду сунушташы мүмкүн; колдонуудан мурун ар бир платформа картасын текшериңиз. Төмөндөгү операциялар бирдей FTIR.fun кызматтарына ээ.

Тапшырма MCP куралы REST акыркы чекити Муну AI＇иңизге айтыңыз
Аспап файлын окуу parse_ftir_spectrum POST /parse-spectrum sample.spcти талдап, аныкталган чокуларды тизмелеңиз.
Белгисиз спектрди аныктаңыз 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 натыйжасын алуу.

Колдоого алынган файлдар: SPA, SPC, OPUS, JCAMP-DX, CSV, TSV, Excel, JSON. Жарактуу sampling_mode маанилери: KBr Pellet, Vapor, Solvent, Thin Film, Paraffin Mull, ATR, Diffuse Reflectance, Micro IR, жана Others. Transmission жарактуу маани эмес. Түп нускадагы файл кеңейтүүсүн сактаңыз, анткени FTIR.fun туура парсерди тандайт.

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": "direct_read:spa",
     "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"}
  2. Сурамжылоо get_ftir_report_status (MCP) же GET /ftir/reports/{task_id} чакырыңыз ар 5–10 секунд сайын, completed true болгонго чейин. Бүткөн жоопто report_url, 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 сактаңыз жана сурап туруңуз. Кайталанган отчет тапшырмаларын түзбөңүз.
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 менен код мисалдары бар.

Суроо тапшыруу Форма