跳转到主要内容
立即创建一个新的 API 密钥，并附带 50 积分的沙盒环境。系统会向赞助方发送验证邮件。无需身份验证。 有关完整流程说明，请参阅 代理注册指南。

​
请求头

请求头值
Content-Typeapplication/json

​
请求体

参数类型必填描述
emailstring是人工赞助方的邮箱地址。必须是有效的邮箱地址。
agent_namestring是创建密钥的代理名称 (1–100 个字符) 。会显示在验证邮件中。
accept_termsboolean是必须为 true。表示已确认服务条款。

​
响应

字段类型描述
successboolean该密钥是否创建成功
api_keystring已分配的 API 密钥 (以 fc- 开头)
sponsor_statusstring创建时始终为 "pending"
credit_limitnumber完成验证前可用的最大额度 (50)
credits_remainingnumber剩余额度 (创建时为 50)
verification_deadline_atstringISO 8601 时间戳。赞助方必须在此截止时间前确认 (5 天) 。
tos_urlstring已接受的服务条款 URL

​
请求示例

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
  }'

​
示例响应

{
  "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"
}

​
错误响应

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