सीधे सामग्री पर जाएँ
HI
API कुंजी प्राप्त करें
दस्तावेज़ देखें

शुरू करें

सामान्य प्रश्न और समस्या समाधान

अपनी पहुंच की जाँच करें, असफल अनुरोध को ठीक करें या FlashData का उपयोग करने के बारे में उत्तर ढूंढें।

इस पेज पर

एक मुफ्त एक्सेस चेक के साथ शुरू करें

जाँच करें जहां कार्य विफल रहा। अपने मौजूदा क्रेडेंशियल का उपयोग करें; इन कमांडों ने एक क्वेरी प्रस्तुत नहीं की है।

अपने बचाया CLI पहुँच का प्रयोग करें। एक नामित प्रोफ़ाइल के लिए, प्रत्येक कमांड के लिए --profile NAME को संलग्न करें। ये पढ़े गए प्रश्न क्रेडिट खर्च नहीं करते हैं।

फ्री खाता पढ़ता
flashdata --version
flashdata doctor --offline
flashdata auth status --json

क्या जांचें

पहचान में access: ready होना चाहिए और इसमें आपके स्रोत को दायरे में शामिल करना चाहिए। CLI JSON में, पहचान data.identity.identity पर है; data.accessVerified: true की भी आवश्यकता है। accessVerified: false के साथ एक सफल कमांड ने एक्सेस की पुष्टि नहीं की है।

एक नामित CLI प्रोफाइल के लिए, नीचे दिए गए प्रत्येक कमांड के लिए --profile NAME को संलग्न करें। मूल --state-dir और OS उपयोगकर्ता को रखें। FLASHDATA_API_KEY एक बचाया CLI कुंजी ओवरराइड करता है; SDKs और MCP होस्ट अपने विश्वसनीय विन्यास का उपयोग करते हैं।

समस्या का पता लगाएं और ठीक करें

उस लक्षण को खोलें जो आपकी त्रुटि से मेल खाता है। मूल कार्य से IDs और रसीदों का उपयोग करें।

कमान नहीं मिला या प्रोफ़ाइल लापता

कोई निष्पादन योग्य: अपने OS/CPU के लिए रिलीज को स्थापित करें और इसकी डायरेक्टरी को PATH में जोड़ें। मिसिंग प्रोफाइल: मूल OS उपयोगकर्ता और राज्य निर्देशिका का उपयोग करें। अनुसूचीकार या कंटेनर के अंदर भी चेक करें।

निष्पादन योग्य
command -v flashdata
flashdata --version
flashdata doctor --offline

401 / 403: कुंजी, गुंजाइश या समाप्ति

एक बचाया मालिक कुंजी को बदलने के लिए, अनुमोदित कुंजी को छिपे हुए प्रॉम्प्ट में पेस्ट करें। यदि FLASHDATA_API_KEY सेट किया गया है, तो उस समय के बजाय उस रहस्य को अद्यतन करें; एक अन्य CLI कुंजी को सहेजना इसे ओवरराइड नहीं करेगा।

  1. 401: एक समाप्त, रद्द या गलत तरीके से कॉन्फ़िगर कुंजी के लिए जाँच करें। 403: पहचान के दायरे के साथ अनुरोधित स्रोत की तुलना करें।
  2. REST और SDK का उपयोग X-API-Key. एक MCP OAuth टोकन एक API कुंजी को प्रतिस्थापित नहीं कर सकता है। अस्थायी पहुंच के लिए, नीचे दावा वसूली का उपयोग करें।
एक बचाया मालिक कुंजी को बदलें और सत्यापित करें
flashdata auth login --replace
flashdata auth status --json

दावा स्वीकृत, लेकिन एजेंट अभी भी परीक्षण पहुँच है

उसी CLI प्रोफाइल में हैंडऑफ़ को समाप्त करें जिसने दावा किया। मालिक ब्राउज़र में साइनअप, ईमेल सत्यापन और सहमति को पूरा करता है; CLI को क्रेडेंशियल प्राप्त होता है।

समाप्त और सत्यापित करें
flashdata auth finish --wait --timeout 10m
flashdata auth status --json

402: अपर्याप्त क्रेडिट

अपने स्रोत के लिए वर्तमान मूल्य के साथ availableCredits की तुलना करें। मालिक के संतुलन का उपयोग करने के लिए एक थकावट परीक्षण का दावा करें, या मालिक को पुनः प्रयास करने से पहले Billing की समीक्षा करने दें।

अपने बचाया CLI पहुँच का प्रयोग करें। एक नामित प्रोफ़ाइल के लिए, प्रत्येक कमांड के लिए --profile NAME को संलग्न करें। ये पढ़े गए प्रश्न क्रेडिट खर्च नहीं करते हैं।

फ्री खाता पढ़ता
flashdata account balance
flashdata account pricing --source google_search --request-count 1

429: पुनः प्रयास करने से पहले प्रतीक्षा करें

Retry-After को विफल प्रतिक्रिया पर पढ़ें: सेकंड या एक HTTP तारीख। तब तक प्रतीक्षा करें और परंपरागतता को कम करें। परीक्षण पंजीकरण प्रति 24-घंटे की खिड़की प्रति IP तीन पंजीकरण की अनुमति देता है; मूल प्रोफ़ाइल और पंजीकरण प्रमाण का पुन: उपयोग करें।

यह मुफ्त पढ़ने से हेडर, स्थिति और शरीर की बचत होती है। कार्य से Retry-After का उपयोग करें जो विफल हो गया; क्वेरी, पंजीकरण और खाता पढ़ने की सीमा अलग हो सकती है।

प्रतिक्रिया कैप्चर करें · Bash / cURL / jq
# Bash + cURL + jq. This is a free account read.
(
test -n "$FLASHDATA_API_KEY" || { printf 'Set FLASHDATA_API_KEY first\n' >&2; exit 1; }
curl --silent --show-error --max-time 20 \
  --header "X-API-Key: $FLASHDATA_API_KEY" \
  --dump-header diagnostic-headers.txt --output diagnostic.json \
  --write-out '%{http_code}\n' \
  'https://api.flashdata.dev/v2/api-access/identity' > diagnostic-status.txt || exit
printf 'HTTP '; cat diagnostic-status.txt
awk 'tolower($1) == "retry-after:" {
  $1=""; sub(/^ /, ""); sub(/\r$/, ""); print "Retry-After: " $0
}' diagnostic-headers.txt
if jq -e 'type == "object"' diagnostic.json >/dev/null 2>&1; then
  jq '{access, scopes, status, code, requestId}
    | with_entries(select(.value != null))' diagnostic.json
else
  printf 'Non-JSON response saved in diagnostic.json; check the HTTP status.\n'
fi
)
खाते की क्षमता का निरीक्षण करना
flashdata account limits

400 / 422: अस्वीकार इनपुट या प्रसंस्करण विफलता

HTTP त्रुटि से कोड, विस्तार और fieldErrors पढ़ें। अनुरोध निकाय को ठीक करें, इसे request.json के रूप में सहेजें, फिर इसे मान्य करें। एक निजी इनपुट फ़ाइल में भंडारण क्रेडेंशियल डाउनलोड करें। यदि 422 मौजूदा नौकरी के परिणाम से आता है, तो पहले job.error का निरीक्षण करें।

बिना किसी भुगतान जमा करने के मान्य
flashdata query --input request.json --mode async --dry-run --json

नौकरी लंबित, या HTTP 200 एक असफल नौकरी के साथ

submission.json से नौकरी पढ़ें, आपकी सहेजी गई async रसीद। HTTP 200 का मतलब है कि स्थिति सफल हुई; job.status कार्य परिणाम (data.status) CLI JSON में) है। Batch के लिए, submission.json के रूप में प्रश्नों से प्रासंगिक प्रविष्टि को बचाएं।

राज्य या त्रुटिअगली कार्रवाई
pending / processingउसी काम पर प्रतीक्षा करें; इसे फिर से प्रस्तुत न करें।
completedमौजूदा परिणाम को आकर्षित और सहेजना।
failedसही काम जमा करने से पहले job.error का निरीक्षण करें।
404नौकरी की जाँच करें ID और जमा करने वाला खाता।
409परिणाम तैयार नहीं हैं। उसी नौकरी पर मतदान करें।
410स्टोर किए गए JSON को 24 घंटों के बाद समाप्त हो गया। अपनी सहेजी गई प्रतिलिपि का उपयोग करें; वितरित मीडिया का अपना खुद का भंडारण अवधारण है।
बचाया नौकरी का निरीक्षण करें · Bash / jq
# Bash + jq. CLI receipts use remoteId; HTTP receipts use id.
(
set -e
JOB_ID=$(jq -er '.remoteId // .id' submission.json)
flashdata jobs get "$JOB_ID" --json
)
अभी भी चल रहा है · लौटे JOB_ID का उपयोग करें
flashdata jobs wait JOB_ID
Completed · एक नया आउटपुट फ़ाइल नाम का उपयोग करें
flashdata jobs result JOB_ID --output recovered-result.json

टाइमआउट / 5xx: क्या कार्य स्वीकार किया गया था?

एक POST को पुनः प्राप्त करने से पहले मूल रन और History का निरीक्षण करें। एक निश्चित स्वीकृत नौकरी को पुनर्प्राप्त करें। यदि स्वीकृति अज्ञात है, तो रन ID और संपर्क समर्थन को रखें; IDs को बदलना और दोहराना शुल्क हो सकता है।

Inspect first · RUN_ID की जगह
flashdata runs show RUN_ID
स्वीकृत कार्य की पुष्टि की
flashdata runs recover RUN_ID

CLI output_exists: परिणाम फ़ाइल पहले से ही मौजूद है

CLI, --output फ़ाइलों को ओवरराइट नहीं करता है। मौजूदा फ़ाइल को पढ़ें, या मूल --run-id और अनुरोध को रखते हुए एक नया आउटपुट फ़ाइल नाम चुनें। इस त्रुटि को बायपास करने के लिए एक नया रन ID को आविष्कार न करें।

मूल रन का निरीक्षण
flashdata runs show RUN_ID

खाली खोज, लापता कैप्शन या पठनीय डाउनलोड

ये कमांड केवल स्थानीय परिणाम फ़ाइलों को पढ़ते हैं, नहीं CLI के stdout लिफाफे।

MCP उपकरण लापता या प्रमाणीकरण समाप्त हो गया

मेजबान की जाँच करें कार्य चल रहा है। एक सूचीबद्ध सर्वर विन्यास की पुष्टि करता है, कोई कार्य कनेक्शन नहीं है। यदि कॉन्फ़िगर किया गया हो तो OAuth कनेक्शन को लॉग इन करने की आवश्यकता होती है, तो अपने लॉगिन कमांड को चलाने और ब्राउज़र अनुमोदन को पूरा करने की आवश्यकता होती है, फिर टूल सूची को ताज़ा करें।

कनेक्शन स्थिति और उपकरण की जांच के लिए Codex CLI में ओपन /mcp। ऐप में, कॉन्फ़िगर किए गए सर्वर की जांच करें और सेटअप परिवर्तनों के बाद एक नया सत्र शुरू करें।

सम्पर्क
codex mcp list
केवल जब OAuth लॉगिन की आवश्यकता होती है
codex mcp login flashdata --scopes mcp:research

कौशल स्थापित लेकिन एजेंट इसे ढूंढ या इस्तेमाल नहीं कर सकता है

उसी परियोजना की जाँच करें, प्रोफ़ाइल होस्ट करें और स्थान स्थापित करें, फिर एक ताजा एजेंट सत्र शुरू करें। CLI कार्य कौशल को CLI की आवश्यकता होती है; flashdata-mcp को कनेक्टेड MCP सर्वर की आवश्यकता होती है। एक कौशल स्थापित करने से सर्वर को कनेक्ट नहीं किया जाता है या खाता अनुमति प्रदान नहीं की जाती है।

डिफ़ॉल्ट CLI कौशल बंडल की जाँच करें
flashdata skills verify --agent codex

अक्सर पूछे जाने वाले प्रश्न

कनेक्ट हो रहा है

क्या मुझे एआई एजेंट की आवश्यकता है?

नहीं। HTTP API, Go/Python/TypeScript SDK, CLI या कंसोल का सीधे प्रयोग करें। MCP और कौशल एजेंटों के लिए अतिरिक्त विकल्प हैं।

कौन सा इंटरफ़ेस मुझे चुनना चाहिए?

एक SDK या HTTP API का उपयोग एक ऐप के अंदर करें, टर्मिनल कार्यों के लिए CLI, और MCP को MCP-capable होस्ट के लिए करें। कौशल CLI कार्यों या कनेक्टेड MCP टूल के लिए निर्देश प्रदान करते हैं; वे प्रमाणीकरण की जगह नहीं लेते हैं।

क्या मैं आवर्ती कार्यों के लिए प्रत्यय का पुन: उपयोग कर सकता हूं?

हाँ। मालिक पहुँच का उपयोग करें और उसी संरक्षित CLI प्रोफाइल, रनटाइम गुप्त या MCP कनेक्शन को संरक्षित करें। API-key Access के लिए, recurringAllowed: true की जाँच करें। आपका होस्ट या शेड्यूलर शेड्यूल चलाता है।

क्या स्थानीय सेटिंग्स को हटाने से पहुँच वापस आ जाती है?

नहीं। कंसोल में API कुंजी या कनेक्शन को रद्द करें। स्थानीय सेटिंग्स को हटाने से केवल उस स्थानीय प्रतिलिपि को हटा दिया जाता है।

परीक्षण और क्रेडिट

क्या एक एजेंट साइनअप से पहले FlashData का प्रयास कर सकता है?

हाँ, CLI के माध्यम से या API को ऑनबोर्ड करने योग्य अस्थायी पहुंच के साथ। उसी प्रोफ़ाइल और पंजीकरण प्रमाण का पुन: उपयोग करें। पढ़ना जारी रखें उपयोग की जरूरत का दावा या मौजूदा मालिक API कुंजी।

क्या दावा किया जाता है कि किसी अन्य परीक्षण अनुदान को जोड़ना है?

खुद को दावा करने से कोई अतिरिक्त परीक्षण क्रेडिट नहीं होता है। फ्यूचर अनुरोध मालिक के अकाउंट बैलेंस का उपयोग करते हैं; अप्रयुक्त अस्थायी क्रेडिट ट्रांसफर नहीं करते हैं। एक नया बनाया गया खाता सामान्य साइनअप-क्रेडिट नीति का पालन करता है।

कितने अनुरोध मेरे क्रेडिट कवर कर सकते हैं?

खाता शेष और स्रोत मूल्य निर्धारण की जाँच करें। अनुरोध गिनती स्रोत पर निर्भर करती है, और मिश्रित स्रोत कार्य एक संतुलन साझा करते हैं। YouTube Download को डाउनलोड बाइट्स द्वारा मूल्यांकित किया जाता है, एक निश्चित अनुरोध गिनती नहीं है।

स्रोत और परिणाम

क्यों मेरी एजेंट खोज कर सकते हैं लेकिन डाउनलोड नहीं कर सकते?

मालिक का उपयोग, youtube_download अनुमति और गंतव्य भंडारण की आवश्यकता है। अस्थायी परीक्षण और mcp:research OAuth में डाउनलोड शामिल नहीं है। एक अधिकृत मालिक API कुंजी इसका उपयोग CLI, HTTP या MCP के माध्यम से कर सकती है।

क्या Google Search पूरे वेबपृष्ठों को वापस लौटाता है?

यह खोज परिणाम और छूट देता है। आपका ऐप या एजेंट चयनित URLs को पढ़ता है।

क्या FlashData वीडियो सारांश या कैप्शन उत्पन्न करता है?

यह मेटाडाटा और मौजूदा कैप्शन को पुनर्प्राप्त करता है। यह लापता कैप्शन उत्पन्न नहीं करता है; आपका मॉडल उपलब्ध परिणामों से सारांश लिखता है।

फिर भी अटक गया? न्यूनतम रिपोर्ट भेजें

HTTP त्रुटि शरीर या CLI JSON त्रुटि को stderr से diagnostic.json के रूप में सहेजें। केवल एक असफल कमांड के बाद पहचानकर्ता निकालें। कुंजी, निजी क्वेरी टेक्स्ट रखें और रिपोर्ट से बाहर URLs पर हस्ताक्षर किए। गैर-JSON प्रतिक्रियाओं के लिए, HTTP स्थिति को diagnostic-status.txt से रिपोर्ट करें।

एक मुफ्त CLI एक्सेस चेक कैप्चर करें Bash
flashdata auth status --json 2> diagnostic.json
त्रुटि पहचानकर्ता Bash / jq
# A saved HTTP error or CLI --json error; local files only.
date -u '+%Y-%m-%dT%H:%M:%SZ'
jq '(.error // .) as $e | {
  status: ($e.httpStatus // $e.status),
  code: $e.code,
  requestId: $e.requestId,
  runId: (.runId // $e.runId),
  jobId: $e.remoteId,
  retryAfter: $e.retryAfter
} | with_entries(select(.value != null))' diagnostic.json
समर्थन रिपोर्ट
UTC समय:
क्लाइंट + संस्करण:
स्रोत + मंच (auth / प्रस्तुत / मतदान / प्रदत्त):
HTTP स्थिति + त्रुटि कोड:
ID / नौकरी ID / ID चलाने का अनुरोध करें:
प्रस्तुतीकरण परिणाम: स्वीकार / अस्वीकार / अज्ञात
वास्तविक परिणाम बनाम उम्मीद:
Markdown