Chuyển đến nội dung
VI
Lấy khóa API
Duyệt tài liệu

Bắt đầu

Dùng thử tác nhân và liên kết tài khoản

Thử một Google Tìm kiếm trước khi đăng nhập, sau đó kết nối tài khoản chủ để tiếp tục sử dụng cùng một tài khoản. CLI Hồ sơ.

Trên trang này

1. Kiểm tra truy cập đã có

Kiểm tra miễn phí trong môi trường của người đại diện. Nếu data.accessVerified là true và Google Search được phép, tái sử dụng truy cập đó và nhảy qua bước 3. Không lưu hồ sơ, hãy tiếp tục bước 2. Tiếp tục truy cập bị chặn hoặc chờ đợi sử dụng phần phục hồi bên dưới.

Chọn hồ sơ này
flashdata auth status --json --non-interactive

Giữ cùng hồ sơ

Đang làm việc với báo cáo truy cập data.accessVerified: true, access: ready in data.identity.identity, và google_search in data.identity.permittedSources.

Những lệnh này dùng hồ sơ và việc làm mặc định Bash hay PowerShell. Đối với một hồ sơ đã có hoặc thư mục tình trạng tùy chọn, phụ thêm cùng một --profile NAME và --state-dir ABSOLUTE_PATH tất cả các chỉ huy, bao gồm cả những người trong một trạm cuối mới.

FLASHDATA_API_KEY được ưu tiên hơn khóa đã lưu. Không đặt biến này khi kiểm tra bản dùng thử và việc bàn giao thông tin xác thực của hồ sơ này. Dùng cùng một người dùng OS và giữ thư mục trạng thái riêng tư; thư mục này chứa thông tin xác thực, bằng chứng đăng ký và lịch sử chạy.

Kiểm tra credentialProtection trong auth status. Windows sử dụng DPAPI, macOS sử dụng Keychain, và không đầu Linux có thể sử dụng tập tin nhận diện người sở hữu duy nhất. Có sẵn OS cửa hàng có thể cần thiết với --credential-store Os.

Dùng phím sở hữu tồn tại thay vào đó

Một người ở trạm cuối có thể nhập một chìa khóa qua dấu nhắc ẩn bên dưới và bỏ qua giấy đăng ký phiên tòa và tuyên bố như vậy. Các tác nhân nên cung cấp cho nó stdin có --api-key-stdin --non-interactive không bao giờ đặt chìa khóa trong các cuộc tham số hoặc trò chuyện.

Nếu hồ sơ đã có quyền truy cập khác, hãy xem lại nó trước khi dùng. auth login --replace. Nhập một chìa khóa khác không phải là việc lấy tay ra. MCP OAuth cũng là một kết nối chủ thể khác nhau.

Phím ẩn nhắc máy · con người cuối
flashdata auth login
flashdata auth status --json --non-interactive

2. Bắt đầu một thử nghiệm đủ điều kiện

Chạy discover trước. Kiểm tra data.onboardingAvailable và tiền trợ cấp ở data.onboarding.trial. Nếu có thể lên tàu, chạy đi. init Một lần cho Google Search. Máy chủ kiểm tra khả năng cao; CLI tiết kiệm khóa tạm thời mà không mở đăng nhập hoặc gửi một truy vấn.

Kiểm tra tính sẵn sàng . miễn phí
flashdata discover --json --non-interactive
Chạy truy cập tạm thời
flashdata init --name "Research assistant" --scopes google_search --json --non-interactive

Kiểm tra biên lai đăng ký

Mong đợi ok: true, data.status: trial và google_search in data.connection.scopes. Đọc data.connection.trialExpiresAt và data.startingAllowanceCredits. Chìa khóa được lưu tại địa phương, chứ không phải in ra. Nếu data.currentBalanceAvailable là falseKiểm tra lại số dư miễn phí trước khi truy vấn.

Nếu thiết lập đã tạo truy cập, hãy sử dụng lại nó. Để dán nhãn đăng ký đầu tiên của một tác nhân, thêm --client codex --audience coding hay --client openclaw --audience personal. Giữ lại kết nhập chính xác trên lần thử lại; chú thích không cho phép.

Quyền hạn và giới hạn thử thách

Yêu cầu tương đương với việc chia sẻ sự số dư tín dụng; chúng không còn là những yêu cầu hay chỉ tiêu độc lập. Chỉ có nguồn như YouTube Download không thể dùng các khoản tiền thử nghiệm.

Giới hạnKiểm tra cái gì?
Nguồn tư liệu / tiền bạcMặc định hiện thời: 1 Được công nhận 72 giờ. Đọc những phát hiện về việc cấp vốn và sự sống; biên lai cung cấp những nguồn tiền và được cấp.
Đăng ký3 Đăng ký trên mỗi IP 24 Hàng giờ, được chia sẻ bởi người dùng IP đó. Hệ thống thử nghiệm toàn cầu cũng có thể tạm dừng việc đăng ký lại.
Sự khẩn cấpHãy tiếp tục thử nghiệm làm việc theo nghĩa đen: mỗi mẻ một món và một món đồ đang chờ. Kiểm tra lại giới hạn trước khi gửi thêm.

3. Thử tìm kiếm

Xem thử trước. Cần thiết data.estimateAvailable, có sẵn google_search Giá vào data.estimate.prices, và availableCredits bao gồm estimatedCredits. Dừng lại nếu kiểm tra thất bại. Xem thử là miễn phí; lệnh kế tiếp đệ trình tìm kiếm.

Kiểm tra số dư và chi phí : không truy vấn
flashdata account balance --json --non-interactive
flashdata search "battery recycling" --num 5 --dry-run --json --non-interactive
Một kết quả tìm kiếm # lên đến năm
flashdata search "battery recycling" --num 5 --run-id trial-search --json --non-interactive

Kiểm tra kết quả

Mong đợi ok: true và data.status: done. Đọc tựa đề, liên kết và trích đoạn từ data.results[].organicvà tính tiền từ data.usage.credits. Kết quả hữu cơ rỗng là hợp lệ. Trước khi tuyên bố, lặp lại nhiệm vụ này với trial-search trả lại kết quả đã được cứu. Giữ hồ sơ và tình trạng, và giữ lại bất kỳ kết quả thử nghiệm nào bạn cần.

Kiểm tra phần số dư còn lại . giải phóng
flashdata account balance --json --non-interactive

4. Giữ truy cập với tài khoản chủ

Xác nhận trước khi phiên tòa kết thúc nếu bạn muốn tiếp tục hoặc sử dụng lại. Khi nào sẵn sàng, hãy chạy trong hồ sơ gốc. Chỉ chia sẻ data.claimUrl và data.confirmationCode với họ; data.expiresAt đưa ra hạn chót.

Liên kết cuối cùng 15 phút, hoặc cho đến khi phiên tòa kết thúc sớm hơn. Tạo liên kết không chấp nhận truy cập hay mua tín dụng.

Tạo liên kết xác nhận khi người sở hữu đã sẵn sàng
flashdata auth claim --json --non-interactive

Áp dụng trong trình duyệt

  1. Chủ sở hữu mở liên kết và ký hiệu vào, hoặc tạo một tài khoản mới và kiểm tra email. Một bản đăng ký mới sẽ tiếp tục yêu cầu sau khi xác nhận.
  2. Hãy kiểm tra tài khoản được liệt kê nơi trang sở hữu. Đối với một người sở hữu khác hoặc mới, hãy dùng một phiên chạy duyệt riêng. Tài khoản đã ký là tài khoản sẽ chi trả cho yêu cầu sau này.
  3. Hãy nhập mã 8 chữ số trên trang đó, xem lại quyền truy cập sản phẩm và sự số dư về quyền truy cập, sau đó phê chuẩn. Chủ sở hữu xử lý đăng ký, chấp nhận hợp pháp, xác nhận email và chấp thuận.

Kết thúc trong thiết bị cuối gốc

Sau khi đồng ý, chạy đi. finish trong hồ sơ gốc bên trong 24 giờ. Hạt CLI lưu lại chìa khóa của người sở hữu, xác nhận nó trong một quá trình mới và xác nhận cài đặt. Không có phím nào được sao chép từ trình duyệt.

Lưu và xác nhận quyền truy cập chủ sở hữu
flashdata auth finish --wait --timeout 10m --json --non-interactive
Sau đó kiểm tra từ một thiết bị cuối mới e· giống nhau OS người dùng và hồ sơ
flashdata auth status --json --non-interactive
flashdata account balance --json --non-interactive

Xác nhận chủ nhân và sự số dư

Vào auth statusĐể xác minh mục đích của nó accountId và cho phép phạm vi, cộng với các lĩnh vực bên dưới. Hãy đọc một cách riêng biệt sự số dư mới; những yêu cầu trong tương lai sử dụng tín dụng chung của chủ sở hữu. Tín dụng tạm thời không được chuyển. Một tài khoản mới theo sau khả năng đăng ký bình thường; khẳng định không thêm tiền trợ cấp.

Xác nhận đã thay đổi tài khoản. Để có một tác vụ mới dưới quyền người sở hữu, hãy chọn một bộ điều hành ID mới. Sử dụng lại một thử nghiệm chạy ID trở lại run_account_mismatch Không gửi một yêu cầu khác; nó không truyền quyền đó cho người sở hữu.

Mong đợi các trường để đáp ứng trích
{
  "ok": true,
  "data": {
    "accessVerified": true,
    "identity": {
      "identity": {
        "accountType": "owned",
        "access": "ready",
        "installed": true,
        "recurringAllowed": true
      }
    }
  }
}

Chọn quyền hạn cho sản phẩm

Danh mục quyền HTTP phân biệt trialEligible với ownerAllowed. Trước lần đăng ký đầu tiên, chỉ yêu cầu các nguồn cần thiết cho tác vụ. requestedScopes chứa các quyền được yêu cầu; scopes cho biết quyền truy cập hiện tại của khóa. Sản phẩm mới cần được cấp quyền rõ ràng.

Việc phê duyệt cho phép sử dụng số dư chung của chủ tài khoản, gồm cả tín dụng đã mua. Giới hạn nguồn không tạo ra hạn mức chi tiêu cho từng tác nhân. MCP OAuth là kết nối riêng và không liên kết hồ sơ CLI này với tài khoản.

Chỉ cần YouTube Download?

Dùng phím & riêng youtube_download cho phép, nhập nó, rồi cấu hình kho đích. Tải về không dùng công trạng thử tạm thời.

CLI 1.2.1 Vẫn cần một nguồn tin có thể thử nghiệm cho init. Để tải về chỉ trước khi đăng nhập, sử dụng HTTP xác nhận chảy vào auth.md. Không thêm một nguồn thử nghiệm không liên quan chỉ để vượt qua hạn chế khách hàng đó.

Tiếp tục lưu thông

Cái gì dừng lại?Hành động tiếp theo
Đăng kýĐối với 429, hãy đợi Retry-After. Để đáp ứng bị mất, hãy thử lại init với cùng hồ sơ, bằng chứng và đầu vào chính xác. Giữ trạng thái đã có; không chuyển đổi IP hoặc bắt đầu một thử nghiệm thay thế.
Tìm kiếmKiểm tra trial-search bên dưới. Thời hạn không chứng minh rằng không có việc làm nào được chấp nhận; đừng thay đổi cuộc chạy đua ID để ép buộc một thử lại.
& Xác nhận liên kếtNếu liên kết đã hết hạn nhưng thử nghiệm là hợp lệ, hãy tạo một liên kết mới trong cùng hồ sơ khi người sở hữu sẵn sàng. Kiểm tra chủ nhân đăng ký trước khi được chấp thuận.
Bỏ tay raSau khi đồng ý, hãy chạy lại. auth finish trong hồ sơ gốc bên trong 24 giờ. Việc chờ đợi sự chấp thuận, việc chờ đợi bị ngắt quãng hoặc việc công nhận bị mất không đòi hỏi phải đăng ký lại.
Bị hạn chế / mất trạng tháiĐối với một thử nghiệm hoặc ra tay hết hạn, hoặc một thư mục quốc gia bị mất, sử dụng chủ quyền tái kết nối hoặc nhập một phím sở hữu.
Xem xét lại việc tìm kiếm đã lưu và không có yêu cầu mới
flashdata runs show trial-search --json --non-interactive