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

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

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

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

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

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

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

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

تینوں ایک ہی انجن سے جڑتے ہیں: 130,000+ اسپیکٹرا، نالج گراف استدلال، اور لٹریچر حوالہ جات۔ آپ کو صرف ایک کی ضرورت ہے۔ اپنے کام کے طریقے کے مطابق منتخب کریں — یقین نہیں؟ MCP AI اسسٹنٹ استعمال کرنے والوں کے لیے سب سے مقبول انتخاب ہے۔

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

موجودہ MCP، REST، n8n، اور LangChain تقسیمات سات آپریشنز کو ظاہر کرتی ہیں۔ شائع شدہ Coze پلگ ان تین ٹولز (تجزیہ کریں، تلاش کریں، وضاحت کریں) کو ظاہر کرتا ہے، اور دیگر ٹیمپلیٹس ایک چھوٹا اعلان کردہ سیٹ ظاہر کر سکتے ہیں؛ استعمال سے پہلے ہر پلیٹ فارم کارڈ چیک کریں۔ نیچے دیے گئے آپریشنز ایک ہی FTIR.fun خدمات کا اشتراک کرتے ہیں۔

کام MCP ٹول REST اینڈ پوائنٹ اپنے 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 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 رکھیں اور پول کرتے رہیں۔ ڈپلیکیٹ رپورٹ ٹاسک نہ بنائیں۔
422 یا missing_input درخواست کا باڈی مطلوبہ فیلڈز نہیں رکھتا یا غلط فارمیٹ ہے۔ analyze_spectrum کے لیے، آپ کو کم از کم ایک فراہم کرنا ہوگا: peaks، query، یا file_base64۔ یقینی بنائیں کہ آپ کا JSON درست ہے، Content-Type application/json ہے، اور مطلوبہ فیلڈز موجود ہیں۔ اوپر مثال کی درخواستیں دیکھیں۔
413 file_too_large اپ لوڈ کردہ اسپیکٹرم فائل سائز کی حد سے تجاوز کر گئی ہے۔ چھوٹی فائل ایکسپورٹ کریں یا صرف spectrum.peaks فیلڈ کے ذریعے چوٹیوں کی پوزیشنیں استعمال کریں۔

تعمیر کرنے کے لیے تیار ہیں؟

مکمل REST حوالہ میں ہر اینڈ پوائنٹ، درخواست اور جواب کے فارمیٹس، تصدیق، شرح کی حدود، خرابی کے کوڈز، MCP ٹول کی تعریفیں، اور Python اور curl میں کوڈ مثالیں شامل ہیں۔

درخواست جمع کریں فارم