दस्तावेज़ देखें
शुरू करें
साइनअप से पहले एक Google खोज आज़माएं, फिर उसी CLI प्रोफाइल का उपयोग करने के लिए एक मालिक खाता कनेक्ट करें।
इस पेज पर
1. मौजूदा पहुंच की जाँच करें
अपने एजेंट के पर्यावरण में इस मुफ्त जांच को चलाएं। यदि data.accessVerified true है और Google Search को अनुमति दी जाती है, तो इसका उपयोग करें और 3 को कदम में छोड़ दें। कोई बचाया प्रोफ़ाइल के साथ, 2 कदम जारी रखें। नीचे दिए गए वसूली अनुभाग का उपयोग करके लंबित या अवरुद्ध पहुँच को फिर से शुरू करें।
flashdata auth status --json --non-interactiveउसी प्रोफ़ाइल को रखें
कार्य अभिगम रिपोर्ट data.accessVerified: true, access: ready में data.identity.identity, और google_search में data.identity.permittedSources.
ये कमांड डिफ़ॉल्ट प्रोफ़ाइल का उपयोग करते हैं और Bash या PowerShell में काम करते हैं। एक मौजूदा नामित प्रोफ़ाइल या कस्टम राज्य निर्देशिका के लिए, एक नए टर्मिनल में उन लोगों सहित हर आदेश के लिए एक ही --profile NAME और --state-dir ABSOLUTE_PATH का पालन करें।
FLASHDATA_API_KEY को सहेजी गई कुंजी पर प्राथमिकता मिलती है। इस प्रोफ़ाइल के ट्रायल और क्रेडेंशियल हस्तांतरण की जाँच करते समय यह वेरिएबल सेट न करें। वही OS उपयोगकर्ता इस्तेमाल करें और निजी स्टेट डायरेक्टरी सुरक्षित रखें; इसमें क्रेडेंशियल, पंजीकरण का प्रमाण और रन इतिहास होता है।
auth status में credentialProtection का निरीक्षण करें। Windows DPAPI का उपयोग करता है, macOS Keychain का उपयोग करता है, और हेडलेस Linux एक मालिक-केवल क्रेडेंशियल फ़ाइल का उपयोग कर सकता है। एक उपलब्ध OS स्टोर की आवश्यकता --credential-store os के साथ की जा सकती है।
इसके बजाय मौजूदा मालिक कुंजी का उपयोग करें
टर्मिनल पर एक व्यक्ति नीचे छिपे हुए प्रॉम्प्ट के माध्यम से एक कुंजी आयात कर सकता है और परीक्षण पंजीकरण और दावा कर सकता है। एजेंट को अपने गुप्त स्टोर से --api-key-stdin --non-interactive के साथ stdin पर इसकी आपूर्ति करनी चाहिए; कभी भी तर्क या चैट में कुंजी नहीं डाली।
यदि प्रोफ़ाइल पहले से ही अलग पहुँच रखती है, तो auth login --replace का उपयोग करने से पहले इसकी समीक्षा करें। किसी अन्य कुंजी का आयात करने के लिए दावा हैंडऑफ़ नहीं है। MCP OAuth एक अलग होस्ट कनेक्शन भी है।
flashdata auth login
flashdata auth status --json --non-interactive2. एक योग्य परीक्षण शुरू करें
पहले discover रन करें। data.onboardingAvailable की जाँच करें और data.onboarding.trial में भत्ते की जाँच करें। यदि ऑनबोर्डिंग उपलब्ध है, तो Google Search के लिए एक बार init चलाएं। सर्वर पात्रता की जांच करता है; CLI साइनअप खोलने या क्वेरी जमा करने के बिना अस्थायी कुंजी को बचाता है।
flashdata discover --json --non-interactiveflashdata init --name "Research assistant" --scopes google_search --json --non-interactiveपंजीकरण रसीद की जाँच करें
ok: true, data.status: trial और google_search को data.connection.scopes में एक्सपेक्ट करें। data.connection.trialExpiresAt और data.startingAllowanceCredits पढ़ें। कुंजी स्थानीय रूप से बचाया जाता है, मुद्रित नहीं होता है। यदि data.currentBalanceAvailable false है, तो क्वेरी से पहले मुफ्त बैलेंस चेक को फिर से शुरू करें।
यदि सेटअप पहले से ही पहुँच बना है, तो इसका पुन: उपयोग करें। एक एजेंट के पहले पंजीकरण को लेबल करने के लिए, --client codex --audience coding या --client openclaw --audience personal जोड़ें। एक retry पर सटीक इनपुट बनाए रखने के लिए; लेबल अनुमति प्रदान नहीं करते हैं।
परीक्षण भत्ता और सीमा
अनुरोध समतुल्य उसी प्रारंभिक क्रेडिट शेष को साझा करते हैं; वे अनुरोध या स्वतंत्र कोटा नहीं रह रहे हैं। ऐसे YouTube Download के रूप में केवल अपने सूत्रों का परीक्षण क्रेडिट खर्च नहीं कर सकते हैं।
| सीमा | क्या जांचें |
|---|---|
| ऋण / व्यय | वर्तमान डिफ़ॉल्ट: 1 क्रेडिट 72 घंटे के लिए। अनुदान और जीवनकाल के लिए खोज पढ़ें; रसीद समाप्ति देता है और सूत्रों को प्रदान करता है। |
| पंजीकरण | 3 पंजीकरण प्रति IP प्रति 24 घंटे, उस IP के उपयोगकर्ताओं द्वारा साझा किया गया। वैश्विक परीक्षण कैप भी नए पंजीकरण को रोक सकता है। |
| अभिगमन | परीक्षण कार्य अनुक्रमिक रखें: प्रति बैच एक आइटम और एक लंबित नौकरी। अधिक जमा करने से पहले लौटाई गई सीमाओं की जाँच करें। |
3. एक खोज की कोशिश करो
पहले पूर्वावलोकन करें। data.estimateAvailable, data.estimate.prices में एक उपलब्ध google_search कीमत और availableCredits को कवर करने वाले estimatedCredits को कवर करने की आवश्यकता है। यदि कोई चेक विफल हो जाता है तो रुकें। पूर्वावलोकन मुफ्त है; अगले आदेश एक खोज प्रस्तुत करते हैं।
flashdata account balance --json --non-interactive
flashdata search "battery recycling" --num 5 --dry-run --json --non-interactiveflashdata search "battery recycling" --num 5 --run-id trial-search --json --non-interactiveपरिणाम जाँचें
ok: true और data.status: done का चयन करें। data.results[].organic से शीर्षक, लिंक और स्निपेट्स पढ़ें और data.usage.credits से चार्ज करें। खाली कार्बनिक परिणाम मान्य हैं। दावा करने से पहले, trial-search के साथ इस सटीक कार्य को दोहराने से इसके बचाया परिणाम मिलता है। प्रोफ़ाइल और राज्य रखें, और आपको आवश्यक किसी भी परीक्षण परिणाम को बनाए रखें।
flashdata account balance --json --non-interactive4. मालिक खाते के साथ पहुंच रखें
यदि आप जारी रहना चाहते हैं या फिर आवर्ती उपयोग करना चाहते हैं तो परीक्षण समाप्त होने से पहले दावा करें। जब मालिक तैयार हो जाता है, तो इसे मूल प्रोफाइल में चलाएं। उनके साथ केवल data.claimUrl और data.confirmationCode साझा करें; data.expiresAt समय सीमा निर्धारित करता है।
लिंक 15 मिनट तक रहता है, या जब तक परीक्षण जल्द ही समाप्त हो जाता है। लिंक बनाना एक्सेस या खरीद क्रेडिट को मंजूरी नहीं देता है।
flashdata auth claim --json --non-interactiveब्राउज़र में स्वीकृति
- मालिक लिंक को खोलता है और संकेत देता है, या एक नया खाता बनाता है और ईमेल को सत्यापित करता है। एक नया साइनअप सत्यापन के बाद दावा को फिर से शुरू करता है।
- दावा पृष्ठ पर दिखाए गए खाते की जांच करें। एक अलग या नए मालिक के लिए, एक अलग ब्राउज़र सत्र का उपयोग करें। हस्ताक्षरित खाते वह खाता है जो बाद में अनुरोधों के लिए भुगतान करेगा।
- उस पृष्ठ पर आठ-अंकीय कोड दर्ज करें, उत्पाद अनुमतियों और साझा-संतुलन पहुंच की समीक्षा करें, फिर अनुमोदन करें। मालिक साइनअप, कानूनी स्वीकृति, ईमेल सत्यापन और सहमति संभालता है।
मूल टर्मिनल में समाप्त
अनुमोदन के बाद, finish को 24 घंटों के भीतर मूल प्रोफ़ाइल में चलाएं। CLI मालिक कुंजी को बचाता है, इसे एक ताजा प्रक्रिया में सत्यापित करता है और स्थापना स्वीकार करता है। ब्राउज़र से कोई कुंजी कॉपी नहीं की जाती है।
flashdata auth finish --wait --timeout 10m --json --non-interactiveflashdata auth status --json --non-interactive
flashdata account balance --json --non-interactiveमालिक और संतुलन की पुष्टि करें
auth status में, इच्छित accountId को सत्यापित करें और नीचे दिए गए क्षेत्रों को प्रदान करें। ताजा शेष को अलग से पढ़ें; भविष्य के अनुरोधों ने मालिक के साझा क्रेडिट को खर्च किया। अप्रयुक्त अस्थायी क्रेडिट स्थानांतरण नहीं करते हैं। एक नया खाता सामान्य साइनअप पात्रता का पालन करता है; दावा करने से कोई अतिरिक्त साइनअप अनुदान नहीं मिलता है।
दावा करने से बिल्ड खाता बदल जाता है। मालिक के तहत एक नए कार्य के लिए, एक नया रन ID चुनें। एक परीक्षण रन ID रिटर्न run_account_mismatch का पुन: उपयोग करके एक अन्य क्वेरी प्रस्तुत किए बिना; यह उस मालिक को नहीं स्थानांतरित करता है।
{
"ok": true,
"data": {
"accessVerified": true,
"identity": {
"identity": {
"accountType": "owned",
"access": "ready",
"installed": true,
"recurringAllowed": true
}
}
}
}उत्पाद अनुमतियां चुनें
HTTP अनुमति कैटलॉग में trialEligible और ownerAllowed अलग हैं। पहले पंजीकरण से पहले केवल अपने काम के लिए ज़रूरी स्रोतों की अनुमति माँगें। requestedScopes में माँगी गई अनुमतियाँ होती हैं; scopes कुंजी का मौजूदा एक्सेस बताता है। नए उत्पादों के लिए स्पष्ट अनुमति देना ज़रूरी है।
स्वीकृति मिलने पर मालिक का साझा बैलेंस इस्तेमाल होता है, जिसमें खरीदे गए क्रेडिट भी शामिल हैं। स्रोत सीमित करने से हर एजेंट के लिए खर्च की सीमा तय नहीं होती। MCP OAuth एक अलग कनेक्शन है और यह CLI प्रोफ़ाइल को खाते से लिंक नहीं करता।
केवल YouTube Download की आवश्यकता है?
youtube_download अनुमति के साथ एक मालिक कुंजी का उपयोग करें, इसे आयात करें, फिर गंतव्य भंडारण को कॉन्फ़िगर करें। डाउनलोड अस्थायी परीक्षण क्रेडिट का उपयोग नहीं करता है।
CLI 1.2.1 अभी भी init के लिए एक परीक्षण योग्य स्रोत की आवश्यकता है। साइनअप से पहले डाउनलोड-केवल ऑनबोर्डिंग के लिए, HTTP में दावा प्रवाह का उपयोग करें auth.md. उस ग्राहक प्रतिबंध को दूर करने के लिए एक असंबंधित परीक्षण स्रोत को न जोड़ें।
एक बंद प्रवाह फिर से शुरू
| क्या रुक गया | अगली कार्रवाई |
|---|---|
| रजिस्टर | 429 के लिए, Retry-After के लिए प्रतीक्षा करें। एक खोए हुए प्रतिक्रिया के लिए, उसी प्रोफाइल, प्रूफ और सटीक इनपुट के साथ init को पुनः प्राप्त करें। मौजूदा स्थिति को बनाए रखें; आईपी स्विच न करें या प्रतिस्थापन परीक्षण शुरू करें। |
| खोजें | नीचे trial-search का निरीक्षण करें। एक टाइमआउट साबित नहीं होता कि कोई काम स्वीकार नहीं किया गया था; एक वापसी को मजबूर करने के लिए रन ID को नहीं बदलता है। |
| दावा लिंक | यदि लिंक समाप्त हो गया है लेकिन परीक्षण मान्य है, तो मालिक तैयार होने पर उसी प्रोफाइल में एक नया लिंक बनाएं। अनुमोदन से पहले हस्ताक्षरित मालिक की जाँच करें। |
| हैंडऑफ़ | अनुमोदन के बाद, 24 घंटों के भीतर मूल प्रोफ़ाइल में auth finish को फिर से शुरू किया। लंबित अनुमोदन, एक बाधित प्रतीक्षा या खो जाने वाली स्वीकृति को एक नया पंजीकरण की आवश्यकता नहीं है। |
| Expired / खो राज्य | एक समाप्त परीक्षण या हैंडऑफ़ के लिए, या एक खोया निजी राज्य निर्देशिका के लिए, मालिक को मंजूरी दे दी गई फिर से संयोजन का उपयोग करें या मालिक की कुंजी आयात करें। |
flashdata runs show trial-search --json --non-interactive