# 创建任务

> URL: https://foura.ai/zh/docs/dashboard/creating-a-task
> Updated: 2026-10-28
> Index: https://foura.ai/llms.txt

本指南将指导你创建 API key 并使用 FourA Dashboard 发送你的第一个 request。

## 第 1 步：打开 Dashboard

访问 [Dashboard](https://foura.ai/dashboard) 并登录你的 FourA 账户。

## 第 2 步：创建 API Key

进入 **API Keys** 页面并点击 **Create API key**。拥有 key 之后，列表上方的按钮会显示为 **Create Key**。

为该 key 输入一个描述性名称（例如 "production-scraper" 或 "dev-testing"）。**API Key Created** 对话框会显示明文 key 及复制按钮，并在 **Test your first request** 下方提供带 **Copy command** 的即用型 curl 命令。在手机或平板电脑上，**Try it in the Playground** 则会带你跳转至相应演练场。

如果不慎关闭，稍后点击该 key 所在行的眼睛图标可再次查看。在显示功能上线前创建的旧版 key 无法再次查看；重新生成一次即可切换。完整流程参见：[Managing API Keys](https://foura.ai/docs/dashboard/api-keys)。

你的 key 样式如下：`pk_live_a1b2c3d4e5f6...`

## 第 3 步：选择 Endpoint

FourA 提供四个针对不同场景的 endpoint：

### Auto (`POST /api/auto/`)

智能默认选项。传入 URL，最好附带 `validate` 规则，FourA 会逐步尝试从轮换 proxy 到通过 proxy 运行的完整浏览器，并在获得首个通过校验的响应时停止。设置 `forceProxy: false` 可让其优先尝试直接 request。最适合用于目标为全新站点且尚不清楚其具体要求的情况。

### Single (`POST /api/single/`)

发送快速 HTTP request。最适合静态 HTML 页面和 API endpoint。响应时间：通常在 2 秒以内。

### Browser (`POST /api/browser/`)

运行 Chrome 浏览器实例以渲染 JavaScript。最适合 SPA、懒加载内容以及需要执行 JS 的页面。响应时间：2 到 10 秒。

### Proxy (`POST /api/proxy/`)

通过轮换 proxy 路由 request 并自动重试。最适合会检查请求来源身份或按国家/地区返回不同内容的站点。

## 第 4 步：发送你的第一个 Request

打开终端并运行：

```bash
curl -X POST https://eu.api.foura.ai/api/single/ \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"method": "GET", "url": "https://example.com"}'
```

## 步骤 5：读取 Response

```json
{
  "status": 200,
  "headers": [
    {
      "result": { "version": "HTTP/2", "code": 200, "reason": "" },
      "content-type": "text/html; charset=UTF-8",
      "content-length": "1256"
    }
  ],
  "data": "<html>...</html>",
  "total_time": 0.45
}
```

`headers` 字段是一个对象数组，每个重定向跳转对应一项。每个条目都包含一个 `result`，其中包含状态行以及目标返回的每个 response header。

关键字段：
- **status**：来自目标网站的 HTTP 状态码
- **data**：response body（HTML、JSON 或原始文本）
- **total_time**：request 耗时（秒）

## 步骤 6：尝试浏览器请求

如果目标页面使用 JavaScript 渲染内容，请改用浏览器 endpoint：

```bash
curl -X POST https://eu.api.foura.ai/api/browser/ \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com/products", "timeout_ms": 15000}'
```

浏览器响应使用 `body` 而不是 `data`：

```json
{
  "status": 200,
  "headers": {"content-type": "text/html"},
  "body": "<html>...</html>"
}
```

## 常见问题

| 问题 | 解决方案 |
|---------|----------|
| 不确定使用哪个引擎 | 从 auto endpoint 开始。它会自动选择合适的路径并记住有效方案。 |
| 内容为空 | 从 single 切换到 browser endpoint：该页面可能需要 JS 渲染 |
| 响应中出现验证页面 | 切换到 proxy endpoint 以启用自动 IP 轮换 |
| 超时 | 增加 `timeout_ms` 或验证 URL 是否正确 |
| Key 丢失 | 在 **API Keys** 中点击该 key 所在行的眼睛图标以显示，若是旧版 key 则重新生成 |

## 后续步骤

- [控制台概览](https://foura.ai/docs/dashboard/overview)：完整控制台操作指南
- [Playground](https://foura.ai/docs/dashboard/playground)：在编写代码前于控制台中测试请求
- [Smart Fetch (Auto)](https://foura.ai/docs/guides/smart-fetch)：深入了解 auto endpoint
- [选择合适的 Endpoint](https://foura.ai/docs/guides/choosing-task-type)：详细对比
- [常见问题](https://foura.ai/docs/troubleshooting/common-issues)：快速排查并解决问题
