跳转到主要内容
Devin API 允许你将 Devin 集成到你的应用程序中、实现工作流自动化，并构建强大的工具。我们提供三个 API 版本，每个版本都针对不同的使用场景和身份验证模型而设计。

​
API 版本

Devin 提供三个 API 版本，在功能和身份验证要求方面有所不同：

​
外部 API v1（组织级）

v1 API 提供核心会话管理功能，并支持组织级访问控制。 基础 URL： https://api.devin.ai/v1/* 认证方式： 个人或服务 API key 主要功能：
  • 创建和管理 Devin 会话
  • 向活动会话发送消息
  • 管理机密信息、Knowledge 和 playbook
  • 上传和下载附件
  • 更新会话标签
最适用于：
  • 通用会话自动化
  • 面向用户的集成
  • CI/CD 流水线
  • 开发和测试
查看 v1 API 文档 →

​
Enterprise API v2（仅限 Enterprise 管理员）

v2 API 提供面向整个 Enterprise 的管理和分析能力。 基本 URL： https://api.devin.ai/v2/enterprise/* 身份验证： 仅支持 Enterprise 管理员个人 API key 主要功能：
  • Enterprise 范围内的会话分析与洞察
  • 组织和成员管理
  • 使用量跟踪和计费数据
  • 审计日志与合规报告
  • Git 权限管理
  • 代码仓库索引
适用对象：
  • Enterprise 管理员
  • 分析与报告
  • 合规与审计
  • 组织管理
查看 v2 API 文档 →

​
服务用户 API v3（RBAC）

v3 API 通过服务用户身份验证提供完整的 RBAC 支持。 基础 URL：
  • https://api.devin.ai/v3beta1/enterprise/*
  • https://api.devin.ai/v3beta1/organizations/*
身份验证： 服务用户凭据（Enterprise 或组织级别） 主要特性：
  • 完整的基于角色的访问控制（RBAC）
  • 具有专用角色的服务用户
  • 细粒度权限
  • 多组织工作流程
  • 明确区分人类用户账号与服务账号
最适用于：
  • 具有特定权限的生产环境自动化
  • 多组织集成
  • 对合规要求敏感的工作流程
  • 长生命周期的服务集成
查看 v3 API 文档 →

​
快速入门

​
获取 API key

  1. 针对 v1 API： 在任意子组织的 Settings > API Keys 中生成一个 API key
  2. 针对 v2 API： 在任意子组织的 Settings > API Keys 中生成一个个人 API key
  3. 针对 v3 API： 在 Enterprise Settings > Service Users 中创建一个服务用户
请妥善保管您的 API key，切勿在 GitHub 仓库或客户端代码等公共可访问区域中共享。

​
发起你的第一个请求

在 Authorization 请求头中包含 API key： 
Authorization: Bearer your_api_key_here
示例 - 创建 v1 会话： 
curl -X POST "https://api.devin.ai/v1/sessions" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "创建一个简单的 Python 脚本来打印 Hello World"
  }'

​
错误处理

所有 API 均使用标准 HTTP 状态码：
  • 200 OK: 请求成功
  • 201 Created: 资源创建成功
  • 400 Bad Request: 请求参数无效
  • 401 Unauthorized: 缺少或无效的 API key
  • 403 Forbidden: 权限不足
  • 404 Not Found: 未找到资源
  • 429 Too Many Requests: 超出请求频率限制
  • 500 Internal Server Error: 服务器内部错误

​
支持

如有关于 API 的疑问或需要报告问题，请发送电子邮件至 [email protected]。