​
Background Agents API

Background Agents API 让你可以以编程方式创建和管理由 AI 驱动的代码代理，这些代理会在你的代码仓库中自主工作。 你可以用这个 API 自动回应用户反馈、修复 bug、更新文档，等等！
Background Agents API 目前处于测试版，期待你的反馈！

​
关键功能

  • 自主代码生成 - 创建能够理解你的提示并对代码库进行修改的代理
  • 仓库集成 - 直接对接 GitHub 仓库
  • 后续提示 - 为正在运行的代理追加额外指令
  • 按用量计费 - 只为你消耗的 token 付费
  • 可扩展 - 每个 API key 最多支持 256 个活动代理

​
快速上手

​
1. 获取你的 API Key

前往 Cursor Dashboard → Integrations 创建你的 API Key。

​
2. 开始使用 API

所有 API 端点都以以下基址为准： 
https://api.cursor.com
查看 API 参考 获取完整的端点列表。

​
身份验证

所有 API 请求都需要使用 Bearer 令牌进行身份验证： 
Authorization: Bearer YOUR_API_KEY
可以在 Cursor 控制台 创建 API 密钥。密钥与账号绑定，并授予创建和管理代理的权限（具体受你的套餐限制和仓库访问权限约束）。

​
定价

API 目前处于测试阶段，定价与 Background Agents 保持一致。随着服务的扩展，定价可能会调整。查看 Background Agent 定价。

​
下一步