दस्तावेज़ देखें
शुरू करें
अपनी पहुंच की जाँच करें, असफल अनुरोध को ठीक करें या FlashData का उपयोग करने के बारे में उत्तर ढूंढें।
इस पेज पर
एक मुफ्त एक्सेस चेक के साथ शुरू करें
जाँच करें जहां कार्य विफल रहा। अपने मौजूदा क्रेडेंशियल का उपयोग करें; इन कमांडों ने एक क्वेरी प्रस्तुत नहीं की है।
अपने बचाया CLI पहुँच का प्रयोग करें। एक नामित प्रोफ़ाइल के लिए, प्रत्येक कमांड के लिए --profile NAME को संलग्न करें। ये पढ़े गए प्रश्न क्रेडिट खर्च नहीं करते हैं।
flashdata --version
flashdata doctor --offline
flashdata auth status --jsonउसी टर्मिनल, कंटेनर या अनुसूचित नौकरी में कार्य के मौजूदा FLASHDATA_API_KEY का उपयोग करें। cURL 7.76+ की आवश्यकता है।
(
: "${FLASHDATA_API_KEY:?Set FLASHDATA_API_KEY first}"
curl --fail-with-body --silent --show-error --max-time 20 \
--header "X-API-Key: $FLASHDATA_API_KEY" \
'https://api.flashdata.dev/v2/api-access/identity' || exit
printf '\n'
)उसी टर्मिनल, कंटेनर या अनुसूचित नौकरी में कार्य के मौजूदा FLASHDATA_API_KEY का उपयोग करें।
& {
$ErrorActionPreference = 'Stop'
if ([string]::IsNullOrWhiteSpace($env:FLASHDATA_API_KEY)) {
throw 'Set FLASHDATA_API_KEY first'
}
$flashdataHeaders = @{ 'X-API-Key' = $env:FLASHDATA_API_KEY }
$flashdataBase = 'https://api.flashdata.dev/v2'
$flashdataUri = "$flashdataBase/api-access/identity"
Invoke-RestMethod -Uri $flashdataUri `
-Headers $flashdataHeaders -TimeoutSec 20 -MaximumRedirection 0 |
ConvertTo-Json -Depth 20
}क्या जांचें
पहचान में 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 --offlineGet-Command flashdata
flashdata --version
flashdata doctor --offline401 / 403: कुंजी, गुंजाइश या समाप्ति
एक बचाया मालिक कुंजी को बदलने के लिए, अनुमोदित कुंजी को छिपे हुए प्रॉम्प्ट में पेस्ट करें। यदि FLASHDATA_API_KEY सेट किया गया है, तो उस समय के बजाय उस रहस्य को अद्यतन करें; एक अन्य CLI कुंजी को सहेजना इसे ओवरराइड नहीं करेगा।
- 401: एक समाप्त, रद्द या गलत तरीके से कॉन्फ़िगर कुंजी के लिए जाँच करें। 403: पहचान के दायरे के साथ अनुरोधित स्रोत की तुलना करें।
- 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मौजूदा परीक्षणों के लिए एक ताजा लिंक का अनुरोध करें, मालिक को मंजूरी दे दें, फिर auth finish चलाएं। फिर से init नहीं चलाएं।
flashdata auth claim402: अपर्याप्त क्रेडिट
अपने स्रोत के लिए वर्तमान मूल्य के साथ availableCredits की तुलना करें। मालिक के संतुलन का उपयोग करने के लिए एक थकावट परीक्षण का दावा करें, या मालिक को पुनः प्रयास करने से पहले Billing की समीक्षा करने दें।
अपने बचाया CLI पहुँच का प्रयोग करें। एक नामित प्रोफ़ाइल के लिए, प्रत्येक कमांड के लिए --profile NAME को संलग्न करें। ये पढ़े गए प्रश्न क्रेडिट खर्च नहीं करते हैं।
flashdata account balance
flashdata account pricing --source google_search --request-count 1उसी टर्मिनल, कंटेनर या अनुसूचित नौकरी में कार्य के मौजूदा FLASHDATA_API_KEY का उपयोग करें। cURL 7.76+ की आवश्यकता है।
(
: "${FLASHDATA_API_KEY:?Set FLASHDATA_API_KEY first}"
curl --fail-with-body --silent --show-error --max-time 20 \
--header "X-API-Key: $FLASHDATA_API_KEY" \
'https://api.flashdata.dev/v2/api-access/balance' || exit
printf '\n'
curl --fail-with-body --silent --show-error --max-time 20 \
--header "X-API-Key: $FLASHDATA_API_KEY" \
'https://api.flashdata.dev/v2/api-access/pricing?source=google_search&request_count=1' || exit
printf '\n'
)उसी टर्मिनल, कंटेनर या अनुसूचित नौकरी में कार्य के मौजूदा FLASHDATA_API_KEY का उपयोग करें।
& {
$ErrorActionPreference = 'Stop'
if ([string]::IsNullOrWhiteSpace($env:FLASHDATA_API_KEY)) {
throw 'Set FLASHDATA_API_KEY first'
}
$flashdataHeaders = @{ 'X-API-Key' = $env:FLASHDATA_API_KEY }
$flashdataBase = 'https://api.flashdata.dev/v2'
$flashdataUri = "$flashdataBase/api-access/balance"
Invoke-RestMethod -Uri $flashdataUri `
-Headers $flashdataHeaders -TimeoutSec 20 -MaximumRedirection 0 |
ConvertTo-Json -Depth 20
$flashdataUri = "$flashdataBase/api-access/pricing?source=google_search&request_count=1"
Invoke-RestMethod -Uri $flashdataUri `
-Headers $flashdataHeaders -TimeoutSec 20 -MaximumRedirection 0 |
ConvertTo-Json -Depth 20
}429: पुनः प्रयास करने से पहले प्रतीक्षा करें
Retry-After को विफल प्रतिक्रिया पर पढ़ें: सेकंड या एक HTTP तारीख। तब तक प्रतीक्षा करें और परंपरागतता को कम करें। परीक्षण पंजीकरण प्रति 24-घंटे की खिड़की प्रति IP तीन पंजीकरण की अनुमति देता है; मूल प्रोफ़ाइल और पंजीकरण प्रमाण का पुन: उपयोग करें।
यह मुफ्त पढ़ने से हेडर, स्थिति और शरीर की बचत होती है। कार्य से Retry-After का उपयोग करें जो विफल हो गया; क्वेरी, पंजीकरण और खाता पढ़ने की सीमा अलग हो सकती है।
# 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 limits400 / 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. CLI receipts use remoteId; HTTP receipts use id.
(
set -e
JOB_ID=$(jq -er '.remoteId // .id' submission.json)
flashdata jobs get "$JOB_ID" --json
)flashdata jobs wait JOB_IDflashdata jobs result JOB_ID --output recovered-result.json# Bash + cURL + jq. Read the saved async submission receipt.
(
set -e
test -n "$FLASHDATA_API_KEY" || { printf 'Set FLASHDATA_API_KEY first\n' >&2; exit 1; }
STATUS_URL=$(jq -er '(.submission // .).links[]
| select(.rel == "self") | .href' submission.json)
curl --fail-with-body --silent --show-error --max-time 30 \
--header "X-API-Key: $FLASHDATA_API_KEY" \
--header 'Accept: application/json' \
"$STATUS_URL" --output job.json
jq '.job | {id, status, error}' job.json
)टाइमआउट / 5xx: क्या कार्य स्वीकार किया गया था?
एक POST को पुनः प्राप्त करने से पहले मूल रन और History का निरीक्षण करें। एक निश्चित स्वीकृत नौकरी को पुनर्प्राप्त करें। यदि स्वीकृति अज्ञात है, तो रन ID और संपर्क समर्थन को रखें; IDs को बदलना और दोहराना शुल्क हो सकता है।
flashdata runs show RUN_IDflashdata runs recover RUN_IDCLI output_exists: परिणाम फ़ाइल पहले से ही मौजूद है
CLI, --output फ़ाइलों को ओवरराइट नहीं करता है। मौजूदा फ़ाइल को पढ़ें, या मूल --run-id और अनुरोध को रखते हुए एक नया आउटपुट फ़ाइल नाम चुनें। इस त्रुटि को बायपास करने के लिए एक नया रन ID को आविष्कार न करें।
flashdata runs show RUN_IDखाली खोज, लापता कैप्शन या पठनीय डाउनलोड
ये कमांड केवल स्थानीय परिणाम फ़ाइलों को पढ़ते हैं, नहीं CLI के stdout लिफाफे।
यदि स्थिति की जाती है और जैविक खाली है, तो क्वेरी फिल्टर को ढीला करें। अपने कार्य रिकॉर्ड में खाली परिणाम रखें।
jq '{status, usage, resultCount: (.results | length)}' result.json
jq '(.results[0].organic // []) | length' result.jsonमेटाडाटा भाषा कोड को सूचीबद्ध करता है, नहीं कि कोई ट्रैक मैनुअल या स्वचालित है। एक सूचीबद्ध भाषा चुनें और मैन्युअल के लिए स्वचालित, false के लिए ऑटो explicitly: true सेट करें। किसी भी मिलान ट्रैक का मतलब उस चयन के लिए कोई कैप्शन नहीं है; FlashData एक प्रतिस्थापन उत्पन्न नहीं करता है।
jq '.results[0].transcriptLanguages' metadata.jsonपूरा delivery.json रसीद पढ़ें। अपने गंतव्य-स्टोरेज क्रेडेंशियल के साथ वस्तु को डाउनलोड करें, फिर रसीद के साथ अपने आकार और MD5 की तुलना करें। एक निजी file_url प्रसव के बाद सार्वजनिक नहीं होता है।
jq '.results[0] | {file_url, file_size, md5}' delivery.jsonMCP उपकरण लापता या प्रमाणीकरण समाप्त हो गया
मेजबान की जाँच करें कार्य चल रहा है। एक सूचीबद्ध सर्वर विन्यास की पुष्टि करता है, कोई कार्य कनेक्शन नहीं है। यदि कॉन्फ़िगर किया गया हो तो OAuth कनेक्शन को लॉग इन करने की आवश्यकता होती है, तो अपने लॉगिन कमांड को चलाने और ब्राउज़र अनुमोदन को पूरा करने की आवश्यकता होती है, फिर टूल सूची को ताज़ा करें।
कनेक्शन स्थिति और उपकरण की जांच के लिए Codex CLI में ओपन /mcp। ऐप में, कॉन्फ़िगर किए गए सर्वर की जांच करें और सेटअप परिवर्तनों के बाद एक नया सत्र शुरू करें।
codex mcp listcodex mcp login flashdata --scopes mcp:researchopenclaw mcp doctor flashdata --probeopenclaw mcp login flashdata
openclaw mcp doctor flashdata --probeOAuth लॉगिन एक API-key कनेक्शन की मरम्मत नहीं करता है। मेजबान के पर्यावरण और उसके स्रोत अनुमतियों में कुंजी की जाँच करें। स्थानीय stdio के लिए, MCP पैकेज की Node.js आवश्यकता की जांच करें और अपने पर्यावरण को अद्यतन करने के बाद मेजबान को पुनः आरंभ करें।
node --versionकौशल स्थापित लेकिन एजेंट इसे ढूंढ या इस्तेमाल नहीं कर सकता है
उसी परियोजना की जाँच करें, प्रोफ़ाइल होस्ट करें और स्थान स्थापित करें, फिर एक ताजा एजेंट सत्र शुरू करें। CLI कार्य कौशल को CLI की आवश्यकता होती है; flashdata-mcp को कनेक्टेड MCP सर्वर की आवश्यकता होती है। एक कौशल स्थापित करने से सर्वर को कनेक्ट नहीं किया जाता है या खाता अनुमति प्रदान नहीं की जाती है।
flashdata skills verify --agent codexflashdata skills verify --agent codex --skill flashdata-mcpopenclaw skills list --eligible
openclaw skills checkअक्सर पूछे जाने वाले प्रश्न
कनेक्ट हो रहा है
क्या मुझे एआई एजेंट की आवश्यकता है?
नहीं। 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 से रिपोर्ट करें।
flashdata auth status --json 2> diagnostic.json# 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.jsonUTC समय:
क्लाइंट + संस्करण:
स्रोत + मंच (auth / प्रस्तुत / मतदान / प्रदत्त):
HTTP स्थिति + त्रुटि कोड:
ID / नौकरी ID / ID चलाने का अनुरोध करें:
प्रस्तुतीकरण परिणाम: स्वीकार / अस्वीकार / अज्ञात
वास्तविक परिणाम बनाम उम्मीद: