接口说明

已在抖音开放平台设置了小程序的分成比例。设置路径：抖音开放平台 -> 小程序管理后台 -> 运营 -> 推广 -> 小程序推广计划查看详情 -> 推广管理 -> 直播任务管理 -> 新建任务 -> 结算方式：支付分成 -> 支付分成比例。
小程序需要拥有直播达人挂载权限。
接入流程简介：使用文档所述 OpenAPI 前需要在开发者平台上开通任务台相关功能。

使用限制

无。

基本信息

名称	描述
HTTP URL	https://open.douyin.com/api/match/v2/taskbox/add_room_task/
HTTP Method	POST
Scope	match.taskbox.common
权限要求	需要在开发者平台上开通任务台相关功能。任务台

请求参数

请求头

access-token必填String

示例：clt.943da17996fb5cebfbc70c044c3fc25a57T54DcjT6HNKGqnUdxzy1KcxFnZ

调用https://open.douyin.com/oauth/client_token/生成的token

content-type必填String

示例：application/json

固定值"application/json"

Body

content_tag必填String

内容标签，详见本文档末尾说明

form_tag必填String

形态标签，详见本文档末尾说明

refer_ma_captures必填Array<String>

小程序对应页面截图, 0~3张, 宽为312, 高为444, 大小不超过2M

room_title必填String

直播间页面标题

start_page必填String

示例：page/detail/detail?id=1

小程序页面地址, 包含path和query, path不得以/开头

task_desc必填String

任务要求<=500字，条数不限，仅支持纯文本输入，不可包含html标签。

举例：

产品介绍：该产品是一个XX类型的小程序，可以XXX。
达人视频内需添加与小程序页面相关的内容，杜绝生硬植入。
达人视频内容表现积极向上，禁止出现恶俗、违背公序良俗类内容或品牌负面
视频原创，拒绝拼接，搬运，虚假骗互动内容。
注意：任务台的方案只能计算小程序内收入，如果是iOS虚拟支付的，走了小店的那部分无法计费，需要开发者在产品说明中明确写出来如：「请注意：该小程序内iOS端的订单收入不计入分成收入，仅计算安卓端订单收入。」

task_end_time必填Int64

示例：1677697488

任务结束时间, 秒级时间戳

task_icon必填String

尺寸为512*512的当前任务图标，大小不超过200KB，支持PNG,JPG格式
不允许出现留边的情况，图片必须铺满

task_name必填String

任务名称长度：限制在18个字以内
不得包含特殊字符，除[、，、。、！、？、“、”、《、》「、」、]以外
不得包含敏感字符，例如“全网第一”
任务名称请勿包含公司名称！任务标题相同，任务时间重叠，即为重复上传任务，不支持上传
同一个小程序，上传相似标题、相同页面地址的任务，会审核不通过

task_settle_type必填Int32

示例：9

任务结算类型，结算类型包含：2-支付分成、9-直播0元一口价

refer_videosArray<String>

示例视频, 0~5个, 从移动端复制视频链, 正确格式为: https//v.douyin.com/xxxxxxx/ 视频需包含任务对应的小程序锚点！
会校验是否是可以打开的视频，如被删除或其他原因则不展示
会审核视频内容、视频锚点与任务的相关性，低质/无意义/录屏/不含小程序锚点会审核不通过

请求示例
curl --location --request POST 'https://open.douyin.com/api/match/v2/taskbox/add_room_task/' \
--header 'content-type: application/json' \
--header 'access-token: 0801121846735352506a356a6' \
-d '{
  "task_name": "测试的任务名称",
  "task_settle_type": 9,
  "start_page": "page/detail/detail?id=123",
  "task_icon": "https://p3-developer-sign.bytemaimg.com/tos-cn-i-ke512zj2cu/01cefe0ce3c3479d845dcb861ca018b1~tplv-ke512zj2cu-jpg.jpeg?x-expires=1718424829&x-signature=7vw6D8rEUIDZXHAd4veMedSjlLo%3D",
  "room_title": "测试的直播间标题",
  "task_end_time": 1709782399,
  "task_desc": "任务描述: 東門之池，可以漚麻。彼美淑姬，可與晤歌。東門之池，可以漚紵。彼美淑姬，可與晤語。",
  "form_tag": "娱乐测试",
  "content_tag": "漫画",
  "refer_videos": [
    "https://v.douyin.com/SHAfHPu/",
    "https://v.douyin.com/SHASjbd/"
  ],
  "refer_ma_captures": [
    "https://p3-developer-sign.bytemaimg.com/tos-cn-i-ke512zj2cu/1bcfc89de30f4b0fb2000d69f6d36d08~tplv-ke512zj2cu-jpg.jpeg?x-expires=1718424958&x-signature=KA4V5kcK%2FnLtjz5HtfhNz06uce4%3D",
    "https://p6-developer-sign.bytemaimg.com/tos-cn-i-ke512zj2cu/e840d9158f784733a9f0f27bd60ad433~tplv-ke512zj2cu-jpg.jpeg?x-expires=1718425011&x-signature=zltShSxIkbLay7dlA1oR4KwoyPM%3D"
  ]
}
'

响应参数

Body展开全部子属性

err_msg必填String

示例：success

错误信息

err_no必填Int32

示例：0

错误码，0 是成功，其它为异常

log_id必填String

示例：202008121419360101980821035705926A

标识请求的唯一id，在接口异常时用于问题排查

dataStruct

展开子属性

响应示例
正常响应示例异常响应示例
{
  "err_no": 0,
  "err_msg": "SUCCESS",
  "log_id": "202008121419360101980821035705926A",
  "data": {
    "task_id": 720992698146361,
    "task_url": "https://m.zjbyte.net/share/douyin/?token=e32199427d4ebe5b*****3b9a86784ab&share_channel=scan"
  }
}

切换单列布局

错误码

HTTP 状态码	错误码	错误码描述	排查建议
200	0	成功
200	4001015	参数错误	按错误提示进行自查
200	4001010	系统错误	重试仍无法解决时提oncall反馈
200	4001002	未知错误	重试仍无法解决时提oncall反馈
200	4006000	没有设置小程序分佣比例的权限	请前往抖音开放平台->运营->小程序推广->小程序推广计划->直播任务管理, 设置小程序的分佣比例
200	5428	图片解析错误
200	5423	图片格式错误
200	5415	图片超出大小限制
200	5414	图片尺寸不合法
200	5422	处理图片超时
200	5425	非法视频，请检查视频
200	5410	任务名称长度不合法
200	5481	任务名称不得包含特殊字符
200	5482	任务名称不得包含敏感字符
200	5408	锚点标题长度不合法
200	5407	任务图标不能为空
200	5404	任务描述长度不合法
200	5405	任务结束时间必须大于 30 天
200	5483	形态标签或内容标签不合法
200	5406	小程序/小游戏落地页截图数量不合法
200	5439	start_page不合法
200	5403	小程序/小游戏落地页参考视频数量不合法
200	5427	该小程序/小游戏已经达到当天添加任务的次数限制
200	5507	该任务状态为审核中，不允许编辑，请耐心等待审核结果
200	5426	已有审核中/已上架的相同任务, 请勿重复提交。	可自查“任务名称”或“小程序start_page”是否重复
200	5433	小程序未开启任务台 (小程序未入驻)
200	5434	暂无权限
200	5418	找不到对应的小程序
200	5401	app 类型不合法（非小程序）
200	5435	小程序未上线，暂无权限 (小程序已下架)
200	5438	小程序未上线，暂无权限 (小程序未上线)
200	5613	请先开通“直播间达人推广挂载”权限
200	5484	限制任务发布中

形态标签

形态标签共 12 类

图片互动类/声音互动类/游戏化/图像处理类/生成转换类/计算器类/在线应用类/信息查询类/资源获取/测试类/答题类/其他

形态玩法	说明	举例	备注
娱乐测试	最终目的是获取测试结果，例如影音互动测试，答题测试等	AI颜值评分、AI造型屋、录绕口令、录歌、影视测试、王者荣耀答题闯关



游戏	偏游戏互动类型	测手速、华容道、模拟器
AI生成	图片的在线设计&编辑制作；文件、文案、视频的生成或转换	漫画脸制作、表情包制作、证件照生成、名片设计、logo设计、文件格式转换、翻译、足迹生成、对联生成
AI生成	图片的在线设计&编辑制作；文件、文案、视频的生成或转换	漫画脸制作、表情包制作、证件照生成、名片设计、logo设计、文件格式转换、翻译、足迹生成、对联生成
实用工具	实用、娱乐小工具；例如日程表、智能检测、记事本等	BMI计算、保质期计算、倒计时、记事本、日程表、智能检测、投票
实用工具	实用、娱乐小工具；例如日程表、智能检测、记事本等	BMI计算、保质期计算、倒计时、记事本、日程表、智能检测、投票
内容消费	电影档期、娱乐资讯、地址查询等	表情包、小说、影视、相声	注意版权问题
教育培训	泛知识类型	Excel基础入门
其他	其他以上未覆盖类型

内容标签

心理/游戏/影视综/二次元/美食/萌宠/亲子/旅游/时尚/颜值/随拍/音乐/舞蹈/体育/健身/泛知识/居家休闲/科技/财经/汽车/其他。

内容名称	说明
小说	长短篇小说资讯、阅读
漫画	漫画相关资讯、阅读
情感心理	情感、成长、职场技能
游戏	角色扮演、竞技游戏、动作游戏、射击游戏、游戏其他、解说游戏
影视综	影视剪辑、影视解说普通综艺、脱口秀、其他综艺
二次元	二次元衍生、二次元内容、二次元资讯、二次元其他
美食	美食教程、评测、吃播、山野村食、美食知识、美食展示
萌宠	宠物猫、狗、其他动物、宠物资讯
亲子	母婴、儿童、亲子日常
旅游	旅行vlog、旅行攻略、旅行摄影、酒店/民宿测评、导游
颜值时尚	帅哥、美女人物随拍、录屏、生活记录；彩妆、护肤、穿搭、资讯
颜值时尚	帅哥、美女人物随拍、录屏、生活记录；彩妆、护肤、穿搭、资讯
音乐	音乐演唱、西洋乐器、民族乐器、音乐知识
舞蹈	专业舞蹈、手势舞蹈、民族舞、广场舞
体育	竞技体育、水/雪上运动、极限运动、球类项目、体育运动文化
健身	专业健身、生活健身、健身知识
绘画	绘画知识、课程、画展相关信息等等
居家休闲	装修设计、生活窍门、家具家电、园艺花艺、手工diy 魔术、多米诺骨牌类、开箱、玩具、棋牌
科技财经	手机、电脑、电器、科技周边、行业资讯投资理财、金融产品、财经新闻、财经知识、房产、实体经济
汽车	看车、选车、买车、用车、学车、汽车周边
其他	①片场演绎、明星资讯、明星访谈 ②剧情、演绎 ③医疗机构、医疗用品、健康 ④户外打野、赶海、农村生活、农业技术、农业资讯、国外泛三农 ⑤时政新闻、军事、军事

开发者文档

创建直播间任务-v2

接口说明

使用限制

基本信息

请求参数

响应参数

错误码

形态标签

内容标签

创建直播间任务-v2在线调试

接口说明

使用限制

基本信息

请求参数

响应参数

错误码

形态标签

内容标签

创建直播间任务-v2