创建批量发视频任务

POST

/api/v1/cloud-mobile/tk-automation/video-task/create

能力（VIDEO_PUBLISH=批量发视频）。一条 item 生成一个子任务；同一手机不能在一次请求中用多个 item 发多条视频。幂等由服务端处理 (3.59版本以上有效)

请求参数

Header 参数

Body 参数application/json必填

示例

{
    "taskName": "QA-task3",
    "queueWhenBusy": true,
    "items": [
        {
            "mobileId": 1401142,
            "videoUrl": "https://example.com/video.mp4",
            "caption": "QA video caption"
        },
          {
            "mobileId": 1401141,
            "videoUrl": "https://example.com/video.mp4",
            "caption": "QA video caption"
        }
    ]
}

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'http://127.0.0.1:6873/api/v1/cloud-mobile/tk-automation/video-task/create' \
--header 'Accept-Language: zh-CN' \
--header 'Content-Type: application/json' \
--data '{
    "taskName": "QA-task3",
    "queueWhenBusy": true,
    "items": [
        {
            "mobileId": 1401142,
            "videoUrl": "https://example.com/video.mp4",
            "caption": "QA video caption"
        },
          {
            "mobileId": 1401141,
            "videoUrl": "https://example.com/video.mp4",
            "caption": "QA video caption"
        }
    ]
}'

返回响应

🟢200

application/json

成功。CreateResponse（服务端 ResponsePo 外壳 code=200；网关包装 code=0/msg="Success"）。data 含 taskId/status/createdAt/idempotentReplay。

Bodyapplication/json

示例

{
    "code": 0,
    "msg": "Success",
    "requestId": "1ed4ffd3-7e39-4bdc-8140-53447c49c3dd",
    "timestamp": 1788782341257,
    "data": {
        "taskId": "string",
        "status": "string",
        "createdAt": "2019-08-24T14:15:22.123Z",
        "idempotentReplay": true
    }
}

🟠4xx

修改于 2026-09-11 01:39:38

删除环境分组

创建TikTok智能养号任务