DeepSop TK工作台

AI Agent需配置 API Key

TikTok 视频 AI 生成与发布技能（数字员工 Toby）。用户输入自然语言指令，AI 自动拆解任务参数，调用 deepsop 平台接口生成 AI 视频并发布到 TikTok，等待后查询并推送播放/点赞/评论/分享等数据。触发场景：用户说「发 TikTok 视频」「生成视频发布到 TikTok」「抖音国际版发...

任务自动化工作流编排

316

下载量

安装量

收藏量

★ 5.0

综合评分ⓘ

概述

更多信息

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。
配置环境变量：

text

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）1Step 1.5 数字员工可用性GET``/ai/presetEmployee/list1.1Step 1.5.1① 签约套餐列表GET``/ai/setting/list?packageType=31.2Step 1.5.1② 人民币→K币汇率GET``/system/config/configKey/CNY_TO_KCOIN1.3Step 1.5.1③ K币余额查询GET``/ai/vip/balance?userId={userId}1.4Step 1.5.1④ 提交签约（扣K币）POST``/ai/order/purchaseIndependentPackageByKToken1.5Step 1.5.1③ 用户 Profile（取 userId）GET``/ai/user/profile2Step 3 提交任务POST``/ai/presetEmployee/submitTask3Step 3 前置 E-1 TikTok 账号列表GET``/ai/authaccount/list?pageNum=1&pageSize=999&platform=1&status=14Step 3 前置 E-2 TikTok 账号权限GET``/ai/auth/tiktok/getCreatorInfo?authAccountId={id}5Step 3 前置 E-3 视频模型列表POST``/ai/consumeSource/list?pageNum=1&pageSize=9996Step 5-1 视频统计GET``/ai/data/count?taskId={tobyDagTaskId}&customerPoolId={tobyCustomerPoolId}&platform=17Step 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：

text

根据【指令】描述，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：

text

{
  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 币计算：

text

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 请求体：

json

{ "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 条 → 列出并等用户回复「确认」： text

检测到以下 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` 多个时让用户选择隐私级别：

text

请选择该账号的视频隐私设置（回复序号）：

PUBLIC_TO_EVERYONE — 全公开
MUTUAL_FOLLOW_FRIENDS — 互关好友
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` 作为默认提示词，强制询问：

text

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


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

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

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

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

text

请为账号 @{account} 配置发布参数：

每天发布视频数（publishCount，如 3）：
定时发布开始时间（startTime，HH:mm 格式，如 09:30）：
视频发布间隔（publishInterval，分钟，如 60）：


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

* * *

### Step 3：构建并提交任务

> 🧷 **请求体总规约（最高优先级）**
>
> `collaborationSubmitTaskParam` **有且仅有以下 5 个根级键**：
>
> ts
>
> ```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`

**请求头：**

text

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


> 🔒 **强制使用 `submit_task.py` 提交，禁止直接 curl：**
>
> bash
>
> ```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**：
  字段默认值类型说明`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 结构强约束：**
>
> 01. 子对象 key 必须 **`Toby`**，不得 `toby` / `TOBY` / `tobyParam` / `tobyParams`。
> 02. 必须嵌在 `collaborationSubmitTaskParam.employeeParams.Toby` 下。
> 03. **`param` 必须保持嵌套对象**：所有视频生成参数都是 `param` 内部键， **禁止** 提升到 Toby 根部（错例： `Toby.methodType`、 `Toby.text`）。
> 04. `tiktokContent` **不是请求体字段**，其值落到 `Toby.content` 与 `Toby.param.text`，但不得自己再加 `tiktokContent` 键。
> 05. `publishTemplates` 数组每条必填 7 键。
> 06. `accountConfigList` 数组（仅一条）必填 12 键。
> 07. `staffId` 必填，空字符串 `""` 也得给。
> 08. `videoItems` 必填，空数组 `[]` 也得给。
> 09. Toby 根部必填 9 键： `totalTarget` / `incrementalTarget` / `upperLimitTarget` / `content` / `staffId` / `param` / `videoItems` / `publishTemplates` / `accountConfigList`。
> 10. **`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`

> 🔒 **填值硬规则：**
>
> 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 任务请求体示例：**

json

```json
{
  "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 非空）

成功响应：

json

{
  "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 × 60N小时N × 3600半小时1800一刻钟900好 / 默认 / ok / 回车 / 不填480（8分钟）无法识别再询问一次，仍无效则用 480

回复确认：

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

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

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

json

{
  "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：回复结果摘要

text

🎥 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 错误信息

捕获经验教训、错误及修正内容，以实现持续改进。适用于以下场景：（1）命令或操作意外失败；（2）用户纠正Claude（如“不，那不对……”“实际上……”）；（3）用户请求的功能不存在；（4）外部API或工具出现故障；（5）Claude发现自身知识已过时或不正确；（6）针对重复性任务发现了更优方法。同时，在执行重大任务前应回顾已积累的经验教训。

AI Agent

★ 4116↓ 83.7万3 个月前更新

场景驱动+关键词双模式技能发现工具。当用户用自然语言描述场景/需求（如"我想做一个海报""帮我分析股票"），或明确说"安装技能/find skills/找个skill"时，自动从官方内置、本地已安装、SkillHub、虾评、GitHub、ClawHub 六层联合搜索并推荐最合适的技能，支持一键安装。已完全替代官方...

AI Agent

★ 1482↓ 54.5万3 个月前更新

自我反思+自我批评+自我学习+自组织记忆。智能体评估自身工作、发现错误并持续改进。

AI Agent

★ 1402↓ 32.4万3 个月前更新

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.5：解析用户指定的等待时间#

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

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

实现方式#

依赖#

错误处理#

self-improving agent

Find Skills

Self-Improving + Proactive Agent

Agent Browser

Skill Vetter

ontology

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.5：解析用户指定的等待时间#

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

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

实现方式#

依赖#

错误处理#

相关推荐

self-improving agent

Find Skills

Self-Improving + Proactive Agent

Agent Browser

Skill Vetter

ontology

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