跳转到主要内容
POST
新建会话

授权

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