跳转到正文
中文
获取 API 密钥
浏览文档

开始使用

快速入门

使用 FlashData 完成首次 Google 搜索,为应用或 AI 智能体获取结构化结果。

通过 AI 智能体开始

将提示交给可使用终端的智能体,完成 FlashData 配置并执行一次搜索。

发送首次 API 请求

想直接编写代码?在终端按以下三步操作。

  1. 获取 API Key

    创建账户并验证邮箱,然后创建具有 Google 搜索权限的 API Key。已有密钥可直接使用。

    在终端运行以下命令,在隐藏输入提示中粘贴密钥。已设置 FLASHDATA_API_KEY 时可跳过。

    设置密钥
    # Bash: paste the key into a hidden prompt, not into this command.
    read -r -s -p "FlashData API key: " FLASHDATA_API_KEY
    printf '\n'
    export FLASHDATA_API_KEY
  2. 执行搜索

    选择语言,在同一终端运行示例。每次运行发送一次搜索请求。

    Python 3.10+ · 将示例保存为 quickstart.py。

    安装
    python -m pip install "flashdata==1.1.0"
    quickstart.py
    import json
    import os
    from flashdata import FlashData
    
    with FlashData(api_key=os.environ["FLASHDATA_API_KEY"]) as client:
        response = client.google.search("battery recycling research", num=5)
        if response["status"] != "done":
            raise RuntimeError(response)
        print(json.dumps(response, indent=2))
    运行
    python quickstart.py
  3. 查看结果

    成功响应的 status 为 done。在 results[].organic 中查看来源,在 usage.credits 中查看本次扣费。

    响应示例(精简)
    {
      "status": "done",
      "results": [
        {
          "organic": [
            {
              "title": "Battery recycling research",
              "link": "https://example.org/recycling",
              "snippet": "An example search excerpt."
            }
          ]
        }
      ],
      "usage": {
        "credits": 0.02
      }
    }

在控制台试用

  1. 创建账户或登录,完成邮箱验证以及控制台提示的账户设置。
  2. 打开 Google 搜索,选择 Google 搜索来源和实时模式,输入 battery recycling research。展开更多参数,将每页数量(num)设为 5。
  3. 检查显示的请求与可用 Credits,再执行一次搜索。
  4. 检查响应及用量。引用超出摘要的信息前,打开返回来源核对内容。

继续使用首次结果

首次请求失败时

缺少 FLASHDATA_API_KEY
在运行示例的同一终端或运行环境设置密钥;这些代码不会读取 .env 文件。
401 / 403
检查密钥或连接是否有效,并具有 google_search 权限。
402
在 Billing 检查可用 Credits。需要所有者访问时认领现有试用。
429
遵守 Retry-After,保留相同身份及注册凭证,不要创建另一试用。
超时或提交状态不确定
重试前检查现有运行。CLI 用户保留相同配置及运行 ID;SDK/API 用户保留已返回的任务或请求 ID。