FTIR.funFTIR.fun
ڈیولپر اور AI انٹیگریشن

FTIR.fun کو کسی بھی AI ٹول یا ایپ سے جوڑیں

اپنے AI معاون یا اپنے کوڈ کو 320,000+ حوالہ جاتی اسپیکٹرا، نالج گراف کی پیک استدلالی صلاحیت، اور لٹریچر سے موصولہ تشریح تک براہِ راست رسائی دیں۔ رابطہ قائم کرنے کے تین طریقوں میں سے ایک منتخب کریں — AI معاونین کے لیے MCP، کوڈ کے لیے REST API، یا نو کوڈ پلیٹ فارمز کے لیے تیار شدہ Skill۔ ذیل میں ہر طریقے کے لیے پہلی بار استعمال کرنے والوں کے لیے مرحلہ وار ہدایات فراہم کی گئی ہیں۔

1. اپنا راستہ منتخب کریں 2. MCP سیٹ اپ 3. REST API 4. مہارتیں اور پلگ انز 5. آپ کا AI کیا کر سکتا ہے 6. خرابیوں کا ازالہ
درج کیا گیا

شروع کرنے سے پہلے — اپنی API کلید حاصل کریں

MCP اور REST API دونوں ایک ہی FTIR.fun API key استعمال کرتے ہیں۔ Coze/Doubao ایک service key استعمال کرتا ہے جسے پلگ اِن پبلشر ترتیب دیتا ہے، اس لیے آخری صارفین ذاتی key پیسٹ کیے بغیر پلگ اِن کے ذریعے کام کرتے ہیں۔ ذاتی key حاصل کرنے میں تقریباً ایک منٹ لگتا ہے:

  1. FTIR.fun میں سائن ان کریں مفت اکاؤنٹ بنائیں (نئے اکاؤنٹس میں مفت آزمائشی کریڈٹس شامل ہیں)۔
  2. API کیز ڈیش بورڈ کھولیں پر جائیں اکاؤنٹ → API کیز اور جنریٹ پر کلک کریں۔
  3. اپنی API کلید دیکھیں یا کاپی کریں مکمل کلید (جو ftir_ سے شروع ہوتی ہے) API Keys ڈیش بورڈ میں دستیاب رہتی ہے۔ آپ وہاں واپس جا کر اسے دیکھ سکتے ہیں، کاپی کر سکتے ہیں، یا منسوخ کر سکتے ہیں۔
🔑 تیار؟ API کیز ڈیش بورڈ کھولیں ایک نئے ٹیب میں، پھر واپس آئیں اور اوپر منتخب کردہ راستے پر عمل کریں۔

مرحلہ 1 — آپ کے لیے کون سا کنکشن صحیح ہے؟

تینوں ایک ہی انجن سے کنیکٹ ہوتے ہیں: 320,000+ اسپیکٹرا، نالج گراف استدلال، اور ادبی حوالہ جات۔ آپ کو صرف ایک کی ضرورت ہے۔ اپنے کام کرنے کے طریقے کے مطابق راستہ منتخب کریں؛ AI اسسٹنٹ صارفین کے لیے MCP ایک آسان آپشن ہے۔

آپ کا AI حقیقت میں کیا کرسکتا ہے

متحدہ MCP اور REST سروسز ایک ہی FTIR.fun آپریشن کیٹلاگ فراہم کرتی ہیں۔ API keys کو ممکن ہے کہ صلاحیتوں کا محدود دائرہ حاصل ہو، جبکہ پلیٹ فارم سے مخصوص اعلانات جان بوجھ کر صرف ایک ذیلی مجموعہ شائع کر سکتے ہیں۔ ذیل میں دیے گئے آپریشنز ایک ہی FTIR.fun سروسز کا اشتراک کرتے ہیں۔

کام MCP ٹول REST اینڈ پوائنٹ اپنے 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, and 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) فوراً نتیجہ دیتی ہے۔ مکمل سہ محوری رپورٹ پس منظر میں چلتی ہے اور عموماً 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", "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 محفوظ رکھیں اور مکمل یا ناکام ہونے تک پول کرتے رہیں۔ قطار میں موجود یا جاری کام کی نقل جمع کرانے سے پوائنٹس ضائع ہوتے ہیں۔

خرابیوں کا ازالہ

آپ کیا دیکھتے ہیں اس کا کیا مطلب ہے کیا کرنا ہے
کلائنٹ ایک براؤزر اجازت نامہ صفحہ کھولتا ہے، یا کہتا ہے کہ اجازت نامہ صفحہ موجود نہیں ہے۔ آپ کا کلائنٹ پرانے OAuth طرز کے سرور انٹری کا استعمال کر رہا ہے۔ FTIR.fun OAuth استعمال نہیں کرتا — صرف ایک API key۔ پرانی 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 کلید فی منٹ 60 درخواستوں کی اجازت دیتا ہے؛ REST نتیجہ اور رپورٹ-اسٹیٹس پڑھنے کے لیے ایک علیحدہ 120 درخواستیں فی منٹ کا بکٹ استعمال ہوتا ہے؛ MCP ہر API کلید اور ٹول کے لیے فی منٹ 60 کالز کی اجازت دیتا ہے۔ دوبارہ کال کرنے سے پہلے ٹول کے ذریعہ بتائی گئی ریٹرائی مدت کا انتظار کریں۔
ایک رپورٹ قطار میں یا چل رہی رہتی ہے۔ مکمل رپورٹس غیر متقاضی طور پر چلتی ہیں اور فوری اسکریننگ سے زیادہ وقت لیتی ہیں۔ وہی 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 میں کوڈ مثالیں شامل ہیں۔

ضرورت جمع کروائیں فارم