跳转到主要内容
POST
新建会话
使用默认的 Member 和 Admin 角色时,任何 API 密钥都可以调用此端点。在企业版中,自定义或修改过的 role 必须包含 使用 Devin 会话 权限 (UseDevinSessions) 。 会话将以该 API 密钥所属用户的身份创建。

限额与验证

  • prompt 不得超过 30,000 个字符;超出长度的提示将返回 400。
  • tags 最多接受 50 个标签,每个标签必须是不超过 256 个字符的非空字符串。如果企业强制执行必填标签,使用保留标签名称的请求将被拒绝并返回 400。
  • structured_output_schema 必须是有效的 JSON Schema (Draft 7) ,根级须为 "type": "object",不得包含外部 $ref,且大小不超过 64 KB;否则请求将返回 400。
  • 响应中的 is_new_session 仅在请求使用了 idempotency_key (或已弃用的 idempotent) 时才会设置;否则为 null。

授权

Authorization
string
header
必填

个人 API Key(apk_user_*)或服务 API Key(apk_*)

请求体

application/json
prompt
string
必填
idempotent
boolean
默认值:false
knowledge_ids
string[] | null

要使用的 Knowledge ID 列表。若为 None,则使用全部 Knowledge;若为空列表,则不使用任何 Knowledge。

max_acu_limit
integer | null

ACU 最大值,必须为正数

必填范围: x > 0
playbook_id
string | null
secret_ids
string[] | null

要使用的密钥 ID 列表。如果为 None,则表示使用所有密钥;如果为空列表,则表示不使用任何密钥。

session_secrets
SessionSecretInput · object[] | null

要使用的会话专用机密列表。这些机密仅在当前会话中可用,不会存入组织机密中。

snapshot_id
string | null
structured_output_schema
Structured Output Schema · object | null

用于验证结构化输出的 JSON Schema(Draft 7),最大 64 KB。必须是自包含的(不得引用外部 $ref)。

tags
string[] | null

要添加到本次会话的标签列表。

Maximum array length: 50
title
string | null

会话的自定义标题。如果为 None,则会自动生成标题。

unlisted
boolean
默认值:false

响应

成功响应

成功创建会话后返回的响应体。

session_id
string
必填
url
string
必填
is_new_session
boolean | null