Перейти к содержимому
RU
Ключ 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 и --state-dir ABSOLUTE_PATH к каждой команде, включая те, которые находятся в новом терминале.

FLASHDATA_API_KEY имеет приоритет над сохранённым ключом. Не задавайте эту переменную при проверке пробного доступа и передачи учётных данных для этого профиля. Используйте того же пользователя ОС и сохраняйте приватный каталог состояния: он содержит учётные данные, доказательство регистрации и историю запусков.

Проверьте credentialProtection в auth status. Windows использует DPAPI, macOS использует Keychain, а безголовый Linux может использовать файл учетных данных только для владельца. Доступный магазин OS может потребоваться с --credential-store os.

Вместо этого используйте ключ владельца

Человек в терминале может импортировать ключ через скрытую подсказку ниже и пропустить регистрацию проб и претензии. Агенты должны поставлять его на 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
Один поиск - до пяти результатов
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