সমস্যা সমাধান
সাপোর্ট ছাড়াই সাধারণ সমস্যা শনাক্ত ও সমাধান করুন।
নেটওয়ার্ক / সংযোগ টাইমআউট
- •ফায়ারওয়াল api.whisperx.ai-তে আউটবাউন্ড HTTPS ব্লক করছে
- •VPN রাউটিং সমস্যা
- •DNS ভুল কনফিগারেশন
ধাপে ধাপে সংযোগ পরীক্ষা করুন:
# 1. DNS resolution nslookup api.whisperx.ai # 2. TCP port 443 nc -zv api.whisperx.ai 443 # 3. HTTPS GET curl -v --max-time 5 "https://api.whisperx.ai/api/tags/trending"
ধাপ ১ ব্যর্থ হলে: DNS সেটিংস পরীক্ষা করুন। ধাপ ২ ব্যর্থ হলে: ফায়ারওয়াল পোর্ট ৪৪৩ ব্লক করছে — নেটওয়ার্ক অ্যাডমিনের সাথে যোগাযোগ করুন। ধাপ ৩ ব্যর্থ হলে: TLS সমস্যা — সিস্টেমে আপডেট রুট সার্টিফিকেট আছে কিনা নিশ্চিত করুন।
খালি ফলাফল
- •কোয়েরি অতিরিক্ত নির্দিষ্ট বা বিশেষায়িত
- •ট্যাগ ফিল্টার অতিরিক্ত সীমাবদ্ধ
- •since তারিখ অতিরিক্ত সাম্প্রতিক
- •সেক্টর ফিল্টার মিলে যাওয়া তথ্য বাদ দিচ্ছে
ক্রমশ বিস্তৃত কোয়েরি চেষ্টা করুন:
# Remove tag filter curl "https://api.whisperx.ai/api/intel?q=OpenAI&limit=10" # Remove sector filter curl "https://api.whisperx.ai/api/intel?q=layoff&limit=10" # Extend time window (no since filter) curl "https://api.whisperx.ai/api/intel?q=funding&limit=10" # Try trending tags to see what's active curl "https://api.whisperx.ai/api/tags/trending?limit=20"
খালি ফলাফল ত্রুটি নয় — এর মানে এখন আপনার ফিল্টারের সাথে কোনো তথ্য মিলছে না। প্ল্যাটফর্ম প্রতিদিন বাড়ছে; আগামীকাল আবার চেষ্টা করুন বা অনুসন্ধান প্রসারিত করুন।
429 — রেট সীমিত
- •একই IP থেকে প্রতি মিনিটে ৬০-এর বেশি API কল
- •অনুরোধের মাঝে কোনো বিলম্ব ছাড়া স্বয়ংক্রিয় লুপ
- •একটি সংযোগ ভাগ করে নিচ্ছে একাধিক এজেন্ট
পিছিয়ে আসুন এবং ফ্রিকোয়েন্সি কমান:
- • পুনরায় চেষ্টার আগে ৬০ সেকেন্ড অপেক্ষা করুন
- • স্ক্রিপ্টে অনুরোধের মাঝে sleep 2 যোগ করুন
- • limit প্যারামিটার কমান (৫০-এর বদলে ৫-১০ চেষ্টা করুন)
- • ট্রেন্ডিং ট্যাগ ক্যাশ করুন — ধীরে পরিবর্তিত হয়, প্রতি মিনিটে পোল করার দরকার নেই
উৎপাদন ব্যবহারের জন্য উচ্চ রেট সীমা প্রয়োজন হলে, আমাদের সাথে যোগাযোগ করুন.
5xx — সার্ভার ত্রুটি
- •ক্ষণস্থায়ী আপস্ট্রিম ত্রুটি
- •লোডের মধ্যে Worker কোল্ড স্টার্ট
- •ডেটাবেস সাময়িকভাবে অনুপলব্ধ
পুনরায় চেষ্টার কৌশল:
# Retry once after 10 seconds sleep 10 && curl "https://api.whisperx.ai/api/intel?q=test&limit=1" # If 5xx persists, fall back to trending tags (lighter endpoint) curl "https://api.whisperx.ai/api/tags/trending?limit=10"
৫ মিনিটের বেশি ত্রুটি অব্যাহত থাকলে দেখুন whisperx.ai স্ট্যাটাস আপডেটের জন্য। বেশিরভাগ সমস্যা মিনিটের মধ্যে সমাধান হয়।
ধীর প্রতিক্রিয়া / টাইমআউট
- •সিম্যান্টিক সার্চ চালু (পূর্ণ টেবিল স্ক্যান — অত্যন্ত ব্যয়বহুল)
- •limit অনেক বেশি (>50)
- •Cloudflare এজে নেটওয়ার্ক লেটেন্সি
সিম্যান্টিক সার্চ বন্ধ আছে নিশ্চিত করুন এবং limit কমান:
# Good: keyword search, compact mode, small limit curl "https://api.whisperx.ai/api/intel?q=OpenAI&mode=compact&limit=10" # Bad: semantic search (avoid — full-table scan) # /api/intel?semantic=... ← do NOT use this
WhisperX Skill স্বয়ংক্রিয়ভাবে সিম্যান্টিক সার্চ বন্ধ করে। API সরাসরি কল করলে, উৎপাদনে semantic প্যারামিটার কখনো ব্যবহার করবেন না।
Skill পাওয়া যাচ্ছে না / টুল লোড হচ্ছে না
- •Skill ভুল ডিরেক্টরিতে ইনস্টল হয়েছে
- •SKILL.md অনুপস্থিত বা খালি
- •Shell স্ক্রিপ্ট এক্সিকিউটযোগ্য নয়
- •WHISPERX_BASE_URL এনভায়রনমেন্ট ভেরিয়েবল ভুলভাবে সেট
আপনার ইনস্টলেশন যাচাই করুন:
# Check skill files exist ls ~/.claude/skills/whisperx/ # Expected: SKILL.md tools/ ls ~/.claude/skills/whisperx/tools/ # Expected: search.sh get.sh trending.sh trends.sh connections.sh export.sh # Check scripts are executable ls -la ~/.claude/skills/whisperx/tools/*.sh # Should show -rwxr-xr-x permissions # Fix permissions if needed chmod +x ~/.claude/skills/whisperx/tools/*.sh # Quick smoke test bash ~/.claude/skills/whisperx/tools/trending.sh 5
এখনও কাজ করছে না? থেকে পুনরায় ইনস্টল করুন দ্রুত শুরু গাইড.
ডায়াগনস্টিক রিপোর্ট তৈরি করুন
এখনও আটকে আছেন? শেয়ারযোগ্য ডায়াগনস্টিক বান্ডেল তৈরি করতে এটি চালান (কোনো সংবেদনশীল ডেটা নেই):
echo "=== WhisperX Diagnostic ===" && \
echo "Date: $(date -u)" && \
echo "OS: $(uname -a)" && \
echo " && \
echo "--- Connectivity ---" && \
curl -s -o /dev/null -w "HTTP %{http_code} | Time %{time_total}s" \
"https://api.whisperx.ai/api/tags/trending?limit=1" && \
echo " && \
echo "--- Skill files ---" && \
ls -la ~/.claude/skills/whisperx/tools/ 2>/dev/null || echo "Skill not installed"সাপোর্ট চাওয়ার সময় আউটপুট পেস্ট করুন। এতে আপনার IP, কোয়েরি বা কী নেই।