FTIR.funFTIR.fun
Интеграция за разработчици и AI

Свържете FTIR.fun с всеки AI инструмент или приложение

Дайте на своя AI асистент или на собствения си код директен достъп до 320,000+ референтни спектъра, разсъждение върху пикове от граф на знанията и интерпретация, подкрепена от научната литература. Изберете един от три начина за свързване — MCP за AI асистенти, REST API за код или готов Skill за платформи без код. Всеки от посочените по-долу пътища има инструкции стъпка по стъпка, написани за потребители, които го използват за първи път.

1. Изберете своя път 2. MCP настройка 3. REST API 4. Умения и приставки 5. Какво може да прави вашият AI 6. Отстраняване на проблеми
Публикувано на

Преди да започнете — вземете своя API ключ

MCP и REST API използват един и същ API ключ за FTIR.fun. Coze/Doubao използва служебен ключ, конфигуриран от издателя на плъгина, така че крайните потребители работят чрез плъгина, без да въвеждат личен ключ. Получаването на личен ключ отнема около минута:

  1. Влезте в FTIR.fun Създайте безплатен акаунт (новите акаунти включват кредити за безплатен пробен период).
  2. Отворете таблото за API ключове Отидете на Акаунт → API ключове и щракнете върху Генериране.
  3. Прегледайте или копирайте своя API ключ Пълният ключ (започва с ftir_) остава достъпен в таблото за API ключове. Можете да се върнете там, за да го видите, копирате или отмените.
🔑 Готови ли сте? Отворете таблото за API ключове в нов раздел, след това се върнете и следвайте пътя, който избрахте по-горе.

Стъпка 1 — Коя връзка е подходяща за вас?

И трите се свързват с един и същ механизъм: 320,000+ спектъра, разсъждение чрез граф на знанията и цитиране на научна литература. Необходимо ви е само едно. Изберете пътя, който съответства на начина ви на работа; MCP е удобна опция за потребители на AI асистенти.

Какво всъщност може да прави вашият 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 Подайте sample.spa за пълен отчет в ATR режим.
Проверете и извлечете този отчет get_ftir_report_status GET /ftir/reports/{task_id} Проверете задачата за отчета и ми дайте връзката, когато е готова.
Обяснете пиковете explain_peaks POST /ftir/explain_peak_assignments Какво показват пиковете при 1715 и 1450 cm-1?
Намерете познат референтен спектър find_spectra POST /ftir/find_spectra Намерете референтни спектри за полистирен.
Отворете отново по-ранен резултат fetch_result GET /ftir/result/{result_num} Извлечете резултат 20260528100755416137536.
🎓 Академично определяне на пикове — За проби с известен състав усъвършенстваната REST/MCP функционалност на FTIR.fun назначава всеки измерен пик с доказателства, проследени в научната литература. Всяко изпращане струва 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_peaks

отговор на 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..."
}

Получаване на пълния отчет (async)

Бързият скрининг (analyze_spectrum) връща резултат незабавно. Пълният триосеви отчет се изпълнява във фонов режим и обикновено отнема 30–90 секунди. Запазете task_id и го проверявайте периодично, вместо да изпращате заявката повторно.

  1. Изпрати Извикайте submit_ftir_report (MCP) или POST /ftir/reports (REST). Получавате обратно task_id и запазен result_num. Полето file_base64 е задължително; другите полета (sampling_mode, prior_context, language_code, sample_name, sample_order_no) са опционални.
    Пример за изпращане (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} на всеки 5–10 секунди, докато completed не стане true. Завършеният отговор включва report_url, обект report (структурирано съдържание на резултата с подробен report_view вътре) и result_num.
    Пример за polling 
    curl https://ftir.fun/ftir/reports/rpt_abc123 \
  -H "X-API-Key: ftir_your_key_here"
    Отговор на polling (в процес) 
    {"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 и извършвайте периодични проверки, докато задачата завърши или се провали. Дублираните изпращания, докато задачата е на опашка или се изпълнява, изразходват точки напразно.

Отстраняване на проблеми

Какво виждате Какво означава Какво да направите
Клиентът отваря страница за оторизация в браузъра или казва, че страницата за оторизация не съществува. Вашият клиент използва стар запис на сървър от тип 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 анализът и парсингът позволяват 60 заявки на минута на API ключ; четенията на REST резултати и отчет-статус използват отделен ресурс от 120 заявки на минута; MCP позволява 60 извиквания на минута за всеки API ключ и инструмент. Изчакайте периода за повторен опит, отчетен от инструмента, преди да извикате отново.
Отчетът остава в опашка или се изпълнява. Пълните отчети се изпълняват асинхронно и отнемат повече време от бързото скриниране. Запазете същия 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.peaks.

Готови ли сте да изграждате?

Пълната REST справка съдържа всяка крайна точка, формати на заявки и отговори, удостоверяване, ограничения на скоростта, кодове за грешки, дефиниции на MCP инструменти и примери за код на Python и curl.

Подаване на изискване Формуляр