# 剧目提审 > 接口应在服务器端调用，不可在前端（小程序、网页、APP等）直接调用，具体可参考[接口调用指南](/doc/oplatform/developers/dev/guide.md)。 接口英文名：auditDrama 剧目提交审核 ## 1. 调用方式 ### HTTPS 调用 ```bash POST https://api.weixin.qq.com/wxa/sec/vod/auditdrama?access_token=ACCESS_TOKEN ``` ### 云调用 - 本接口不支持云调用。 ### 第三方调用 - 本接口支持第三方平台代商家调用。 - 该接口所属的权限集 id 为：153 - 服务商获得其中之一权限集授权后，可通过使用 [authorizer_access_token](/doc/oplatform/developers/dev/AuthorizerAccessToken.md) 代商家进行调用，具体可查看 [第三方调用](/doc/oplatform/Third-party_Platforms/2.0/Before_Develop/call_interface.md) 说明文档。 ## 2. 请求参数 ### 查询参数 `Query String Parameters` ```json [ { "参数名": "access_token", "类型": "string", "必填": "是", "示例": "ACCESS_TOKEN", "说明": "接口调用凭证，可使用 [access_token](/miniprogram/dev/server/API/mp-access-token/api_getaccesstoken)、[authorizer_access_token](/doc/oplatform/openApi/ticket-token/api_getauthorizeraccesstoken.md)" } ] ``` ### 请求体 `Request Payload` ```json [ { "参数名": "drama_id", "类型": "number", "必填": "是", "说明": "剧目id，首次提审不需要填该参数，重新提审时必填" }, { "参数名": "name", "类型": "string", "必填": "是", "说明": "剧目名称，首次提审时必填，重新提审时根据是否需要修改选填。" }, { "参数名": "media_count", "类型": "number", "必填": "是", "说明": "剧集数目。首次提审时必填， 重新提审时可不填，如要填写也要和第一次提审时一样。" }, { "参数名": "media_id_list", "类型": "numarray", "必填": "是", "说明": "剧集媒资media_id列表。首次提审时必填，而且元素个数必须与media_count一致。重新提审时为可选，如果剧集有内容有变化，可以通过新的列表替换未通过的剧集（推荐使用replace_media_list进行替换，避免顺序和原列表不一致）。" }, { "参数名": "description", "类型": "string", "必填": "是", "说明": "剧目简介，可填写200个字符。" }, { "参数名": "recommendations", "类型": "string", "必填": "否", "说明": "剧目推荐语，可填写30个字符。" }, { "参数名": "cover_material_id", "类型": "string", "必填": "是", "说明": "剧目海报临时material_id。首次提审时必填，重新提审时根据是否需要修改选填。" }, { "参数名": "promotion_poster_material_id", "类型": "string", "必填": "否", "说明": "推广海报临时material_id。" }, { "参数名": "producer", "类型": "string", "必填": "是", "说明": "剧目制作方 。首次提审时必填，重新提审时根据是否需要修改选填。" }, { "参数名": "authorized_material_id", "类型": "string", "必填": "否", "说明": "2026年7月28日12:00起弃用，后续无须上传。\n不申请版权保护时必填，权利声明/播放授权材料material_id。\n需上传[《权利声明及不侵权承诺函》](https://res.wx.qq.com/op_res/0eyDEkj2p1wShKp0275Tc1DmiSk0Qo9QGOhN_M7BXMb-r9GAjD9Lxjq9WQ5nlLiTd4qdl0uPwJPKdk0WyfyrRQ)\n注：(1) 剧目制作方/版权方与账号主体一致时，请上传附件1（需签章）；\n(2) 剧目制作方/版权方与账号主体不一致时，请上传附件2或完整的播放授权材料（需签章）。" }, { "参数名": "qualification_type", "类型": "number", "必填": "是", "说明": "剧目资质：1-取得《网络剧片发行许可证》或重点节目备案号；2-未取得《网络剧片发行许可证》或重点节目备案，且制作成本小于100万元\n注：\n1、\n（1）剧目资质=1：需上传“网络剧片发行许可证”或“广电备案系统截图”，平台会在视频播放环节展示备案号水印；\n（2）剧目资质=2：制作成本在100万以内，需上传《成本配置比例情况报告》。剧目经平台审核后由平台下发备案号（备案号仅适用微信小程序平台）并在视频播放环节展示备案号水印。\n2、2024年5月27日前发起提审的剧目可支持修改，且同一剧目仅支持修改一次。" }, { "参数名": "registration_number", "类型": "string", "必填": "否", "说明": "剧目备案号，当qualification_type=1时必填。根据提供的剧目资质证明文件填写对应的网络剧片发行许可证编号或剧目备案号。如：(沪)网剧审字(2023)第001号 或 V123456788888888" }, { "参数名": "qualification_certificate_material_id", "类型": "string", "必填": "否", "说明": "剧目资质证明文件，当qualification_type=1时必填。请提供网络剧片发行许可证或广电备案系统截图。[查看截图示例](https://res.wx.qq.com/op_res/X9CuqeIgGZSRP_sI5elvBrSySOz_zV_lR3msHDuzL6jU8hDlIBJ4O82XD7VPVSGMgQpMenlGak5DBsvKHjcYZw)" }, { "参数名": "cost_commitment_letter_material_id", "类型": "string", "必填": "否", "说明": "《成本配置比例情况报告》material_id，当qualification_type=2时必填。2026年1月14日00:00起提审需使用新模板。[点击下载旧模板](https://res.wx.qq.com/op_res/8q_kSHE63wbMvg6E5JJMrkIIGJiOOuH5VBccpsz5XxJsHIZQ15KaWbVFUMJskisNEIYnpY6Z9cnrKBp1Fr4pIQ)，[点击下载新模板](https://res.wx.qq.com/op_res/F0TQYnsCpdzIUXDGgP7rHCoeeWYDxu_mRNt3iA6a9BU_J5JchXBQEs_LO-0pxRV_VTbKcVN8Ulz8oO2R0ZrHDw)" }, { "参数名": "cost_of_production", "类型": "number", "必填": "否", "说明": "剧目制作成本（单位：万元），当qualification_type=2时必填。请填写“1-99” 的整数（如非整数将截断取整），数值需与《成本配置比例情况报告》中对应剧目制作成本一致。" }, { "参数名": "expedited", "类型": "number", "必填": "否", "说明": "填1表示审核加急，0或不填为不加急。每天有5次加急机会。该字段在首次提审时才有效，重新提审时会沿用首次提审时的属性，重新提审不会扣次数。最终是否为加急单，可以根据[drama_info_list.expedited](api_listdramas)属性(1表示审核加急，0或空为非加急审核)判断" }, { "参数名": "actor_list", "类型": "object", "必填": "否", "说明": "演员信息，需填写2-5位演员。当drama_type=2时必填，当drama_type=1和3时无需填写。" }, { "参数名": "other_material_material_id", "类型": "string", "必填": "否", "说明": "其他材料material_id，如涉及互动短剧，请上传完整剧情走线示意图。" }, { "参数名": "replace_media_list", "类型": "objarray", "必填": "否", "说明": "用于重新提审时替换审核不通过的剧集。" }, { "参数名": "copyright", "类型": "object", "必填": "是", "说明": "版权保护相关。" }, { "参数名": "drama_type", "类型": "number", "必填": "是", "说明": "剧目类型，1-漫剧；2-真人。新增3-数字真人（2026年4月20日11:00起生效）\n注：\n1.漫剧：指基于漫画、动画或绘图风格制作的剧目，不涉及真人出演。提审流程无需上传对应的演职人员信息。\n2.真人：指由真实演员出演、使用实景拍摄或特效辅助制作的剧目。提审流程需上传对应的演职人员信息。\n3.数字真人：指基于计算机图形技术与人工智能算法生成的、具有逼真人类外观及行为表现的虚拟角色出演的剧目。提审流程无需上传对应的演职人员信息。\n4.漫剧和数字真人均无需填写「actor_list-演员信息」字段" }, { "参数名": "content_declared", "类型": "number", "必填": "否", "说明": "AI内容声明，1-视频包含AI生成的内容；0或不传-视频不包含AI生成的内容" }, { "参数名": "ai_software_ownership_proof", "类型": "string", "必填": "否", "说明": "AI制作证明材料临时 material_id，当content_declared=1时必填。请上传使用AI软件生成内容的证明截图。（2026年7月28日12:00起生效）" }, { "参数名": "other_platform_publication_proof", "类型": "array", "必填": "否", "说明": "其他平台发布证明临时 material_id，最多支持上传4个。如剧目已在抖音/快手等第三方平台发布，请补充上架证明，如作品管理界面截图或版权中心登记截图等。（2026年7月28日12:00起生效）" } ] ``` ### Body.actor_list `Object Payload` 演员信息，需填写2-5位演员。当drama_type=2时必填，当drama_type=1和3时无需填写。 ```json [ { "参数名": "actor", "类型": "objarray", "必填": "是", "说明": "演员列表" } ] ``` "> ### Body.replace_media_list(Array) `Object Payload` 用于重新提审时替换审核不通过的剧集。 ```json [ { "参数名": "old", "类型": "number", "必填": "否", "说明": "旧的剧集media_id" }, { "参数名": "new", "类型": "number", "必填": "否", "说明": "新的剧集media_id" } ] ``` ### Body.copyright `Object Payload` 版权保护相关。 ```json [ { "参数名": "copyright_role", "类型": "number", "必填": "是", "说明": "提审主体身份，1. 剧目制作方; 2. 授权播出方或版权方。" }, { "参数名": "apply_for_copyright_protection", "类型": "number", "必填": "是", "说明": "是否申请版权保护，0. 不申请; 1. 申请。不申请时必须上传权利声明/播放授权材料。\n2026年7月28日12:00起，默认传1且不支持修改。" }, { "参数名": "copyright_verification", "类型": "string", "必填": "是", "说明": "版权验证方式：1. 基于版权证明材料; 2. 基于版权授权关系。\n（2024年12月30日00:00起，apply_for_copyright_protection=1时必填。）" }, { "参数名": "proof_of_production", "类型": "array", "必填": "是", "说明": "剧目制作证明材料临时 material_id，最多支持上传 4 个。（apply_for_copyright_protection=1时必填。\n2024年12月30日00:00起，apply_for_copyright_protection=1且copyright_verification=2时无需填写。\t）\n注：\n剧目类型=真人，需提供以下任一材料：\n1. 剧目制作合同；\n2. 作品登记证书；\n3. 两份或以上主创人员的聘用合同（如：导演合同+主演合同）。\n剧目类型=漫剧/数字真人，支持上述材料，或以下任一材料：\n1. 剧本采买合同；\n2. 后期制作工程文件，如：剪辑、特效图层工程等；\n3. 可信时间戳认证证书。 \n\n2026年7月28日12:00起，作如下调整：\n调整为必填，最多支持上传10个。\n剧目类型=真人，请提供以下任一材料：\n1. 剧目制作合同，需明确作品权利归属，若存在多版权方，请在【制作方名称】处填写完整权利主体名称，主体间以顿号（、）分隔；\n2. 作品登记证书，作品类别需为“视听”；\n3. 两份或以上主创人员的聘用合同（如：导演合同+主演合同）。\n\n剧目类型=漫剧/数字真人，请同时提供以下材料：\n1. 至少4张不同剧集的后期制作展示图，需包含画面、配音、字幕等合理分轨及剪辑点。[查看示例](https://res.wx.qq.com/op_res/rc8d9-GfL_uS_yfyQpVEcTZ6eGxusZFYq1rir38pV9yJtRBPGLfh4ca8k7akUnqV8zKBLQwtVEyGYpf7NwtQnA)\n2. 6选1：\n（1）剧目制作合同，需明确作品权利归属，若存在多版权方，请在【制作方名称】处填写完整权利主体名称，主体间以顿号（、）分隔；\n（2）无AI创作剧目：至少4张剧目内不同角色/场景，对应的原始素材截图/分镜草稿/角色原画/场景原画等；[查看示例](https://res.wx.qq.com/op_res/l5qCkaY_PFe3RrJcpHs35Id2ce1I557R2k8aNtH3bBg26JV6b1rr7Uzav-1q8EnCnX5wCERVzWUFyi9x13nhEQ)\n（3）AI创作剧目：至少4张同剧目内不同主要角色或场景，对应的提示词、操作过程及对应生成结果的截图；[查看示例](https://res.wx.qq.com/op_res/qm5uliWC_qyT7vBGAkN2KgvmnCDa7MvcR3rhLotxcehfVLcMm4LBphDGNWjFDSiyj1aU3s3jhqTwU8CO2m_APg)\n（4）作品登记证书，作品类别需为“视听”；[查看示例](https://res.wx.qq.com/op_res/l5qCkaY_PFe3RrJcpHs35MzbNTOib6Pc-gL7LulARC7zYtgUHPp04iK8YW_-2t8YN52c9n7cIwSLXGc__KlNzA)\n（5）可信时间戳认证证书/作品存证证书，“保护类型/作品类型”需为“视听作品”； [查看示例](https://res.wx.qq.com/op_res/qm5uliWC_qyT7vBGAkN2KmsHBj7uVlAQFoc6cD7lFNoFOU_01LfJvlGSH2aQ1T1ohjDhoHSeglsMgpgN0t3jGA)\n（6）剧本采买/改编/转让合同，需明确基于剧本创作/改编的作品权属。" }, { "参数名": "purchase_or_broadcast_authorization_certificate", "类型": "array", "必填": "否", "说明": "版权采买/播出授权证明材料临时 material_id，最多支持上传 4 个。\n提审身份非剧目制作方时请上传：\n1. 版权采买证明材料 (提审身份为版权方/授权播出方时需提供)；\n2. 播出授权材料 (提审身份为授权播出方时需提供)\n（copyright_verification=1时选填，copyright_verification=2时无需填写。）" } ] ``` "> ### Body.actor_list.actor(Array) `Object Payload` 演员列表 ```json [ { "参数名": "name", "类型": "string", "必填": "是", "说明": "演员姓名，格式要求：可填写30个字符，支持输入中文、英文和·" }, { "参数名": "photo_material_id", "类型": "string", "必填": "是", "说明": "演员照片临时material_id" }, { "参数名": "role", "类型": "string", "必填": "是", "说明": "饰演角色，格式要求：可填写30个字符，支持输入中文、英文及，。；”“？、—《》！（）-·" }, { "参数名": "profile", "类型": "string", "必填": "是", "说明": "演员简介，填写内容可参考：生日、星座、籍贯、身高、毕业院校、历史/代表作品、获奖信息、成就等(以上要素需至少满足3项或涵盖任一要素且不少于20字）。\n格式要求：可填写100个字符，支持输入中文、英文、阿拉伯数字及，。：；“”？、—《》！（）-·" } ] ``` ## 3. 返回参数 ### 返回体 `Response Payload` ```json [ { "参数名": "errcode", "类型": "number", "说明": "错误码" }, { "参数名": "errmsg", "类型": "string", "说明": "错误信息" }, { "参数名": "drama_id", "类型": "number", "说明": "剧目id。" } ] ``` ## 4. 注意事项 1. Content-Type 需要指定为 application/json。 2. 剧目信息与审核材料在首次提审时为必填，重新提审时根据是否需要修改选填， 3. 本接口中使用的临时图片material_id可通过[新增临时素材接口](/miniprogram/dev/server/API/kf-mgnt/kf-message/api_uploadtempmedia)上传得到，对应临时素材接口中的media_id，本文档中为避免与剧集的media_id混淆，称其为material_id。 4. 新增临时素材接口可以被小程序调用，调用的小程序账号和剧目提审的小程序账号必须是同一个，否则提交审核时会无法识别素材id。 5. 为规范微短剧行业健康有序发展，平台将对微短剧剧目提审及备案机制进行调整：**2024年5月27日起，针对制作成本在30万元以下的微短剧（2026年1月14日起制作成本调整为100万元以下），开发者需上传[《成本配置比例情况报告》](https://res.wx.qq.com/op_res/F0TQYnsCpdzIUXDGgP7rHCoeeWYDxu_mRNt3iA6a9BU_J5JchXBQEs_LO-0pxRV_VTbKcVN8Ulz8oO2R0ZrHDw)，剧目经平台审核后由平台下发备案号（备案号仅适用微信小程序平台）。** ## 5. 代码示例 ### 5.1 首次提审请求数据示例 请求示例 ```json { "name": "这是剧名", "media_count": 2, "media_id_list": [ 20001, 20002 ], "producer": "制作方名", "description": "很有意思的一部剧", "cover_material_id": "xxxxxxxxxx", "registration_number": "012345678901234", "authorized_material_id": "122344", "other_material_material_id": "122355", "recommendations": "这是这部剧的推荐语。", "actor_list": { "actor": [ { "name": "演员1", "photo_material_id": "xxxxxxxx", "role": "角色1", "profile": "简介" }, { "name": "演员2", "photo_material_id": "xxxxxxxx", "role": "角色2", "profile": "简介" } ] }, "copyright": { "copyright_role": 2, "apply_for_copyright_protection": 1, "proof_of_production": [ "b45d9b657f80415f8f92d43fe500c9f8" ], "purchase_or_broadcast_authorization_certificate": [ "671b7650084c404e9e70231823ffb7ee", "1fe80a9bbece4531b13e646dc2e170c2" ] } } ``` 返回示例 ```json { "errcode": 0, "errmsg": "ok", "drama_id": 10001 } ``` ### 5.2 重新提审请求数据示例 请求示例 ```json { "drama_id": 10001, "replace_media_list": [ { "old": 20001, "new": 20021 }, { "old": 20002, "new": 20022 } ] } ``` 返回示例 ```json { "errcode": 0, "errmsg": "ok", "drama_id": 10001 } ``` ## 6. 错误码 以下是本接口的错误码列表，其他错误码可参考 [通用错误码](/doc/oplatform/developers/errCode/README.md)；调用接口遇到报错，可使用官方提供的 [API 诊断工具](https://developers.weixin.qq.com/console/devtools/debug?utm_source=api_errcode) 辅助定位和分析问题。 ```json [ { "错误码": "-2", "错误描述": "初始化未完成，请稍后再试" }, { "错误码": "-1", "错误描述": "系统错误" }, { "错误码": "43002", "错误描述": "HTTP请求必须使用POST方法" }, { "错误码": "44002", "错误描述": "POST内容为空" }, { "错误码": "47001", "错误描述": "输入格式错误" }, { "错误码": "47003", "错误描述": "参数不符合要求" }, { "错误码": "10090001", "错误描述": "视频类型不支持" }, { "错误码": "10090002", "错误描述": "图片类型不支持" }, { "错误码": "10090003", "错误描述": "图片URL无效" }, { "错误码": "10090005", "错误描述": "resource_type无效" }, { "错误码": "10090038", "错误描述": "被授权账号没有【文娱-微短剧】类目" }, { "错误码": "10090039", "错误描述": "已经被解除授权" }, { "错误码": "10090040", "错误描述": "剧集已经被占用" }, { "错误码": "10090041", "错误描述": "剧目名称不符合规范" }, { "错误码": "10090042", "错误描述": "剧集名称不符合规范" }, { "错误码": "10090043", "错误描述": "不存在授权关系" }, { "错误码": "10093011", "错误描述": "操作失败" }, { "错误码": "10093014", "错误描述": "参数错误（包括参数格式、类型等错误）" }, { "错误码": "10093023", "错误描述": "操作过于频繁" }, { "错误码": "10093030", "错误描述": "资源不存在" } ] ``` ## 7. 适用范围 本接口暂未明确可调用账号类型，或在业务中根据调用传参自行确定是否可调用，请以实际调用情况为准。 ![](https://res8.wxqcloud.qq.com.cn/wxdoc/56617deb-b17d-4cf1-bccd-71d2c41ccc76.svg)接口变更日志（3条） 2026 年 07 月 21 日提审字段新增「AI权属证明」和「其他平台证明材料」两个字段 2026 年 04 月 13 日剧目类型新增“数字真人” 2026 年 01 月 14 日更新剧目类型字段说明