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

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

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

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

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

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

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

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

তিনটিই একই ইঞ্জিনের সাথে সংযুক্ত: 130,000+ স্পেকট্রা, নলেজ-গ্রাফ রিজনিং, এবং সাহিত্য উদ্ধৃতি। আপনার শুধুমাত্র একটি প্রয়োজন। কাজ করার পদ্ধতি অনুযায়ী বেছে নিন — নিশ্চিত নন? MCP যেকোনো AI সহায়ক ব্যবহারকারীর জন্য সবচেয়ে জনপ্রিয় পছন্দ।

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

বর্তমান MCP, REST, n8n, এবং LangChain বিতরণ সাতটি অপারেশন প্রকাশ করে। প্রকাশিত Coze প্লাগইন তিনটি টুল প্রকাশ করে (analyze, find, explain), এবং অন্যান্য টেমপ্লেটগুলি একটি ছোট ঘোষিত সেট প্রকাশ করতে পারে; ব্যবহারের আগে প্রতিটি প্ল্যাটফর্ম কার্ড চেক করুন। নীচের অপারেশনগুলি একই FTIR.fun পরিষেবাগুলি ভাগ করে।

কাজ MCP টুল REST endpoint আপনার AI-কে এটি বলুন
একটি ইন্সট্রুমেন্ট ফাইল পড়ুন parse_ftir_spectrum POST /parse-spectrum sample.spc পার্স করুন এবং সনাক্ত করা পিক তালিকাভুক্ত করুন।
একটি অজানা স্পেকট্রাম চিহ্নিত করুন 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 আনুন।

সমর্থিত ফাইল: SPA, SPC, OPUS, JCAMP-DX, CSV, TSV, Excel, JSON। বৈধ sampling_mode মানগুলি হল KBr Pellet, Vapor, Solvent, Thin Film, Paraffin Mull, ATR, Diffuse Reflectance, Micro IR এবং Others। Transmission একটি বৈধ মান নয়। মূল ফাইল এক্সটেনশন রাখুন যাতে FTIR.fun সঠিক পার্সার বেছে নেয়।

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": "direct_read:spa",
     "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) তাৎক্ষণিকভাবে ফেরত আসে। সম্পূর্ণ ট্রাই-অ্যাক্সিস রিপোর্ট ব্যাকগ্রাউন্ডে চলে এবং সাধারণত 30–90 সেকেন্ড সময় নেয়। রিপোর্ট চলাকালীন পুনরায় জমা দেবেন না — task_id সংরক্ষণ করুন এবং এটি পোল করুন।

  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"}
  2. পোল প্রতি 5–10 সেকেন্ডে get_ftir_report_status (MCP) অথবা GET /ftir/reports/{task_id} কল করুন যতক্ষণ না completed true হয়। সম্পূর্ণ প্রতিক্রিয়ায় report_url, 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 সংরক্ষণ করুন এবং এটি সম্পূর্ণ বা ব্যর্থ না হওয়া পর্যন্ত পোলিং চালিয়ে যান। ডুপ্লিকেট জমা পয়েন্ট নষ্ট করে।

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

আপনি কী দেখেন এর অর্থ কী কি করতে হবে
ক্লায়েন্ট একটি ব্রাউজার অথরাইজেশন পেজ খোলে, বা বলে যে অথরাইজেশন পেজটি বিদ্যমান নেই। আপনার ক্লায়েন্ট একটি পুরানো 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 রাখুন এবং পোলিং চালিয়ে যান। ডুপ্লিকেট রিপোর্ট টাস্ক তৈরি করবেন না।
422 অথবা missing_input অনুরোধ বডিতে প্রয়োজনীয় ফিল্ড অনুপস্থিত বা ভুল ফরম্যাট। analyze_spectrum-এর জন্য আপনাকে অন্তত একটি প্রদান করতে হবে: peaks, query, বা file_base64। নিশ্চিত করুন আপনার JSON বৈধ, Content-Type application/json, এবং প্রয়োজনীয় ফিল্ড উপস্থিত। উপরের উদাহরণ অনুরোধগুলি দেখুন।
413 file_too_large আপলোড করা স্পেকট্রাম ফাইল আকারের সীমা ছাড়িয়ে গেছে। একটি ছোট ফাইল রপ্তানি করুন অথবা spectrum.peaks ফিল্ডের মাধ্যমে শুধুমাত্র পিক অবস্থান ব্যবহার করুন।

বিল্ড করতে প্রস্তুত?

সম্পূর্ণ REST রেফারেন্সে প্রতিটি এন্ডপয়েন্ট, অনুরোধ এবং প্রতিক্রিয়া ফরম্যাট, অথেন্টিকেশন, রেট লিমিট, ত্রুটি কোড, MCP টুল সংজ্ঞা, এবং Python এবং curl-এ কোড উদাহরণ রয়েছে।

অনুরোধ জমা দিন ফর্ম