Перейти до вмісту
UK
Отримати ключ API
Переглянути документацію

Початок роботи

Пробний доступ агента й прив’язування облікового запису

Спробуйте пошук 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 має пріоритет над збереженим ключем. Не задавайте цю змінну під час перевірки пробного доступу й передавання облікових даних цього профілю. Використовуйте того самого користувача ОС і зберігайте приватний каталог стану: він містить облікові дані, доказ реєстрації та історію запусків.

Огляд credentialProtection в auth status. Windows використовує DPAPI, macOS використовує Keychain, а безголовний Linux може використовуватися для користувача постійний достовірний файл. У магазині OS можна скористатися --credential-store.

Використовуйте наявний ключ власника замість

Людина в терміналі може імпортувати ключ через приховану підказку нижче і пропустити реєстрацію і претензії. Агенти повинні поставляти його на stdin з --api-key-stdin --non-interactive з їх секретного магазину; ніколи не кладуть ключ в аргументи або чат.

Якщо профіль вже має різний доступ, перевірте його перед використанням auth login --replace. Імпорт іншого ключа не є позовом. MCP OAuth також є окремим з'єднанням хостів.

Прихована ключова підказка · людський термінал
flashdata auth login
flashdata auth status --json --non-interactive

2. Почати право на право

Запуск discover першим. Перевірте data.onboardingAvailable і припуск в data.onboarding.trial. Якщо на борту є можливість запустити init один раз для Google Search. Сервер перевіряє відповідальність; CLI зберігає тимчасовий ключ без реєстрації або подання запиту.

Перевірити наявність · безкоштовно
flashdata discover --json --non-interactive
Почати тимчасовий доступ
flashdata 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. Забезпечити точний вхід на птицю; етикетки не надають дозволу.

Тривалий припуск і ліміти

Запит еквівалентів, які постачають один і той самий початковий кредитний баланс; вони не залишилися запитами або незалежними квотами. Власник-тільки джерела, такі як YouTube Download не може витрачати тестові кредити.

ЛімітЩо потрібно перевірити
Кредит / витривалістьПоточні за замовчуванням: 1 кредит за 72 години. Читання відкриття для надання гранту та терміну служби; отримання дає можливість викупу та надані джерела.
Реєстрація3 реєстрації на IP за 24 години; ліміт спільний для користувачів цієї IP-адреси. Глобальний ліміт пробних доступів також може призупинити нові реєстрації.
КонваптаціяЗберігайте послідовну роботу: один елемент за партію і одну роботу. Перевірити подані ліміти перед поданням більше.

3. Спробуйте один пошук

Перший перегляд. data.estimateAvailable, доступна ціна google_search в data.estimate.prices, і availableCredits покриття estimatedCredits. Стоп, якщо перевірте невдачу. Відправка на попередній перегляд безкоштовно, наступна команда подає один пошук.

Перевірити баланс і вартість · немає запиту
flashdata account balance --json --non-interactive
flashdata search "battery recycling" --num 5 --dry-run --json --non-interactive
Один пошук · до 5 результатів
flashdata 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-interactive

4. Зберігайте доступ до облікового запису власника

Якщо ви хочете продовжити або повторне використання. Коли власник готовий, запустіть його в оригінальний профіль. Поділитися тільки data.claimUrl і data.confirmationCode з ними; data.expiresAt дає термін дії.

Посилання триває хвилин 15, або доки не закінчиться процес. Створення посилання не затверджує доступ або купівлю кредитів.

Створіть посилання на вимогу, коли власник готовий
flashdata auth claim --json --non-interactive

Затвердження в браузері

  1. Власник відкриває посилання та підписи, або створює новий обліковий запис та перевіряє електронну пошту. Новий реєстр відновлює позов після перевірки.
  2. Перевірити рахунок, що відображається на сторінці претензії. Для іншого або нового власника використовуйте окрему браузерну сесію. У зареєстрованому рахунку є рахунок, який сплачує за пізніше запитів.
  3. Введіть вісім-цифровий код на цій сторінці, перевірте дозвіл на продукт і доступ до спільного доступу, потім затвердження. Власник здійснює реєстрацію, юридичне прийняття, перевірка електронної пошти та згоду.

Оздоблення в оригінальному терміналі

Після затвердження запустіть finish в оригінальному профілі в межах 24 годин. CLI зберігає ключ власника, виправляє його в свіжий процес і визнає установку. Немає ключа, що скопіюється з браузера.

Заощаджуйте та перевірте доступ власника
flashdata auth finish --wait --timeout 10m --json --non-interactive
Потім перевірте зі свіжого терміналу · той же користувач OS і профіль
flashdata 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, а потім налаштуйте цільове сховище. Download не використовує тимчасові пробні кредити.

CLI 1.2.1 все ще вимагає тестового джерела для init. Для завантаження на борту перед вивіскою використовуйте HTTP претензійний потік у auth.md. Не додавати необґрунтоване джерело даних, щоб обійти обмеження клієнтів.

Сприяти припинному потоку

Що припинилиПопередня дія
ЗареєструватисяДля 429 чекатиме Retry-After. Для втраченого відгуку, птиця init з тим же профільом, доказом і точним входом. Не переключайте IP-адресу або запустіть тестову заміну.
ПошукОгляд trial-search нижче. Час роботи не доводить, що не було прийнято, не змінюючи пробіг ID, щоб змусити птицю.
Клайм посиланняЯкщо посилання прострочене, але пробний доступ ще діє, створіть нове посилання в тому самому профілі, коли власник буде готовий. Перед схваленням перевірте обліковий запис, у якому відкрито сеанс.
ЗручностіПісля затвердження, перезапуск auth finish в оригінальному профілі в межах 24 годин. Попереднє затвердження, переривається очікування або визнання не вимагає нової реєстрації.
Очікуваний / втрачений станЯкщо пробний доступ чи передача ключа прострочені або приватний каталог стану втрачено, підключіться повторно зі схвалення власника або імпортуйте його ключ.
Ознайомтеся з збереженими пошуками · немає нового запиту
flashdata runs show trial-search --json --non-interactive