发起一个计费任务回合

POST

/v1/sessions/{sessionId}/turns

仅接受有界文本输入；成功受理后记一个计费 Turn，相同幂等键重放不重复执行也不重复计费。

请求参数

Authorization

在 Header 添加参数

Authorization

，其值为在 Bearer 之后拼接 Token

示例：

Authorization: Bearer ********************

Path 参数

Header 参数

Body 参数application/json必填

示例

{
    "input": [
        {
            "type": "text",
            "text": "核对九月份应收账款并列出异常项"
        }
    ]
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/v1/sessions//turns' \
--header 'Idempotency-Key;' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "input": [
        {
            "type": "text",
            "text": "核对九月份应收账款并列出异常项"
        }
    ]
}'

返回响应

🟢200

application/json

已按相同幂等键重放原回合结果。

Bodyapplication/json

示例

{
    "replayed": false,
    "turn": {
        "id": "id_example",
        "sessionId": "session_example",
        "employeeVersionId": "employeeversion_example",
        "status": "starting",
        "input": [
            {
                "type": "text",
                "text": "示例内容"
            }
        ],
        "failureCode": "示例值",
        "createdAt": "2026-09-27T08:00:00.000Z",
        "updatedAt": "2026-09-27T08:00:00.000Z",
        "startedAt": "2026-09-27T08:00:00.000Z",
        "completedAt": "2026-09-27T08:00:00.000Z"
    }
}

🟢201

🔵307RuntimeRedirect

🟠400BadRequest

🟠401Unauthorized

🟠402PaymentRequired

🟠403Forbidden

🟠404NotFound

🟠409Conflict

🟠413PayloadTooLarge

🟠429TooManyRequests

🔴502BadGateway

🔴503ServiceUnavailable

修改于 2026-09-27 15:11:45

关闭数字员工会话

获取当前项目的计费用量事件