FTIR.fun FTIR.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 130,000+ istinad spektri, bilik qrafiki pik əsaslandırması və ədəbiyyat dəstəkli təfsirə birbaşa giriş verin. Bağlanmağın üç yolundan birini seçin — AI köməkçiləri üçün MCP, kod üçün REST API və ya kodsuz platformalar üçün hazır Skill. Aşağıdakı hər bir yol ilk dəfə istifadə edənlər üçün addım-addım təlimatla yazılıb.

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
Nəzərdən keçirilib və siyahıya alınıb

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

MCP və REST API hər ikisi bir FTIR.fun API açarından istifadə edir. Coze/Doubao plagin naşiri tərəfindən konfiqurasiya edilmiş xidmət açarından istifadə edir, buna görə də son istifadəçilər şəxsi açar yapışdırmır. Şəxsi açar əldə etmək təxminən bir dəqiqə çəkir:

  1. FTIR.fun-a daxil olun Hesabınız yoxdursa, 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. Açarı dərhal kopyalayın və saxlayın Tam açar (ftir_ ilə başlayır) yalnız bir dəfə göstərilir. Onu təhlükəsiz bir yerdə saxlayın. Əgər itirsəniz, sadəcə yenisini yaradın.
🔑 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.
⚠️ Host edilmiş MCP serveri yalnız FTIR.fun API Açarları Panelində yaradılan hesab API açarını qəbul edir (ftir_ ilə başlayır). Server tərəfindəki master açarlar REST operatorları üçündür və host edilmiş MCP-yə daxil ola bilməz.

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

Hər üçü eyni mühərrikə qoşulur: 130.000+ spektr, bilik qrafiki əsaslandırması və ədəbiyyat sitatları. Sizə yalnız bir lazımdır. İş tərzinizə görə seçin — əmin deyilsiniz? MCP, AI köməkçisi istifadə edən hər kəs üçün ən populyar seçimdir.

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

Cari MCP, REST, n8n və LangChain paylamaları yeddi əməliyyatı ifşa edir. Nəşr olunan Coze plagini üç aləti ifşa edir (təhlil et, tap, izah et) və digər şablonlar daha kiçik bir elan edilmiş dəsti ifşa edə bilər; istifadə etməzdən əvvəl hər platforma kartını yoxlayın. 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.
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.

Dəstəklənən fayllar: SPA, SPC, OPUS, JCAMP-DX, CSV, TSV, Excel, JSON. 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. Orijinal fayl genişlənməsini qoruyun ki, FTIR.fun düzgün analizatoru seçsin.

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": "direct_read:spa",
     "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 tri-axis hesabatı arxa planda işləyir və adətən 30–90 saniyə çəkir. Hesabat işləyərkən yenidən təqdim etməyin — task_id-ni saxlayın və 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"}
  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 true olana qədər. Tamamlanmış cavabda report_url, report_view (strukturlaşdırılmış hesabat məzmunu) və result_num daxildir.
    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.
⚠️ Hesab növbədə və ya işləyərkən eyni hesabatı yenidən təqdim etməyin. task_id-ni saxlayın və tamamlanana və ya uğursuz olana qədər sorğulamağa davam edin. Təkrarlanan təqdimatlar bal itkisinə səbəb olur.

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ğulamağa davam edin. Təkrarlanan hesabat tapşırıqları yaratmayı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.

Sorğunu təqdim et Forma