FTIR.funFTIR.fun
Tərtibatçı və AI İnteqrasiyası

FTIR.fun-u istənilən AI alətinə və ya tətbiqə qoşun

AI köməkçinizə və ya öz kodunuza 320,000+ istinad spektrinə, bilik qrafı üzrə pik əsaslandırmasına və ədəbiyyata əsaslanan şərhə birbaşa giriş verin. Qoşulmağın üç üsulundan birini seçin — AI köməkçiləri üçün MCP, kod üçün REST API və ya kodlaşdırmasız platformalar üçün hazır Skill. Aşağıdakı hər bir üsul ilk dəfə istifadə edənlər üçün addım-addım təlimatlarla təqdim olunur.

1. Yolunuzu seçin 2. MCP qurulumu 3. REST API 4. Bacarıqlar və plaginlər 5. AI-nız nə edə bilər 6. Problemlərin həlli
Siyahıya alındığı tarix

Başlamazdan əvvəl — API açarınızı əldə edin

MCP və REST API eyni FTIR.fun API açarından istifadə edir. Coze/Doubao xidmət açarından istifadə edir; bu açar plagin naşiri tərəfindən konfiqurasiya olunur, buna görə son istifadəçilər şəxsi açar daxil etmədən plagin vasitəsilə işləyirlər. Şəxsi açarın əldə edilməsi təxminən bir dəqiqə çəkir:

  1. FTIR.fun-a daxil olun Pulsuz hesab yaradın (yeni hesablara pulsuz sınaq kreditləri daxildir).
  2. API Açarları panelini açın Keçin Hesab → API Açarları və Yarat düyməsini klikləyin.
  3. API açarınıza baxın və ya kopyalayın Tam açar (ftir_ ilə başlayır) API Açarları panelində mövcuddur. Oraya qayıdıb onu görə, kopyalaya və ya ləğv edə bilərsiniz.
🔑 Hazırsınız? API Açarları Panelini açın yeni bir tabda, sonra geri qayıdın və yuxarıda seçdiyiniz yolu izləyin.

Addım 1 — Hansı əlaqə sizin üçün uyğundur?

Hər üçü eyni mühərrikə qoşulur: 320,000+ spektr, bilik qrafı üzrə əsaslandırma və ədəbiyyat istinadları. Sizə yalnız biri lazımdır. İş tərzinizə uyğun yolu seçin; MCP süni intellekt köməkçisi istifadəçiləri üçün əlverişli seçimdir.

Süni intellektiniz həqiqətən nə edə bilər

Vahid MCP və REST xidmətləri eyni FTIR.fun əməliyyat kataloqunu təqdim edir. API açarları daha məhdud imkanlar əhatəsi əldə edə bilər, platformaya xas bildirişlər isə qəsdən yalnız alt dəsti dərc edə bilər. Aşağıdakı əməliyyatlar eyni FTIR.fun xidmətlərini paylaşır.

Tapşırıq MCP aləti REST son nöqtəsi Bunu süni intellektinizə deyin
Alət faylını oxuyun parse_ftir_spectrum POST /parse-spectrum sample.spc faylını təhlil edin və aşkar edilmiş zirvələri sadalayın.
Yerli məlumatları çevirin və metadata saxlayın convert_native_spectrum POST /native-spectrum/convert Sample.spa faylını JDX-ə çevirin və mənbə metadata saxlayın.
Naməlum spektri müəyyənləşdirin analyze_ftir_spectrum POST /ftir/analyze_spectrum Bu spektrin hansı polimer olduğunu müəyyən edin.
Tam üç oxlu hesabat təqdim edin submit_ftir_report POST /ftir/reports ATR rejimində tam hesabat üçün sample.spa təqdim edin.
Həmin hesabatı sorğula və əldə et get_ftir_report_status GET /ftir/reports/{task_id} Hesabat tapşırığını yoxlayın və bitdikdə linki mənə verin.
Pikləri izah edin explain_peaks POST /ftir/explain_peak_assignments 1715 və 1450 sm-1-dəki zirvələr nəyi göstərir?
Məlum istinad spektrini tapın find_spectra POST /ftir/find_spectra Polistirol üçün istinad spektrləri tapın.
Əvvəlki nəticəni yenidən açın fetch_result GET /ftir/result/{result_num} 20260528100755416137536 nəticəsini əldə edin.
🎓 Akademik Pik Təyini — Tərkibi məlum olan nümunələr üçün qabaqcıl FTIR.fun REST/MCP funksiyası ölçülmüş hər bir piki ədəbiyyat üzrə izlənə bilən sübutlarla təyin edir. Hər bir təqdimat 30 xal təşkil edir və ya aktiv abunəliklə pulsuzdur; status sorğuları üçün ödəniş tutulmur. Tapşırığı təbii şəkildə təsvir edin (məsələn: “Bu spektr üçün bütün ölçülmüş FTIR pikələrini təyin et; nümunə PMMA kimi tanınır; hesabatı mənə e-poçtla göndər”) — müştəri faylı təmin edir və siz özünüz JSON və ya Base64 qurmaq məcburiyyətində deyilsiniz. Tamamlanmış nəticələr həm JSON statusunu, həm də qorunan hesabat ünvanlarını qaytarır; hesabatlar ictimai yükləmə yolunda açıq deyil.

Dəstəklənən spektr fayl uzantıları (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. Orijinal fayl uzantısını qoruyun. Dəstəklənməyən və ya oxunmayan fayllar supported_extensions və supported_formats qaytarır. Etibarlı sampling_mode dəyərləri: KBr Pellet, Vapor, Solvent, Thin Film, Paraffin Mull, ATR, Diffuse Reflectance, Micro IR və Others. Transmission etibarlı dəyər deyil.

find_spectra cavab nümunəsi

find_spectra cavabı 
{
  "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 cavab nümunəsi

explain_peaks cavabı 
{
  "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..."
}

Tam hesabatı əldə etmək (asinxron)

Sürətli skrininq (analyze_spectrum) dərhal nəticə qaytarır. Tam üçoxlu hesabat arxa planda işləyir və adətən 30–90 saniyə çəkir. task_id-ni saxlayın və tapşırığı yenidən göndərmək əvəzinə onun statusunu sorğulayın.

  1. Təqdim et submit_ftir_report (MCP) və ya POST /ftir/reports (REST) çağırın. Sizə task_id və rezerv edilmiş result_num qaytarılır. file_base64 sahəsi tələb olunur; digər sahələr (sampling_mode, prior_context, language_code, sample_name, sample_order_no) isteğe bağlıdır.
    Nümunə təqdim et (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"}'
    Cavabı təqdim et 
    {"success": true, "task_id": "rpt_abc123...", "result_num": "20260713...",
 "status": "queued", "status_url": "https://ftir.fun/ftir/reports/rpt_abc123..."}
  2. Sorğu get_ftir_report_status (MCP) və ya GET /ftir/reports/{task_id} çağırın hər 5-10 saniyədən bir, completed dəyəri true olana qədər. Tamamlanmış cavab report_url, report obyekti (strukturlaşdırılmış nəticə məzmunu, içərisində ətraflı report_view ilə) və result_num ehtiva edir.
    Sorğulama nümunəsi 
    curl https://ftir.fun/ftir/reports/rpt_abc123 \
  -H "X-API-Key: ftir_your_key_here"
    Sorğulama cavabı (davam edir) 
    {"success": true, "task_id": "rpt_abc123", "status": "running", "progress": 45, "completed": false}
    Sorğu cavabı (tamamlandı) 
    {"success": true, "task_id": "rpt_abc123", "status": "completed", "completed": true,
 "result_num": "20260713...", "report_url": "https://ftir.fun/outputdata/?num=20260713..."}
  3. Yekun hesabatı açın FTIR.fun tərəfindən göstərilən tam tri-axis nəticə səhifəsini görmək üçün brauzerdə tam URL-i https://ftir.fun/outputdata/?num={result_num} açın.
⚠️ task_id-ni saxlayın və proses tamamlanana və ya uğursuz olana qədər sorğulamağa davam edin. Növbədə olan və ya icra edilən zaman təkrar göndərişlər xalları boş yerə sərf edir.

Problemlərin həlli

Gördükləriniz Bunun mənası Nə etməli
Müştəri brauzer icazə səhifəsini açır və ya icazə səhifəsinin mövcud olmadığını deyir. Müştəriniz köhnə OAuth tipli server girişindən istifadə edir. FTIR.fun OAuth istifadə etmir — yalnız API açarı. Köhnə ftirfun server girişini silin, bu səhifədən dəqiq konfiqurasiyanı yapışdırın, müştərini yenidən yükləyin və ftirfun-u yenidən başladın.
401 (MCP) / 401 invalid_api_key (REST) API açarı itkin, vaxtı keçmiş, ləğv edilmiş və ya səhv yapışdırılmışdır. Serveri yenidən başladın və yalnız xam açarı yapışdırın (ftir_ ilə başlayır). Yeni açar yaradın API Açarları Panel lazım olduqda.
Server başlayır, lakin heç bir alət görünmür. Müştəri kataloqu yeniləməyib və ya konfiqurasiya səhv açar adı istifadə edir. VS Code üçün, mcp.json faylının servers (mcpServers deyil) istifadə etdiyini təsdiqləyin. Sonra ftirfun-u dayandırıb yenidən başladın və ya pəncərəni yenidən yükləyin.
403 insufficient_balance Hesabda bu təhlil üçün kifayət qədər bal yoxdur. FTIR.fun-da balansınızı və ya abunəliyinizi yoxlayın, sonra yenidən cəhd edin.
429 rate_limit_exceeded REST təhlili və təhlili hər API açarı üçün dəqiqədə 60 sorğuya icazə verir; REST nəticə və hesabat-status oxunuşları ayrıca dəqiqədə 120 sorğu vedrəsindən istifadə edir; MCP hər API açarı və alət üçün dəqiqədə 60 zəngə icazə verir. Yenidən çağırmazdan əvvəl alət tərəfindən bildirilən təkrar cəhd müddətini gözləyin.
Hesabat növbədə qalır və ya işləyir. Tam hesabatlar asinxron olaraq işləyir və sürətli skrininqdən daha uzun çəkir. Eyni task_id-ni saxlayın və sorğu göndərin. task_id-ni itirmisinizsə, son tapşırıqlarınızı siyahıya almaq və onu yenidən tapmaq üçün GET /ftir/tasks çağırın.
422 18. və ya missing_input Sorğu gövdəsi tələb olunan sahələri ehtiva etmir və ya yanlış formata malikdir. analyze_spectrum üçün ən azı birini təqdim etməlisiniz: peaks, query və ya file_base64. JSON-un düzgün olduğunu, Content-Type-ın application/json olduğunu və tələb olunan sahələrin mövcud olduğunu yoxlayın. Yuxarıdakı nümunə sorğulara baxın.
413 file_too_large Yüklənmiş spektr faylı ölçü limitini keçir. Daha kiçik bir fayl ixrac edin və ya yalnız pik mövqelərini spectrum.peaks sahəsi vasitəsilə istifadə edin.

Qurmağa hazırsınız?

Tam REST istinadı hər bitim nöqtəsini, sorğu və cavab formatlarını, autentifikasiyanı, sürət məhdudiyyətlərini, səhv kodlarını, MCP alət təriflərini və Python və curl-da kod nümunələrini ehtiva edir.

Tələb Təqdim Et Forma