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

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

Yapay zekâ asistanınıza veya kendi kodunuza 320,000+ referans spektrumuna, bilgi grafiği tepe noktası akıl yürütmesine ve literatür destekli yoruma doğrudan erişim sağlayın. Bağlanmak için üç yöntemden birini seçin: yapay zekâ asistanları için MCP, kod için REST API veya kod gerektirmeyen platformlar için kullanıma hazır Skill. Aşağıdaki her yol, ilk kez kullananlar için adım adım talimatlar içerir.

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
Listelenme tarihi

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

MCP ve REST API aynı FTIR.fun API anahtarını kullanır. Coze/Doubao, eklenti yayıncısı tarafından yapılandırılan bir hizmet anahtarı kullanır; böylece son kullanıcılar kişisel bir anahtar girmeden eklenti üzerinden çalışır. Kişisel anahtar edinmek yaklaşık bir dakika sürer:

  1. FTIR.fun＇a giriş yapın Ücretsiz hesap oluşturun (yeni hesaplara ücretsiz deneme kredileri dahildir).
  2. API Anahtarları panosunu açın Git Hesap → API Anahtarları ve Oluştur＇a tıklayın.
  3. API anahtarınızı görüntüleyin veya kopyalayın Tam anahtar (ftir_ ile başlar) API Anahtarları panelinde kullanılabilir durumda kalır. Görüntülemek, kopyalamak veya iptal etmek için oraya dönebilirsiniz.
🔑 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.

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

Üçü de aynı motora bağlanır: 320,000+ spektrum, bilgi grafiği tabanlı akıl yürütme ve literatür atıfları. Yalnızca birine ihtiyacınız var. Çalışma şeklinize uygun yolu seçin; MCP, yapay zekâ asistanı kullanıcıları için kullanışlı bir seçenektir.

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

Birleşik MCP ve REST hizmetleri, aynı FTIR.fun işlem kataloğunu sunar. API anahtarları daha dar bir yetki kapsamı alabilirken, platforma özgü bildirimler yalnızca bir alt kümeyi kasıtlı olarak yayınlayabilir. 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.
Yerel verileri dönüştür ve meta verileri koru convert_native_spectrum POST /native-spectrum/convert sample.spa dosyasını JDX＇e dönüştür ve kaynak meta verilerini koru.
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.
🎓 Akademik Tepe Ataması — Bileşimi bilinen numuneler için gelişmiş FTIR.fun REST/MCP özelliği, ölçülen her piki literatürle izlenebilir kanıtlarla atar. Her gönderim 30 puana mal olur veya aktif abonelikle ücretsizdir; durum sorguları ücretlendirilmez. Görevi doğal bir şekilde tanımlayın (örneğin: “Bu spektrum için ölçülen tüm FTIR piklerini ata; numunenin PMMA olduğu biliniyor; raporu bana e-postayla gönder”) — istemci dosyayı sağlar ve JSON veya Base64＇ü kendiniz oluşturmanız asla gerekmez. Tamamlanan sonuçlar hem JSON durumunu hem de korumalı rapor adreslerini döndürür; raporlar herkese açık bir indirme yolunda sunulmaz.

Desteklenen spektrum dosya adı 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 dosya adı uzantısını koruyun. Desteklenmeyen veya okunamayan dosyalar supported_extensions ve supported_formats döndürür. Geçerli sampling_mode değerleri KBr Pellet, Vapor, Solvent, Thin Film, Paraffin Mull, ATR, Diffuse Reflectance, Micro IR ve Others＇tur. Transmission geçerli bir değer değildir.

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": "instrument_import",
     "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 sonuç döndürür. Tam üç eksenli rapor arka planda çalışır ve genellikle 30–90 saniye sürer. task_id değerini saklayın ve isteği yeniden göndermek yerine bunun durumunu sorgulayı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", "status_url": "https://ftir.fun/ftir/reports/rpt_abc123..."}
  2. Anket get_ftir_report_status (MCP) veya GET /ftir/reports/{task_id} çağrısını, completed true olana kadar her 5–10 saniyede bir yapın. Tamamlanan yanıt, report_url, bir report nesnesi (içinde ayrıntılı report_view bulunan yapılandırılmış sonuç 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.
⚠️ task_id değerini saklayın ve işlem tamamlanana veya başarısız olana kadar yoklayın. Kuyruğa alınmış veya çalışmakta olan işlemlerin yinelenen gönderimleri puanları boşa harcar.

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 değerini koruyun ve yoklama yapın. task_id değerini kaybettiyseniz, son görevlerinizi listelemek ve task_id değerini yeniden bulmak için GET /ftir/tasks çağrısını yapı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.

Gereksinim Gönder Form