TikTok 视频 AI 生成与发布（数字员工 Toby）

功能简介

本技能基于 deepsop 平台数字员工 Toby，能够：

理解自然语言指令：直接描述需求，如「生成一条库阔 AI 宣传视频发布到 TikTok」
AI 视频生成：调用 Veo3.1 / Sora2 / Wan2.x / Seedance / kling-v3-omni 等多种视频模型生成视频
TikTok 自动发布：根据用户配置的发布参数（数量、开始时间、间隔）自动定时发布到指定 TikTok 账号
结果统计：任务完成后自动查询播放量、点赞、评论、分享、视频明细等数据，并展示 TikTok 链接

> Toby 不依赖客户挖掘（AiWa）等其他员工，可独立执行。如需配合客户挖掘 / 邮件销售 / 电话销售 / 短信销售等多员工协作，请改用 deepsop-humabot。

前置条件：获取 API Key

本技能需要 API Key 授权才能调用 DeepSOP 接口。

获取 API Key 入口：

已有账号 → https://ai.deepsop.com/login?source=5
没有账号 → https://ai.deepsop.com/register?source=5

登录后进入「设置」/「API 管理」页面，新建以 sk- 开头的 API Key。
配置环境变量：

DEEPSOP_API_KEY=sk-xxxxxxxxxxxxxxxxxxxxxx

> 所有 API 请求头需携带：x-api-key: $DEEPSOP_API_KEY

> API Base URL：https://ai.deepsop.com/prod-api/

⛔ 接口路径强约束（最高优先级）

> 🔒 调用任何接口时，必须严格使用本文档对应步骤标注的完整 URL，不得做任何形式的改写、简化、猜测或自创。

> 请求前自检流程：

> 1. 在下方「API 路径权威清单」中找到对应步骤的接口；

> 2. 将即将发出的完整 URL（含 host、path、query key 名与顺序、platform=1 / pageSize 等）与清单中的 Path 列逐字符比对；

> 3. 完全一致才允许发出；任何偏差立即停止。

> 禁止行为：

> - ❌ 把 prod-api 改成 api / v1 / prod

> - ❌ 把 camelCase 改成 snake_case 或全小写（presetEmployee ≠ preset_employee ≠ presetemployee）

> - ❌ authaccount 偏偏是全小写，不得改成 authAccount

> - ❌ 漏写或私自补加 query 参数（如漏 platform=1 / status=1）

> - ❌ 凭"经验/记忆"猜测路径，不回到本文档对照

📋 API 路径权威清单（Base URL: `https://ai.deepsop.com/prod-api`）

| # | 步骤 | 方法 | Path（不含 Base URL） |

|---|---|---|---|

| 1 | Step 1.5 数字员工可用性 | GET | /ai/presetEmployee/list |

| 1.1 | Step 1.5.1① 签约套餐列表 | GET | /ai/setting/list?packageType=3 |

| 1.2 | Step 1.5.1② 人民币→K币汇率 | GET | /system/config/configKey/CNY_TO_KCOIN |

| 1.3 | Step 1.5.1③ K币余额查询 | GET | /ai/vip/balance?userId={userId} |

| 1.5 | Step 1.5.1③ 用户 Profile（取 userId） | GET | /ai/user/profile |

| 3 | Step 3 前置 E-1 TikTok 账号列表 | GET | /ai/authaccount/list?pageNum=1&pageSize=999&platform=1&status=1 |

| 4 | Step 3 前置 E-2 TikTok 账号权限 | GET | /ai/auth/tiktok/getCreatorInfo?authAccountId={id} |

| 6 | Step 5-1 视频统计 | GET | /ai/data/count?taskId={tobyDagTaskId}&customerPoolId={tobyCustomerPoolId}&platform=1 |

| 7 | Step 5-2 视频列表 | GET | /ai/data/list?pageNum=1&pageSize=10&taskId={tobyDagTaskId}&customerPoolId={tobyCustomerPoolId}&platform=1 |

🛡️ 双轨强约束（本文档 + 代码）

> 上述清单同时存在于 scripts/api_paths.py：

> - LLM 直接发请求时： 必须对照本文档清单逐字符比对路径。

> - 脚本调用 API 时： 严禁脚本内硬编码 URL，必须从 api_paths.py 通过 build_url("xxx") 获取，并配合 assert_url_matches() 自检。

> - 漂移检测：运行 python scripts/api_paths.py 会扫描本文件中所有 https://ai.deepsop.com/prod-api/... 路径，未在 api_paths.py 登记则非零退出。

完整执行流程

Step 0：触发类型判断（每次进入技能必须首先执行）

检查输入是否包含 [DeepSOP-AutoQuery-Toby] 标记：

包含：cron 定时回调。不得询问用户、不得等待确认。立即从输入中解析 taskId / tobyDagTaskId / tobyCustomerPoolId / taskName / feishuChatId，跳过 Step 1～4 直接执行 Step 5。
不包含：用户主动指令，继续 Step 1。

Step 1：AI 分析（任务拆解）

用以下 prompt 分析用户指令，严格返回 JSON：

根据【指令】描述，Json格式返回数据
不需要多余的描述，不要过度解读，没有提及的内容请不要擅自理解，识别结果除了Json数据其他文字不要出现
规则如下：{
  "taskName": "根据描述总结出一个简洁的任务名称",
  "totalTarget": "提取描述中提及的视频数量（无单位纯数字）；未提及则填 1",
  "tiktokContent": "根据描述总结出一个 TikTok 内容发布的内容主题"
}

解析结果字段（注意：内部解析变量，不要原样塞到最终 API 请求体）：

taskName → collaborationSubmitTaskParam.taskName
totalTarget → employeeParams.Toby.totalTarget（不得作为根级字段）
tiktokContent → employeeParams.Toby.content 与 employeeParams.Toby.param.text（不得作为独立字段出现）

executionMode 当前阶段强制规则： 提交请求体时一律硬编码为数字 1（定额任务）。后端枚举：周期性任务 = 0，定额任务 = 1。绝不允许写中文字符串、"1" 字符串、true、null。

Step 1.5：数字员工 Toby 可用性校验（Step 1 完成后立即执行）

接口： GET https://ai.deepsop.com/prod-api/ai/presetEmployee/list

请求头： x-api-key: $DEEPSOP_API_KEY

响应 data 数组中找到 name === "Toby" 的条目，检查：

status：0 = 启用，1 = 禁用
remainingDays：剩余可用天数（可为 null）

规则：

禁用（status=1）→ 终止任务：

> ⚠️ 数字员工「Toby」当前处于禁用状态，无法执行任务。请联系管理员启用后再试。

未开通 / 已过期（status=0 且 remainingDays 为 null 或 ≤ 0）→ 进入签约流程（Step 1.5.1）。完成后重新拉 /ai/presetEmployee/list 校验通过后继续；用户放弃或余额不足则终止。

剩余 ≤ 7 天 → 提示但允许继续：

> ⚡ 提示：数字员工「Toby」剩余可用天数仅剩 {remainingDays} 天，建议尽快前往 https://ai.deepsop.com 续费。

正常（status=0 且 remainingDays > 7）→ 继续

Step 1.5.1：Toby 签约流程（仅规则 2 触发时执行）

① 拉取套餐列表

接口：GET https://ai.deepsop.com/prod-api/ai/setting/list?packageType=3

响应 data 中按 presetEmployeeId 匹配 Toby 对应条目，取其 packageOptions：

{
  presetEmployeeId,
  packageOptions: [
    { id, packageId, description, purchaseMonths, actualPrice, discountRate, giftKToken }
  ]
}

② 展示套餐

获取人民币→K币汇率：

接口：GET https://ai.deepsop.com/prod-api/system/config/configKey/CNY_TO_KCOIN

响应 msg 即为汇率（rate）。

应付 K 币计算：

priceKCoin = actualPrice × (discountRate / 100) × rate

向用户展示并等待用户回复序号。用户「取消」→ 终止：

> 已取消签约，任务终止。

③ K 币余额校验

> 🔒 强制实时查询规则：每次进入本步骤都必须重新调用 /ai/vip/balance，严禁复用先前查询到的 balance 值。

先获取 userId：GET https://ai.deepsop.com/prod-api/ai/user/profile 响应 data.userId。

接口：GET https://ai.deepsop.com/prod-api/ai/vip/balance?userId={userId}

响应 data 即为余额。

balance < priceKCoin → 终止：

> ❌ 余额不足，签约失败。当前余额：{balance} K币，所需：{priceKCoin} K币。

> 请前往 https://ai.deepsop.com 充值后重新下达任务。

balance ≥ priceKCoin → 进入 ④

④ 提交签约

接口：POST https://ai.deepsop.com/prod-api/ai/order/purchaseIndependentPackageByKToken

请求体：

{ "packageId": "<packageId>", "optionId": "<id>" }

成功 → 回复成功并回到 Step 1.5 校验后继续；失败 → 终止。

Step 2：Toby TikTok 账号与发布参数配置（Step 3 前置）

E-1：查询 TikTok 绑定账号

接口：GET https://ai.deepsop.com/prod-api/ai/authaccount/list?pageNum=1&pageSize=999&platform=1&status=1

请求头：x-api-key: $DEEPSOP_API_KEY

关键字段：

rows[].id、rows[].account、rows[].fansNum、rows[].groupNames、rows[].expiredTime

处理：

rows 为空 → 终止：

> ⚠️ 当前账号未绑定任何 TikTok 授权账号，请先登录 https://ai.deepsop.com 添加 TikTok 授权账号后再试。

1 条 → 列出并等用户回复「确认」：

```

检测到以下 TikTok 账号，请确认是否使用（回复「确认」即可）：

@{account}（粉丝：{fansNum}，分组：{groupNames}）

```

多条 → 列出供用户多选（逗号分隔序号）。

等待用户确认/选择后，将选中账号的 id 列表记为 selectedAccountIds。

E-2：获取账号权限信息

针对第一个选中账号：

接口：GET https://ai.deepsop.com/prod-api/ai/auth/tiktok/getCreatorInfo?authAccountId={selectedAccountIds[0]}

提取：

data.privacyLevelOptions[]：可用隐私级别
data.commentDisabled / data.duetDisabled / data.stitchDisabled

privacyLevelOptions 多个时让用户选择隐私级别：

请选择该账号的视频隐私设置（回复序号）：
1. PUBLIC_TO_EVERYONE — 全公开
2. MUTUAL_FOLLOW_FRIENDS — 互关好友
3. SELF_ONLY — 仅自己可见

E-3：AI 视频生成模型（默认）

param.methodType 默认固定为 "3"（Veo3.1 Fast Lite），无需用户选择。如需查看全部模型，可调：

接口：POST https://ai.deepsop.com/prod-api/ai/consumeSource/list?pageNum=1&pageSize=999

请求体：{"sourceTypeList":["VIDEO_MODEL"],"hiddenState":"0"}

默认 methodType="3" 下其他视频参数默认：

resolution: 720p，ratio: 16:9，duration: 8（methodType=3 唯一允许值）
generationType: "FIRST&LAST"，shotType: "single"，mode: "pro"
keepOriginalSound: "yes"，personGeneration: "allow_adult"，resizeMode: "pad"
n: 1，generateAudio: true
enhancePrompt / promptExtend / multiShot: false，durationSwitch: "1"

> 若用户切换其他模型（Veo3.1 Pro / Sora2 Pro / kling-v3-omni 等），先调 consumeSource/list 拿 sourceValue，再据此 methodType 去下方「methodType → 取值约束表」校正各依赖字段，不得沿用默认值。

E-4：视频生成提示词确认（必问，禁止跳过）

以 Step 1 解析出的 tiktokContent 作为默认提示词，强制询问：

当前 AI 视频生成提示词为：「{tiktokContent}」
是否需要修改？（回复「不用」直接使用，或直接输入新的提示词）

「不用」/类似否定 → 保持 tiktokContent 不变
输入新提示词 → 替换 content 与 param.text

未收到用户回复不得继续。

E-5：发布参数配置（必须由用户指定，禁止自动填充）

针对每个选中账号依次询问：

请为账号 @{account} 配置发布参数：
- 每天发布视频数（publishCount，如 3）：
- 定时发布开始时间（startTime，HH:mm 格式，如 09:30）：
- 视频发布间隔（publishInterval，分钟，如 60）：

等待所有账号回复完毕后，构建 publishTemplates。

Step 3：构建并提交任务

> 🧷 请求体总规约（最高优先级）

> collaborationSubmitTaskParam 有且仅有以下 5 个根级键：

> ```ts

> {

> "taskName": String, // Step 1 的 taskName，非空

> "currentModule": "content",// 字符串字面量，永远是 "content"

> "executionMode": 1, // 永远写数字 1

> "employeeParams": { "Toby": {...} },

> "taskDescription": String // 用户原始指令，原文透传

> }

> ```

> 与其同级必须再带：

> - completed: true（布尔字面量）

> - sourceSettings: null（Toby 单独执行时永远为 null）

> 硬规则：

> 1. currentModule 永远 "content"；executionMode 永远 1。

> 2. taskDescription 透传用户原文，禁止改写为 AI 总结。

> 3. employeeParams 子键必须是 PascalCase Toby，不得 toby / TOBY / tobyParam。

> 4. Step 1 内部解析变量（tiktokContent / 根级 totalTarget）一律不得出现在请求体中——只能流到 employeeParams.Toby 内的指定字段。

接口： POST https://ai.deepsop.com/prod-api/ai/presetEmployee/submitTask

请求头：

Content-Type: application/json; charset=utf-8
x-api-key: $DEEPSOP_API_KEY

> 🔒 强制使用 submit_task.py 提交，禁止直接 curl：

> ```bash

> python3 scripts/submit_task.py <<'TASK_BODY_EOF'

> {

> "completed": true,

> "collaborationSubmitTaskParam": { ...完整请求体... }

> }

> TASK_BODY_EOF

> ```

> 原因：直接 curl -d '{中文 JSON}' 会触发 Windows cp936 与 UTF-8 转码歧义，导致 taskName/taskDescription 中文乱码。submit_task.py 通过 stdin 字节流 + 显式 UTF-8 + Content-Type: application/json; charset=utf-8 闭合编码链路，并内置 validate_employee_params.py pre-flight 校验。

> 行为约束：

> - 必须 heredoc 单引号定界符（<<'TASK_BODY_EOF'），禁止 argv 传 JSON。

> - 退路：python3 scripts/submit_task.py --file /tmp/task_body.json。

> - 退出码：0 成功 / 1 校验失败 / 2 网络失败 / 3 服务端非 2xx / 4 输入格式错误。

> - 退出码 ≠ 0 时，必须把 summary + errors/response 原样回给用户，不得跳过或假装成功。

> ⛔ 字段名零改写规则： 所有键名严格保持 camelCase，不得改 snake_case / kebab-case / 同义词。accountConfigList ≠ account_config_list，publishTemplates ≠ publish_templates，staffId ≠ staff_id，videoItems ≠ video_items，等等。

Toby 参数构建规则：

totalTarget：定额模式下填 Step 1 的 totalTarget，周期模式下为 null
incrementalTarget：周期模式下填用户指定的每天发布数，定额模式下固定填 10
upperLimitTarget：固定 10
content：来自 Step 1 的 tiktokContent（E-4 确认后的最终值）
staffId：固定为空字符串 ""
param：嵌套对象，有且仅有以下 27 个键，必须按官方默认模板的键集构建（text 取自 E-4 确认后的最终提示词；methodType 默认 "3"）。注意：当前 methodType 下 UI 不显的字段也必须传默认值，禁止裁剪 key：

| 字段 | 默认值 | 类型 | 说明 |

|---|---|---|---|

| imageUrlList | [] | string[] | 参考图（仅 generationType ∈ {REFERENCE,EDIT,FEATURE} 时填） |

| lastImageUrl | null | string\|null | 尾帧图（除 methodType ∈ {auto,1,8,11,12} 外） |

| firstClipUrl | null | string\|null | 续写/编辑/参考视频（仅 methodType ∈ {10,14}） |

| videoUrlList | [] | string[] | 参考视频（methodType ∈ {9,16,17,18}） |

| audioUrl | null | string\|null | 参考音频（methodType ∈ {7,8,14,15,16}） |

| generateAudio | true | boolean | 是否生成声音（methodType ∈ {2,5,6,10,17,18} 生效） |

| enhancePrompt | false | boolean | 翻译为英文（methodType ∈ {3,4,5,6} 生效） |

| n | 1 | number | 生成数量（methodType ∈ {5,6} 生效） |

| personGeneration | "allow_adult" | string | 是否允许人物（methodType ∈ {5,6} 生效） |

| resizeMode | "pad" | string | 图像缩放（methodType ∈ {5,6} 生效） |

| promptExtend | false | boolean | 智能改写（methodType ∈ {7,8,9,14,15,16} 生效） |

| durationSwitch | "1" | string | 生成时长模式（methodType ∈ {2,17,18} 生效） |

videoItems：固定 []
publishTemplates：每个选中账号一条：
publishCount：用户指定（字符串）
releaseType：固定 "1"
timeZone：固定 "1"
intervalType：固定 "1"
startTime：用户指定（HH:mm）
accountId：对应账号 id（字符串）
publishInterval：用户指定（整数，分钟）
accountConfigList：仅一条，取 E-2 中第一个选中账号：
accountId：selectedAccountIds[0]（字符串）
privacyLevel：用户选定值
disableDuet：来自 data.duetDisabled（布尔转字符串）
disableStitch：来自 data.stitchDisabled
disableComment：来自 data.commentDisabled
expand：固定 false
brandContentToggle：固定 "false"
brandOrganicToggle：固定 "false"
isPublicAccount：固定 true
commentDisabled：同 data.commentDisabled（布尔转字符串）
duetDisabled：同 data.duetDisabled
stitchDisabled：同 data.stitchDisabled

> ⛔ Toby 结构强约束：

> 1. 子对象 key 必须 Toby，不得 toby / TOBY / tobyParam / tobyParams。

> 2. 必须嵌在 collaborationSubmitTaskParam.employeeParams.Toby 下。

> 3. param 必须保持嵌套对象：所有视频生成参数都是 param 内部键，禁止提升到 Toby 根部（错例：Toby.methodType、Toby.text）。

> 4. tiktokContent 不是请求体字段，其值落到 Toby.content 与 Toby.param.text，但不得自己再加 tiktokContent 键。

> 5. publishTemplates 数组每条必填 7 键。

> 6. accountConfigList 数组（仅一条）必填 12 键。

> 7. staffId 必填，空字符串 "" 也得给。

> 8. videoItems 必填，空数组 [] 也得给。

> 9. Toby 根部必填 9 键：totalTarget / incrementalTarget / upperLimitTarget / content / staffId / param / videoItems / publishTemplates / accountConfigList。

> 10. param 27 键全量传：即使当前 methodType 隐藏了某些字段，请求体仍按表中默认值传值，不得裁剪 key。

📐 methodType → 取值约束表：

|---|---|---|---|---|---|---|

| "1" | Sora2 BetaMax | TEXT,FIRST&LAST | 720p | 16:9,9:16 | step=5, 10–15, 默认 10 | single |

| "7" | Wan2.6 t2v | TEXT | 720p,1080p | 1:1,3:4,4:3,16:9,9:16 | step=1, 3–15, 默认 3 | single,multi |

| "9" | Wan2.6 r2v | REFERENCE | 720p,1080p | 1:1,3:4,4:3,16:9,9:16 | step=1, 3–10, 默认 3 | single,multi |

| "11" | Sora2 | TEXT,FIRST&LAST | 720p | 16:9,9:16 | step=4, 4–12, 默认 4 | single |

| "12" | Sora2 Pro | TEXT,FIRST&LAST | 720p,2K | 16:9,9:16,7:4,4:7 | step=4, 4–12, 默认 4 | single |

| "15" | Wan2.7 t2v | TEXT | 720p,1080p | 1:1,3:4,4:3,16:9,9:16 | step=1, 3–15, 默认 3 | single |

| "16" | Wan2.7 r2v | REFERENCE | 720p,1080p | 1:1,3:4,4:3,16:9,9:16 | 有 videoUrlList 时 step=1, 3–10；否则 3–15；默认 3 | single |

> 🔒 填值硬规则：

> 1. generationType / resolution / ratio / shotType 必须从该 methodType 行内"可选值"中取。

> 2. duration 必须落在该行 [最小, 最大] 闭区间内，且 (duration - 最小) % 步长 === 0。methodType="3" 时只能是 8。

> 3. methodType="8" / "14" 时不传 ratio（键保留、值给默认 "16:9"，后端忽略）；methodType="10" 时不传 resolution（键保留、值给默认 "720p"）；methodType="auto" 时 duration 由后端决定（键保留默认 8）。

> 4. 字段间依赖：

> - generationType="FIRST&LAST" → firstImageUrl 必填、lastImageUrl 必填（除 methodType ∈ {auto,1,8,11,12} 留 null）

> - generationType ∈ {REFERENCE, EDIT, FEATURE} → imageUrlList ≥ 1 项

> - generationType ∈ {CONTINUATION, EDIT, FEATURE} → firstClipUrl 必填（仅 methodType ∈ {10,14} 支持）

> - shotType="customize" → multiPrompt ≥ 1 项；text 可留空

> 5. 默认 methodType="3" 下，合法 param 默认快照：generationType="FIRST&LAST"、resolution="720p"、ratio="16:9"、duration=8、shotType="single"、enhancePrompt=false，其他依赖字段保持空值（null 或 []）。

Toby 任务请求体示例：

{
  "collaborationSubmitTaskParam": {
    "taskName": "AI宣传视频TikTok分发",
    "taskDescription": "生成库阔AI宣传视频分发到tiktok",
    "executionMode": 1,
    "employeeParams": {
      "Toby": {
        "totalTarget": 1,
        "incrementalTarget": 10,
        "upperLimitTarget": 10,
        "content": "库阔AI宣传视频",
        "staffId": "",
        "param": {
          "methodType": "3",
          "multiShot": false,
          "generationType": "FIRST&LAST",
          "text": "库阔AI宣传视频",
          "multiPrompt": [],
          "negativePrompt": "",
          "imageUrlList": [],
          "firstImageUrl": null,
          "lastImageUrl": null,
          "firstClipUrl": null,
          "elementList": [],
          "videoUrlList": [],
          "audioUrl": null,
          "keepOriginalSound": "yes",
          "durationList": [],
          "mode": "pro",
          "resolution": "720p",
          "ratio": "16:9",
          "generateAudio": true,
          "enhancePrompt": false,
          "n": 1,
          "personGeneration": "allow_adult",
          "resizeMode": "pad",
          "promptExtend": false,
          "shotType": "single",
          "durationSwitch": "1",
          "duration": 8
        },
        "videoItems": [],
        "publishTemplates": [
          {
            "publishCount": "1",
            "releaseType": "1",
            "timeZone": "1",
            "intervalType": "1",
            "startTime": "15:10",
            "accountId": "130",
            "publishInterval": 60
          }
        ],
        "accountConfigList": [
          {
            "accountId": "130",
            "privacyLevel": "PUBLIC_TO_EVERYONE",
            "disableDuet": "false",
            "disableStitch": "false",
            "disableComment": "false",
            "expand": false,
            "brandContentToggle": "false",
            "brandOrganicToggle": "false",
            "isPublicAccount": true,
            "commentDisabled": "false",
            "duetDisabled": "false",
            "stitchDisabled": "false"
          }
        ]
      }
    },
    "sourceSettings": null,
    "currentModule": "content"
  },
  "completed": true
}

用户确认清单（缺一不可提交）：

✅ 用户已选择/确认 TikTok 账号（selectedAccountIds 非空）
✅ 用户已确认或修改视频生成提示词（content 已确定）
✅ 用户已为每个账号填写 publishCount、startTime、publishInterval
✅ 用户已选择隐私级别（privacyLevel 非空）

成功响应：

{
  "msg": "操作成功",
  "code": 200,
  "data": {
    "employeeList": [
      { "dagTaskId": "<tobyDagTaskId>", "nodeType": "TOBY", "customerPoolId": 1066 }
    ],
    "taskId": "<taskId>"
  }
}

响应字段提取：

taskId = data.taskId
tobyDagTaskId：遍历 data.employeeList 找 nodeType === "TOBY" 取 dagTaskId
tobyCustomerPoolId：同条目的 customerPoolId

> ⚠️ nodeType 后端返回全大写 "TOBY"，不是 PascalCase Toby。

提交成功后，告知用户并询问等待时间：

> 任务已提交！任务名：{taskName}，目标视频数：{totalTarget}，任务ID：{taskId}。

> 后台正在生成与发布，你希望多久后查询结果并推送给你？（直接告诉我时间，例如「8 分钟」「半小时」「20 分钟后」，直接回复「好」或不填则默认 8 分钟）

Step 3.5：解析用户指定的等待时间

| 用户说 | 解析为秒数 |

|--------|----------|

| N分钟 / N分 | N × 60 |

| N小时 | N × 3600 |

| 半小时 | 1800 |

| 一刻钟 | 900 |

| 好 / 默认 / ok / 回车 / 不填 | 480（8分钟）|

| 无法识别 | 再询问一次，仍无效则用 480 |

回复确认：

> 好的，将在 {用户指定时间描述}（约 {N} 分钟）后为你查询结果，请稍候 ☕

Step 4：按用户指定时间设置自动查询

使用 cron 工具设置一次性定时任务：

{
  "action": "add",
  "job": {
    "name": "toby-query-{taskId前8位}",
    "schedule": { "kind": "at", "at": "{当前时间 + waitSeconds 的 ISO8601 字符串，如 2026-03-19T15:00:00+08:00}" },
    "sessionTarget": "main",
    "wakeMode": "now",
    "payload": {
      "kind": "systemEvent",
      "text": "[DeepSOP-AutoQuery-Toby] TikTok 视频任务定时结果推送，请立即跳转 Step 5 执行结果查询并主动推送，不要等待用户提问，不要执行 Step 1-4。taskId={taskId}，tobyDagTaskId={tobyDagTaskId}，tobyCustomerPoolId={tobyCustomerPoolId}，任务名：{taskName}，feishuChatId={feishuChatId}。1. 调用 GET https://ai.deepsop.com/prod-api/ai/data/count?taskId={tobyDagTaskId}&customerPoolId={tobyCustomerPoolId}&platform=1 查询统计；2. 调用 GET https://ai.deepsop.com/prod-api/ai/data/list?pageNum=1&pageSize=10&taskId={tobyDagTaskId}&customerPoolId={tobyCustomerPoolId}&platform=1 查询视频列表；3. 展示统计数据（播放、点赞、评论、分享、发布总数）并列出每条视频的标题、播放、点赞、评论、转发、发布时间、TikTok 链接。"
    },
    "deleteAfterRun": true
  }
}

cron 设置成功后回复：

> ✅ 定时任务已设置！将在 {N} 分钟后（{schedule.at}）自动查询结果并推送，请安心等候 ⏰

> 如需提前查询，可说「现在就查结果」，我会立即执行。

> ⚠️ 等待期间处理规则：

> - cron 设置完成到 [DeepSOP-AutoQuery-Toby] 到达之前，不得主动执行 Step 5。

> - 用户在等待期间问其他话题，正常回应，但不要提前查询。

> - 用户说「现在就查结果」/「提前查」→ 立即执行 Step 5。

Step 5：查询结果并返回给用户

> 🚨 触发锁定：Step 5 只允许在以下两种情况下执行：

> 1. 收到含 [DeepSOP-AutoQuery-Toby] 标记的 systemEvent

> 2. 用户明确说「现在就查结果」/「提前查」

5-1：查询统计数据

接口：GET https://ai.deepsop.com/prod-api/ai/data/count?taskId={tobyDagTaskId}&customerPoolId={tobyCustomerPoolId}&platform=1

请求头：x-api-key: $DEEPSOP_API_KEY

关键字段：

data.playCount：总播放量
data.likeCount：总点赞数
data.commentCount：总评论数
data.shareCount：总分享数
data.totalTiktokCount：已发布视频数

5-2：查询视频列表

接口：GET https://ai.deepsop.com/prod-api/ai/data/list?pageNum=1&pageSize=10&taskId={tobyDagTaskId}&customerPoolId={tobyCustomerPoolId}&platform=1

请求头：x-api-key: $DEEPSOP_API_KEY

关键字段：

rows[].titleName：视频标题
rows[].platformUrl：TikTok 链接
rows[].url：视频文件地址
rows[].playNum / likesNum / commentNum / transmitNum
rows[].displayCreateTime：发布时间
total：列表总数

5-3：回复结果摘要

🎥 Toby TikTok 视频发布结果
任务：{taskName}

📊 数据概览：
   发布视频数：{totalTiktokCount}
   总播放量：{playCount}
   总点赞数：{likeCount}
   总评论数：{commentCount}
   总分享数：{shareCount}

📋 视频明细（共 {total} 条）：
1. 《{titleName}》
   播放：{playNum} | 点赞：{likesNum} | 评论：{commentNum} | 转发：{transmitNum}
   发布时间：{displayCreateTime}
   TikTok 链接：{platformUrl}
2. ...

情况：两个接口均返回非 200 或 data 为空

> Toby TikTok 视频任务数据暂未就绪，可能仍在生成/发布中。

> 任务ID：{tobyDagTaskId}

> 你可以告诉我「再查 Toby 结果」，我会立即重新查询。

实现方式

AI 分析：直接在当前对话中用 LLM 完成
HTTP 请求：使用 exec 工具调用 curl（仅 GET 接口；POST submitTask 必须走 submit_task.py）
定时等待：使用 cron(action=add) 设置一次性 systemEvent

依赖

Python 3（系统自带）
仅 Python 标准库（urllib），无第三方依赖

错误处理

DEEPSOP_API_KEY 未设置：提示用户需要 API Key 授权
已有账号 → https://ai.deepsop.com/login?source=5
没有账号 → https://ai.deepsop.com/register?source=5
POST 接口返回非 200：展示错误信息，提示检查参数或稍后重试
TikTok 账号为空：终止任务，提示用户登录 https://ai.deepsop.com 添加 TikTok 授权账号
视频模型列表为空：终止任务，提示用户联系管理员开通视频生成权限
获取账号权限失败：提示用户重新授权该 TikTok 账号
统计/列表接口异常或数据为空：提示视频任务可能仍在生成/发布中，给出 tobyDagTaskId 供用户告知「再查 Toby 结果」
数字员工 Toby 禁用（status=1）：终止任务，提示联系管理员启用
Toby 使用天数耗尽（remainingDays≤0）：进入 Step 1.5.1 签约流程；用户放弃或余额不足则终止
网络请求失败：展示 curl 错误信息

DeepSop TK工作台

概述

TikTok 视频 AI 生成与发布（数字员工 Toby）

功能简介

前置条件：获取 API Key

⛔ 接口路径强约束（最高优先级）

📋 API 路径权威清单（Base URL: `https://ai.deepsop.com/prod-api`）

🛡️ 双轨强约束（本文档 + 代码）

完整执行流程

Step 0：触发类型判断（每次进入技能必须首先执行）

Step 1：AI 分析（任务拆解）

Step 1.5：数字员工 Toby 可用性校验（Step 1 完成后立即执行）

Step 1.5.1：Toby 签约流程（仅规则 2 触发时执行）

Step 2：Toby TikTok 账号与发布参数配置（Step 3 前置）

Step 3：构建并提交任务

Step 3.5：解析用户指定的等待时间

Step 4：按用户指定时间设置自动查询

Step 5：查询结果并返回给用户

实现方式

依赖

错误处理

版本历史

安全检测

腾讯云安全 (Keen)

腾讯云安全 (Sanbu)

🔗 相关推荐

Deepsop Kuaishou 工作台

DeepSop工作台

deepsop-声音克隆助手

DeepSop TK工作台

概述

TikTok 视频 AI 生成与发布（数字员工 Toby）

功能简介

前置条件：获取 API Key

⛔ 接口路径强约束（最高优先级）

📋 API 路径权威清单（Base URL: https://ai.deepsop.com/prod-api）

🛡️ 双轨强约束（本文档 + 代码）

完整执行流程

Step 0：触发类型判断（每次进入技能必须首先执行）

Step 1：AI 分析（任务拆解）

Step 1.5：数字员工 Toby 可用性校验（Step 1 完成后立即执行）

Step 1.5.1：Toby 签约流程（仅规则 2 触发时执行）

Step 2：Toby TikTok 账号与发布参数配置（Step 3 前置）

Step 3：构建并提交任务

Step 3.5：解析用户指定的等待时间

Step 4：按用户指定时间设置自动查询

Step 5：查询结果并返回给用户

实现方式

依赖

错误处理

版本历史

安全检测

腾讯云安全 (Keen)

腾讯云安全 (Sanbu)

🔗 相关推荐

Deepsop Kuaishou 工作台

DeepSop工作台

deepsop-声音克隆助手

📋 API 路径权威清单（Base URL: `https://ai.deepsop.com/prod-api`）