FTIR.fun FTIR.fun
Geliştirici ve Yapay Zeka Entegrasyonu

FTIR.fun＇u Herhangi Bir Yapay Zeka Aracına veya Uygulamasına Bağlayın

AI asistanınıza veya kendi kodunuza 130.000＇den fazla referans spektrumuna, bilgi grafiği pik akıl yürütmesine ve literatür destekli yoruma doğrudan erişim sağlayın. Bağlanmak için üç yoldan birini seçin — AI asistanları için MCP, kod için REST API veya kodsuz platformlar için hazır bir Yetenek. Aşağıdaki her yol, ilk kez kullanacaklar için adım adım talimatlarla yazılmıştır.

1. Yolunuzu seçin 2. MCP kurulumu 3. REST API 4. Beceriler ve eklentiler 5. AI＇nızın neler yapabileceği 6. Sorun giderme
İncelendi ve listelendi

Başlamadan önce — API anahtarınızı alın

MCP ve REST API＇nin her ikisi de bir FTIR.fun API anahtarı kullanır. Coze/Doubao, eklenti yayıncısı tarafından yapılandırılmış bir hizmet anahtarı kullanır, bu nedenle son kullanıcılar kişisel bir anahtar yapıştırmaz. Kişisel bir anahtar almak yaklaşık bir dakika sürer:

  1. FTIR.fun＇a giriş yapın Hesabınız yoksa ücretsiz bir hesap oluşturun. Yeni hesaplar ücretsiz deneme kredileri içerir.
  2. API Anahtarları panosunu açın Git Hesap → API Anahtarları ve Oluştur＇a tıklayın.
  3. Anahtarı hemen kopyalayın ve kaydedin Tam anahtar (ftir_ ile başlar) yalnızca bir kez gösterilir. Güvenli bir yerde saklayın. Kaybederseniz, yeni bir tane oluşturun.
🔑 Hazır mısınız? API Anahtarları Panosunu Aç yeni bir sekmede, ardından geri gelin ve yukarıda seçtiğiniz yolu izleyin.
⚠️ Barındırılan MCP sunucusu yalnızca FTIR.fun API Anahtarları Panosu＇nda oluşturulan bir hesap API anahtarını kabul eder (ftir_ ile başlar). Sunucu tarafı ana anahtarlar REST operatörleri içindir ve barındırılan MCP＇de oturum açamaz.

Adım 1 — Hangi bağlantı sizin için uygun?

Her üçü de aynı motora bağlanır: 130.000+ spektrum, bilgi grafiği çıkarımı ve literatür atıfları. Yalnızca birine ihtiyacınız var. Çalışma şeklinize göre seçin — emin değil misiniz? MCP, bir yapay zeka asistanı kullanan herkes için en popüler seçimdir.

Yapay zekanızın gerçekte neler yapabileceği

Mevcut MCP, REST, n8n ve LangChain dağıtımları yedi işlemi açığa çıkarır. Yayınlanan Coze eklentisi üç araç (analiz et, bul, açıkla) sunar ve diğer şablonlar daha küçük bir bildirilen küme sunabilir; kullanmadan önce her platform kartını kontrol edin. Aşağıdaki işlemler aynı FTIR.fun hizmetlerini paylaşır.

Görev MCP aracı REST uç noktası Bunu yapay zekanıza söyleyin
Bir cihaz dosyasını oku parse_ftir_spectrum POST /parse-spectrum sample.spc dosyasını ayrıştırın ve tespit edilen pikleri listeleyin.
Bilinmeyen bir spektrumu tanımlayın analyze_ftir_spectrum POST /ftir/analyze_spectrum Bu spektrumun hangi polimer olduğunu belirleyin.
Tam üç eksenli bir rapor gönderin submit_ftir_report POST /ftir/reports ATR modunda tam rapor için sample.spa dosyasını gönderin.
Bu raporu yokla ve al get_ftir_report_status GET /ftir/reports/{task_id} Rapor görevini kontrol edin ve bittiğinde bana bağlantıyı verin.
Zirveleri açıklayın explain_peaks POST /ftir/explain_peak_assignments 1715 ve 1450 cm-1＇deki pikler neyi gösteriyor?
Bilinen bir referans spektrumu bulun find_spectra POST /ftir/find_spectra Polistiren için referans spektrumları bulun.
Önceki bir sonucu yeniden aç fetch_result GET /ftir/result/{result_num} 20260528100755416137536 sonucunu getir.

Desteklenen dosyalar: SPA, SPC, OPUS, JCAMP-DX, CSV, TSV, Excel, JSON. Geçerli sampling_mode değerleri: KBr Pellet, Vapor, Solvent, Thin Film, Paraffin Mull, ATR, Diffuse Reflectance, Micro IR ve Others. Transmission geçerli bir değer değildir. Orijinal dosya uzantısını koruyun, böylece FTIR.fun doğru ayrıştırıcıyı seçer.

find_spectra yanıt örneği

find_spectra yanıtı 
{
  "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 yanıt örneği

explain_peaks yanıtı 
{
  "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 raporu alma (eşzamansız)

Hızlı tarama (analyze_spectrum) hemen döner. Tam üç eksenli rapor arka planda çalışır ve genellikle 30–90 saniye sürer. Bir rapor çalışırken yeniden göndermeyin — task_id＇yi koruyun ve yoklayın.

  1. Gönder submit_ftir_report (MCP) veya POST /ftir/reports (REST) çağrısı yapın. Bir task_id ve ayrılmış bir result_num alırsınız. file_base64 alanı zorunludur; diğer alanlar (sampling_mode, prior_context, language_code, sample_name, sample_order_no) isteğe bağlıdır.
    Gönderme örneği (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"}'
    Yanıtı gönder 
    {"success": true, "task_id": "rpt_abc123...", "result_num": "20260713...", "status": "queued"}
  2. Anket get_ftir_report_status (MCP) veya GET /ftir/reports/{task_id} adresini, completed true olana kadar her 5–10 saniyede bir çağırın. Tamamlanan yanıt, report_url, report_view (yapılandırılmış rapor içeriği) ve result_num içerir.
    Yoklama örneği 
    curl https://ftir.fun/ftir/reports/rpt_abc123 \
  -H "X-API-Key: ftir_your_key_here"
    Yoklama yanıtı (devam ediyor) 
    {"success": true, "task_id": "rpt_abc123", "status": "running", "progress": 45, "completed": false}
    Yoklama yanıtı (tamamlandı) 
    {"success": true, "task_id": "rpt_abc123", "status": "completed", "completed": true,
 "result_num": "20260713...", "report_url": "https://ftir.fun/outputdata/?num=20260713..."}
  3. Nihai raporu aç FTIR.fun tarafından oluşturulan tam üç eksenli sonuç sayfasını görüntülemek için https://ftir.fun/outputdata/?num={result_num} tam URL＇sini bir tarayıcıda açın.
⚠️ Aynı raporu kuyrukta veya çalışırken tekrar göndermeyin. task_id＇yi koruyun ve tamamlanana veya başarısız olana kadar yoklamaya devam edin. Yinelenen gönderimler puan israfına neden olur.

Sorun Giderme

Gördüğünüz Anlamı Ne yapılmalı
İstemci bir tarayıcı yetkilendirme sayfası açar veya yetkilendirme sayfasının mevcut olmadığını söyler. İstemciniz eski bir OAuth tarzı sunucu girişi kullanıyor. FTIR.fun OAuth kullanmaz — yalnızca bir API anahtarı. Eski ftirfun sunucu girişini silin, bu sayfadaki tam yapılandırmayı yapıştırın, istemciyi yeniden yükleyin ve ftirfun＇u tekrar başlatın.
401 (MCP) / 401 invalid_api_key (REST) API anahtarı eksik, süresi dolmuş, iptal edilmiş veya yanlış yapıştırılmış. Sunucuyu yeniden başlatın ve yalnızca ham anahtarı yapıştırın (ftir_ ile başlar). Şuradan yeni bir anahtar oluşturun: API Anahtarları Panosu gerekirse.
Sunucu başlıyor ancak hiçbir araç görünmüyor. İstemci kataloğunu yenilemedi veya yapılandırma yanlış anahtar adını kullanıyor. VS Code için, mcp.json＇un servers (mcpServers değil) kullandığını onaylayın. Ardından ftirfun＇u durdurun ve başlatın veya pencereyi yeniden yükleyin.
403 insufficient_balance Hesabın bu analiz için yeterli puanı yok. FTIR.fun＇da bakiyenizi veya aboneliğinizi kontrol edin, ardından tekrar deneyin.
429 rate_limit_exceeded REST analizi ve ayrıştırma, API anahtarı başına dakikada 60 isteğe izin verir; REST sonuç ve rapor-durum okumaları ayrı bir dakikada 120 istek kotası kullanır; MCP, her API anahtarı ve araç için dakikada 60 çağrıya izin verir. Tekrar çağırmadan önce aracın bildirdiği yeniden deneme süresini bekleyin.
Bir rapor sırada bekler veya çalışır durumda kalır. Tam raporlar eşzamansız olarak çalışır ve hızlı taramadan daha uzun sürer. Aynı task_id＇yi koruyun ve sorgulamaya devam edin. Yinelenen rapor görevleri oluşturmayın.
422 veya missing_input İstek gövdesinde gerekli alanlar eksik veya geçersiz biçim var. analyze_spectrum için en az birini sağlamalısınız: peaks, query veya file_base64. JSON＇unuzun geçerli olduğunu, Content-Type＇ın application/json olduğunu ve gerekli alanların mevcut olduğunu kontrol edin. Yukarıdaki örnek isteklere bakın.
413 file_too_large Yüklenen spektrum dosyası boyut sınırını aşıyor. Daha küçük bir dosya dışa aktarın veya spectrum.peaks alanı aracılığıyla yalnızca tepe konumlarını kullanın.

Oluşturmaya hazır mısınız?

Tam REST referansı, her uç noktayı, istek ve yanıt biçimlerini, kimlik doğrulamayı, hız sınırlarını, hata kodlarını, MCP araç tanımlarını ve Python ile curl＇de kod örneklerini içerir.

Talep Gönder Form