コンテンツへスキップ
JA
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 は保存済みのキーより優先されます。このプロファイルの試用と認証情報の引き渡しをテストするときは、この変数を未設定にしてください。同じ OS ユーザーを使い、非公開の状態ディレクトリを保持してください。このディレクトリには認証情報、登録証明、実行履歴が保存されます。

インスペクト credentialProtection でん auth status. WindowsはDPAPI、macOSはKeychainを使用し、ヘッドレスLinuxは所有者専用の認証ファイルを使用するかもしれません。 --credential-store os では、OS ストアをご購入いただけます。

既存のオーナーキーを代わりに使用

ターミナルを操作する人は、下の非表示入力プロンプトからキーを取り込み、試用登録とアカウント連携を省略できます。エージェントは秘密情報ストアから --api-key-stdin --non-interactive を使って stdin にキーを渡してください。引数やチャットにキーを含めないでください。

プロフィールが既に異なるアクセスを保持している場合は、auth login --replaceを使用する前にそれを見直してください。 別のキーをインポートすることは、クレームハンドオフではありません。 MCP OAuthは別のホスト関係です。

隠しキーのプロンプト・ヒューマンターミナル
flashdata auth login
flashdata auth status --json --non-interactive

2. 1つの資格試験を開始

最初に discover を実行し、data.onboardingAvailable と data.onboarding.trial の利用枠を確認します。オンボーディングが利用可能なら、Google Search 用に init を 1 回実行します。サーバーが利用資格を確認し、CLI が一時キーを保存します。サインアップ画面は開かず、クエリも送信しません。

空室状況の確認・無料
flashdata discover --json --non-interactive
一時的なアクセスを開始する
flashdata init --name "Research assistant" --scopes google_search --json --non-interactive

参加登録の領収書の確認

ok: true、data.status: trial、および data.connection.scopes に google_search が含まれることを確認します。data.connection.trialExpiresAt と data.startingAllowanceCredits を読み取ってください。キーは表示されず、ローカルに保存されます。data.currentBalanceAvailable が false の場合は、クエリを送る前に無料の残高確認を再実行します。

セットアップでアクセスが作成済みなら再利用します。初回登録にエージェントの情報を付けるには、--client codex --audience coding または --client openclaw --audience personal を指定します。再試行時は入力を完全に同じにしてください。このラベルによって権限が付与されることはありません。

試用手当と制限

リクエスト換算値は同じ開始時クレジット残高を使った目安です。残りリクエスト数でも、独立した利用枠でもありません。YouTube Download など所有者専用のソースでは、試用クレジットを使えません。

制限なし確認するべきこと
クレジット / 有効期限現在のデフォルト: 72 時間の 1 クレジット。 助成金と生涯の発見を読みます。 領収書は、有効期限と付与された情報源を与えます。
参加申し込み同一 IP につき 24 時間で 3 件まで登録できます。同じ IP を使うユーザー間で共有される上限です。試用の全体上限により新規登録が一時停止される場合もあります。
コンポレーション試用中は順番に処理してください。バッチは 1 件、未完了ジョブは 1 件までです。追加送信の前に、返された制限値を確認します。

3. 1つの検索を試す

まずプレビューを実行します。data.estimateAvailable が有効で、data.estimate.prices に利用可能な google_search 料金があり、availableCredits が estimatedCredits 以上であることを確認してください。確認に失敗したら停止します。プレビューは無料ですが、次のコマンドは検索を 1 回送信します。

残高と費用の確認・問い合わせなし
flashdata account balance --json --non-interactive
flashdata search "battery recycling" --num 5 --dry-run --json --non-interactive
1件の検索・最大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 にあります。organic が空でも有効な結果です。アカウント連携前に同じタスクを 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. そのページにある8桁のコードを入力し、製品の許可と共有バランスアクセスを見直し、承認します。 所有者は、サインアップ、法的受諾、電子メールの検証、同意を処理します。

元のターミナルで終わり

承認後、24時間内のオリジナルプロファイルでfinishを実行します。 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、付与済みの scopes、以下の項目を確認します。最新の残高は別途確認してください。以後のリクエストは所有者の共有クレジットを消費します。未使用の一時クレジットは移行されません。新しいアカウントには通常の登録条件が適用され、連携による追加の登録特典はありません。

アカウント連携により課金先が変わります。所有者のアカウントで新しいタスクを実行するときは、新しい実行 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 には、まだ試用対象ソースが必要です。登録前に Download だけを利用する場合は、auth.md の HTTP 連携フローを使ってください。クライアントの制限を回避するために、無関係な試用ソースを追加しないでください。

停止フローを再開

何が止まったのか次のアクション
会員登録429 の場合は Retry-After に従って待機します。レスポンスを受信できなかった場合は、同じプロファイル、登録証明、完全に同じ入力で init を再試行します。既存の状態を保持し、IP を変えたり代わりの試用を作ったりしないでください。
検索下の trial-search を確認します。タイムアウトだけでは、処理が受け付けられなかったとは判断できません。再試行を強制するために実行 ID を変更しないでください。
クレームリンクリンクの期限が切れていても試用が有効なら、所有者の準備ができた時点で同じプロファイルから新しいリンクを作成します。承認前に、ログイン中の所有者が正しいか確認してください。
ハンドオフ承認後、24時間以内に元のプロフィールでauth finishを再実行して下さい。 承認の終了、中断された待ち時間、または失った承認は、新規登録を必要としません。
期限切れ/失われた状態試用や認証情報の受け渡し期限が切れた場合、または非公開の状態ディレクトリを失った場合は、所有者の承認を得て再接続するか、所有者キーを取り込みます。
保存した検索を調べる · 新規クエリなし
flashdata runs show trial-search --json --non-interactive