跳转到主要内容
POST
/
v1
/
sessions
新建会话
curl --request POST \
  --url https://api.devin.ai/v1/sessions \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "prompt": "<string>",
  "idempotent": false,
  "knowledge_ids": [
    "<string>"
  ],
  "max_acu_limit": 1,
  "playbook_id": "<string>",
  "secret_ids": [
    "<string>"
  ],
  "session_secrets": [
    {
      "key": "<string>",
      "value": "<string>",
      "sensitive": true
    }
  ],
  "snapshot_id": "<string>",
  "tags": [
    "<string>"
  ],
  "title": "<string>",
  "unlisted": false
}
'
{
  "session_id": "<string>",
  "url": "<string>",
  "is_new_session": true
}

授权

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
tags
string[] | null

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

title
string | null

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

unlisted
boolean
默认值:false

响应

成功响应

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

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