FTIR.funFTIR.fun
ডেভেলপার এবং AI ইন্টিগ্রেশন

যেকোনো AI টুল বা অ্যাপের সাথে FTIR.fun সংযুক্ত করুন

আপনার AI সহকারী বা নিজস্ব কোডকে 320,000+টি রেফারেন্স স্পেকট্রাম, নলেজ-গ্রাফ পিক রিজনিং এবং সাহিত্য-সমর্থিত ব্যাখ্যায় সরাসরি অ্যাক্সেস দিন। সংযোগের জন্য তিনটি পদ্ধতির মধ্যে একটি বেছে নিন — AI সহকারীদের জন্য MCP, কোডের জন্য REST API, অথবা নো-কোড প্ল্যাটফর্মের জন্য প্রস্তুত Skill। নিচের প্রতিটি পদ্ধতিতে প্রথমবারের ব্যবহারকারীদের জন্য ধাপে ধাপে নির্দেশনা রয়েছে।

১. আপনার পথ নির্বাচন করুন 2. MCP সেটআপ 3. REST API 4. দক্ষতা ও প্লাগইন ৫. আপনার AI কি করতে পারে 6. সমস্যা সমাধান
তালিকাভুক্ত হয়েছে

শুরু করার আগে — আপনার API কী পান

MCP এবং REST API উভয়ই একটি FTIR.fun API key ব্যবহার করে। Coze/Doubao এমন একটি service key ব্যবহার করে যা প্লাগইন প্রকাশক কনফিগার করেন, তাই শেষ ব্যবহারকারীরা ব্যক্তিগত key পেস্ট না করেই প্লাগইনের মাধ্যমে কাজ করতে পারেন। একটি ব্যক্তিগত key পেতে প্রায় এক মিনিট সময় লাগে:

  1. FTIR.fun-এ সাইন ইন করুন একটি বিনামূল্যের অ্যাকাউন্ট তৈরি করুন (নতুন অ্যাকাউন্টে বিনামূল্যের ট্রায়াল ক্রেডিট অন্তর্ভুক্ত থাকে)।
  2. API কী ড্যাশবোর্ড খুলুন যান অ্যাকাউন্ট → API কী এবং Generate-এ ক্লিক করুন।
  3. আপনার API কী দেখুন বা অনুলিপি করুন সম্পূর্ণ কী (এটি ftir_ দিয়ে শুরু হয়) API Keys ড্যাশবোর্ডে উপলব্ধ থাকে। আপনি সেখানে ফিরে গিয়ে এটি দেখতে, অনুলিপি করতে বা প্রত্যাহার করতে পারেন।
🔑 প্রস্তুত? API Keys Dashboard খুলুন একটি নতুন ট্যাবে, তারপর ফিরে আসুন এবং উপরে নির্বাচিত পথ অনুসরণ করুন।

ধাপ ১ — কোনটি আপনার জন্য সঠিক?

তিনটিই একই ইঞ্জিনের সঙ্গে সংযুক্ত: 320,000+টি স্পেকট্রা, জ্ঞান-গ্রাফভিত্তিক যুক্তি এবং সাহিত্যসূত্র। আপনার কেবল একটি প্রয়োজন। আপনি যেভাবে কাজ করেন তার সঙ্গে সামঞ্জস্যপূর্ণ পথটি বেছে নিন; AI assistant ব্যবহারকারীদের জন্য MCP একটি সুবিধাজনক বিকল্প।

আপনার AI আসলে কী করতে পারে

একীভূত MCP এবং REST পরিষেবাগুলো একই FTIR.fun অপারেশন ক্যাটালগ প্রকাশ করে। API কীগুলো অপেক্ষাকৃত সীমিত সক্ষমতার পরিসর পেতে পারে, আর প্ল্যাটফর্ম-নির্দিষ্ট ঘোষণাগুলো ইচ্ছাকৃতভাবে কেবল একটি উপসেট প্রকাশ করতে পারে। নিচের অপারেশনগুলো একই FTIR.fun পরিষেবাগুলো ব্যবহার করে।

কাজ MCP টুল REST endpoint আপনার 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 ATR মোডে একটি সম্পূর্ণ রিপোর্টের জন্য sample.spa জমা দিন।
পোল করুন এবং সেই রিপোর্টটি পান 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 আনুন।
🎓 একাডেমিক পিক অ্যাসাইনমেন্ট — পরিচিত সংমিশ্রণযুক্ত নমুনার জন্য, উন্নত FTIR.fun REST/MCP সক্ষমতা সাহিত্য-অনুসরণযোগ্য প্রমাণসহ প্রতিটি পরিমাপ করা পিক অ্যাসাইন করে। প্রতিটি সাবমিশনের জন্য 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..."
}

সম্পূর্ণ রিপোর্ট পাওয়া (অ্যাসিঙ্ক)

দ্রুত স্ক্রিনিং (analyze_spectrum) সঙ্গে সঙ্গে ফলাফল দেয়। পূর্ণ ত্রিমাত্রিক অক্ষ-ভিত্তিক রিপোর্ট ব্যাকগ্রাউন্ডে চলে এবং সাধারণত ৩০–৯০ সেকেন্ড সময় নেয়। task_id সংরক্ষণ করুন এবং পুনরায় জমা না দিয়ে সেটির স্ট্যাটাস poll করুন।

  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 অন্তর্ভুক্ত থাকে।
    পোল উদাহরণ 
    curl https://ftir.fun/ftir/reports/rpt_abc123 \
  -H "X-API-Key: ftir_your_key_here"
    পোল প্রতিক্রিয়া (চলমান) 
    {"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 সংরক্ষণ করুন এবং সম্পূর্ণ বা ব্যর্থ না হওয়া পর্যন্ত poll করুন। queued বা running অবস্থায় পুনরাবৃত্তি করে জমা দিলে পয়েন্ট অপচয় হয়।

সমস্যা সমাধান

আপনি কী দেখেন এর অর্থ কী কি করতে হবে
ক্লায়েন্ট একটি ব্রাউজার অথরাইজেশন পেজ খোলে, বা বলে যে অথরাইজেশন পেজটি বিদ্যমান নেই। আপনার ক্লায়েন্ট একটি পুরানো OAuth-শৈলী সার্ভার এন্ট্রি ব্যবহার করছে। FTIR.fun OAuth ব্যবহার করে না — শুধুমাত্র একটি API কী। পুরানো ftirfun সার্ভার এন্ট্রি মুছুন, এই পৃষ্ঠা থেকে সঠিক কনফিগ পেস্ট করুন, ক্লায়েন্ট রিলোড করুন এবং ftirfun পুনরায় চালু করুন।
401 (MCP) / 401 invalid_api_key (REST) API কী অনুপস্থিত, মেয়াদোত্তীর্ণ, প্রত্যাহার করা হয়েছে, বা ভুলভাবে পেস্ট করা হয়েছে। সার্ভার পুনরায় চালু করুন এবং শুধুমাত্র কাঁচা কী পেস্ট করুন (ftir_ দিয়ে শুরু হয়)। থেকে একটি নতুন কী জেনারেট করুন API কী ড্যাশবোর্ড যদি প্রয়োজন হয়।
সার্ভার শুরু হয় কিন্তু কোনো টুল দেখা যায় না। ক্লায়েন্ট তার ক্যাটালগ রিফ্রেশ করেনি, অথবা কনফিগ ভুল কী নাম ব্যবহার করে। VS Code-এর জন্য, নিশ্চিত করুন mcp.json সার্ভার ব্যবহার করে (mcpServers নয়)। তারপর ftirfun বন্ধ করে পুনরায় চালু করুন, অথবা উইন্ডোটি রিলোড করুন।
403 insufficient_balance এই বিশ্লেষণের জন্য অ্যাকাউন্টে পর্যাপ্ত পয়েন্ট নেই। FTIR.fun-এ আপনার ব্যালান্স বা সাবস্ক্রিপশন চেক করুন, তারপর পুনরায় চেষ্টা করুন।
429 rate_limit_exceeded REST বিশ্লেষণ এবং পার্সিং প্রতি API কী-তে প্রতি মিনিটে ৬০টি অনুরোধ অনুমোদন করে; REST ফলাফল এবং রিপোর্ট-স্ট্যাটাস রিডগুলি একটি পৃথক ১২০টি অনুরোধ প্রতি মিনিটের বালতি ব্যবহার করে; MCP প্রতিটি 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-এ কোড উদাহরণ রয়েছে।

প্রয়োজনীয়তা জমা দিন ফর্ম