> ## Documentation Index
> Fetch the complete documentation index at: https://firecrawl-abimaelmartell-agent-default-model.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# 代理注册

> 代表人工赞助方创建一个沙盒环境中的 Firecrawl API 密钥。

立即创建一个新的 API 密钥，并附带 50 积分的沙盒环境。系统会向赞助方发送验证邮件。无需身份验证。

有关完整流程说明，请参阅 [代理注册指南](/zh/features/agent-signup)。

<div id="headers">
  ## 请求头
</div>

| 请求头            | 值                  |
| -------------- | ------------------ |
| `Content-Type` | `application/json` |

<div id="request-body">
  ## 请求体
</div>

| 参数             | 类型      | 必填    | 描述                                                              |
| -------------- | ------- | ----- | --------------------------------------------------------------- |
| `email`        | string  | **是** | 人工赞助方的邮箱地址。必须是有效的邮箱地址。                                          |
| `agent_name`   | string  | **是** | 创建密钥的代理名称 (1–100 个字符) 。会显示在验证邮件中。                               |
| `accept_terms` | boolean | **是** | 必须为 `true`。表示已确认[服务条款](https://firecrawl.dev/terms-of-service)。 |

<div id="response">
  ## 响应
</div>

| 字段                         | 类型      | 描述                                  |
| -------------------------- | ------- | ----------------------------------- |
| `success`                  | boolean | 该密钥是否创建成功                           |
| `api_key`                  | string  | 已分配的 API 密钥 (以 `fc-` 开头)            |
| `sponsor_status`           | string  | 创建时始终为 `"pending"`                  |
| `credit_limit`             | number  | 完成验证前可用的最大额度 (50)                   |
| `credits_remaining`        | number  | 剩余额度 (创建时为 50)                      |
| `verification_deadline_at` | string  | ISO 8601 时间戳。赞助方必须在此截止时间前确认 (5 天) 。 |
| `tos_url`                  | string  | 已接受的服务条款 URL                        |

<div id="example-request">
  ### 请求示例
</div>

```bash theme={null}
curl -X POST "https://api.firecrawl.dev/v2/agent-signup" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "user@company.com",
    "agent_name": "Research Assistant",
    "accept_terms": true
  }'
```

<div id="example-response">
  ### 示例响应
</div>

```json theme={null}
{
  "success": true,
  "api_key": "fc-abc123...",
  "sponsor_status": "pending",
  "credit_limit": 50,
  "credits_remaining": 50,
  "verification_deadline_at": "2026-03-23T12:00:00.000Z",
  "tos_url": "https://firecrawl.dev/terms-of-service"
}
```

<div id="error-responses">
  ## 错误响应
</div>

| 状态    | 错误                        | 何时                    |
| ----- | ------------------------- | --------------------- |
| `400` | 无效的请求体                    | 缺少字段或字段无效             |
| `403` | 此 email 已禁止代理注册           | 赞助方此前已禁止代理注册          |
| `403` | 之前的代理注册验证已过期              | 之前的注册已过期；赞助方应登录       |
| `409` | 已向该 email 发送过一封待处理的代理注册确认 | 此 email 已有一个密钥处于待处理状态 |