DeepSop TK工作台

API key required

TikTok 视频 AI 生成与发布技能（数字员工 Toby）。用户输入自然语言指令，AI 自动拆解任务参数，调用 deepsop 平台接口生成 AI 视频并发布到 TikTok，等待后查询并推送播放/点赞/评论/分享等数据。触发场景：用户说「发 TikTok 视频」「生成视频发布到 TikTok」「抖音国际版发视频」等与 TikTok 视频生成发布相关的指令；或收到包含 [DeepSOP-AutoQuery-Toby] 标记的系统定时事件（cron 回调）。需要提前配置环境变量 DEEPSOP_API_KEY。⚠️ 调用本 SKILL 前必须先完整阅读 SKILL.md。提交 agentSubmitTask **必须**走 scripts/submit_task.py（通过 heredoc 把 body 喂给 stdin），脚本内部串行跑 validate_employee_params.py + UTF-8 安全 HTTP 提交，**禁止**直接写 curl 命令（会因 Windows cp936 代码页导致 taskName/taskDescription 中文乱码）。脚本退出码 0 才算成功；非 0 必须把 summary/errors 原样回给用户后修正重试，禁止绕过校验或假装成功。

Install

openclaw skills install deepsop-tiktokflow

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，不得做任何形式的改写、简化、猜测或自创。

请求前自检流程：

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

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

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

禁止行为：

❌ 把 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.4	Step 1.5.1④ 提交签约（扣K币）	`POST`	`/ai/order/purchaseIndependentPackageByKToken`
1.5	Step 1.5.1③ 用户 Profile（取 userId）	`GET`	`/ai/user/profile`
2	Step 3 提交任务	`POST`	`/ai/presetEmployee/submitTask`
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}`
5	Step 3 前置 E-3 视频模型列表	`POST`	`/ai/consumeSource/list?pageNum=1&pageSize=999`
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 账号，请确认是否使用（回复「确认」即可）：
1. @{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 个根级键：
{
  "taskName":        String,   // Step 1 的 taskName，非空
  "currentModule":   "content",// 字符串字面量，永远是 "content"
  "executionMode":   1,        // 永远写数字 1
  "employeeParams":  { "Toby": {...} },
  "taskDescription": String    // 用户原始指令，原文透传
}
与其同级必须再带：

completed: true（布尔字面量）

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

硬规则：

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

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

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

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：
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：

字段	默认值	类型	说明
`methodType`	`"3"`	string	视频生成模型，默认 Veo3.1 Fast Lite
`multiShot`	`false`	boolean	是否多镜头（仅 methodType=`"10"` 实际生效）
`generationType`	`"FIRST&LAST"`	string	生成类型；可选值受 methodType 约束
`text`	E-4 提示词	string	视频生成提示词，与 `Toby.content` 相同
`multiPrompt`	`[]`	string[]	多镜头分镜（仅 `shotType="customize"` 时填）
`negativePrompt`	`""`	string	反向提示词
`imageUrlList`	`[]`	string[]	参考图（仅 `generationType` ∈ {REFERENCE,EDIT,FEATURE} 时填）
`firstImageUrl`	`null`	string\|null	首帧图（仅 `generationType="FIRST&LAST"` 时填）
`lastImageUrl`	`null`	string\|null	尾帧图（除 methodType ∈ {auto,1,8,11,12} 外）
`firstClipUrl`	`null`	string\|null	续写/编辑/参考视频（仅 methodType ∈ {10,14}）
`elementList`	`[]`	array	参考主体（仅 methodType=`"10"` 时填）
`videoUrlList`	`[]`	string[]	参考视频（methodType ∈ {9,16,17,18}）
`audioUrl`	`null`	string\|null	参考音频（methodType ∈ {7,8,14,15,16}）
`keepOriginalSound`	`"yes"`	string	保留视频原声（仅 methodType=`"10"` 实际生效）
`durationList`	`[]`	array	多段时长配置
`mode`	`"pro"`	string	生成模式（仅 methodType=`"10"` 实际生效）
`resolution`	`"720p"`	string	分辨率；可选值受 methodType 约束
`ratio`	`"16:9"`	string	画面比例；可选值受 methodType 约束
`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} 生效）
`shotType`	`"single"`	string	镜头模式；可选值受 methodType 约束
`durationSwitch`	`"1"`	string	生成时长模式（methodType ∈ {2,17,18} 生效）
`duration`	`8`（methodType=`"3"`）	number	视频时长（秒）；范围与默认值受 methodType 约束

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 结构强约束：

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

必须嵌在 collaborationSubmitTaskParam.employeeParams.Toby 下。

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

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

publishTemplates 数组每条必填 7 键。

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

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

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

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

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

📐 methodType → 取值约束表：

methodType	模型	`generationType` 可选	`resolution` 可选	`ratio` 可选	`duration`（步长/最小/最大/默认）	`shotType` 可选
`"auto"`	Auto	`FIRST&LAST`	`720p`	`16:9`,`9:16`	由模型自动决定 (键保留默认 `8`)	`single`
`"1"`	Sora2 BetaMax	`TEXT`,`FIRST&LAST`	`720p`	`16:9`,`9:16`	step=5, 10–15, 默认 `10`	`single`
`"2"`	Seedance1.5 Pro	`TEXT`,`FIRST&LAST`	`480p`,`720p`,`1080p`	`adaptive`,`1:1`,`3:4`,`4:3`,`16:9`,`9:16`,`21:9`	step=1, 4–12, 默认 `4`	`single`
`"3"`（默认）	Veo3.1 Fast Lite	`TEXT`,`FIRST&LAST`,`REFERENCE`	`720p`,`1080p`,`4K`	`adaptive`,`16:9`,`9:16`	step=1, 8–8, 默认 `8`（唯一允许 8）	`single`
`"4"`	Veo3.1 Pro Lite	`TEXT`,`FIRST&LAST`	`720p`,`1080p`,`4K`	`adaptive`,`16:9`,`9:16`	step=1, 8–8, 默认 `8`	`single`
`"5"`	Veo3.1 Fast	`TEXT`,`FIRST&LAST`	`720p`,`1080p`,`4K`	`adaptive`,`16:9`,`9:16`	step=2, 4–8, 默认 `4`	`single`
`"6"`	Veo3.1 Pro	`TEXT`,`FIRST&LAST`	`720p`,`1080p`,`4K`	`adaptive`,`16:9`,`9:16`	step=2, 4–8, 默认 `4`	`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`
`"8"`	Wan2.6 i2v	`FIRST&LAST`	`720p`,`1080p`	不传 `ratio`	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`
`"10"`	kling-v3-omni	`TEXT`,`FIRST&LAST`,`REFERENCE`,`EDIT`,`FEATURE`	不传 `resolution`	`1:1`,`16:9`,`9:16`	step=1, 3–15, 默认 `3`	`single`,`multi`,`customize`
`"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`
`"14"`	Wan2.7 i2v	`FIRST&LAST`,`CONTINUATION`	`720p`,`1080p`	不传 `ratio`	step=1, 3–15, 默认 `3`	`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`
`"17"`	Seedance2.0	`TEXT`,`FIRST&LAST`,`REFERENCE`	`480p`,`720p`,`1080p`	`adaptive`,`1:1`,`3:4`,`4:3`,`16:9`,`9:16`,`21:9`	step=1, 4–15, 默认 `4`	`single`
`"18"`	Seedance2.0 Fast	`TEXT`,`FIRST&LAST`,`REFERENCE`	`480p`,`720p`	`adaptive`,`1:1`,`3:4`,`4:3`,`16:9`,`9:16`,`21:9`	step=1, 4–15, 默认 `4`	`single`

🔒 填值硬规则：

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

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

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

字段间依赖：

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 可留空

默认 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 只允许在以下两种情况下执行：

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

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

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工作台

Install

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：查询结果并返回给用户

实现方式

依赖

错误处理

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