# 修改剧目基本信息 > 接口应在服务器端调用，不可在前端（小程序、网页、APP等）直接调用，具体可参考[接口调用指南](/doc/oplatform/developers/dev/guide.md)。 接口英文名：submitModifyDramaBasicInfoReq 该接口用于修改剧目基本信息。请求成功后，需要经过审核，审核通过后，最终才会修改基本信息。审核完成后，会下发通知。 ## 1. 调用方式 ### HTTPS 调用 ```bash POST https://api.weixin.qq.com/wxa/sec/vod/modifydramabasicinfo?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" }, { "参数名": "description", "类型": "string", "必填": "否", "说明": "剧目简介，支持填写200个字符。" }, { "参数名": "cover_material_id", "类型": "string", "必填": "否", "说明": "剧目海报临时material_id。" }, { "参数名": "recommendations", "类型": "string", "必填": "否", "说明": "剧目推荐语。" }, { "参数名": "promotion_poster_material_id", "类型": "string", "必填": "否", "说明": "推广海报临时material_id。" }, { "参数名": "alternate_name", "类型": "string", "必填": "否", "说明": "备用剧名。" }, { "参数名": "actor_list", "类型": "object", "必填": "否", "说明": "演员信息。如果需要修改，请填写所有的演员信息。" }, { "参数名": "qualification_type", "类型": "number", "必填": "否", "说明": "剧目资质：1-取得《网络剧片发行许可证》或重点节目备案号；2-未取得《网络剧片发行许可证》或重点节目备案，且制作成本小于30万元\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_of_production", "类型": "number", "必填": "否", "说明": "剧目制作成本（单位：万元），当qualification_type=2时必填。请填写“1-99” 的整数（如非整数将截断取整），数值需与《成本配置比例情况报告》中对应剧目制作成本一致。" }, { "参数名": "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)" }, { "参数名": "other_material_material_id", "类型": "string", "必填": "否", "说明": "其他材料material_id，如涉及互动短剧，请上传完整剧情走线示意图。" }, { "参数名": "producer", "类型": "string", "必填": "否", "说明": "剧目制作方。apply_for_copyright_protection =1时必填，否则无需填写。" }, { "参数名": "copyright", "类型": "object", "必填": "否", "说明": "版权保护相关。apply_for_copyright_protection =1时必填，否则无需填写 。" } ] ``` ### Body.actor_list `Object Payload` 演员信息。如果需要修改，请填写所有的演员信息。 ```json [ { "参数名": "actor", "类型": "objarray", "必填": "是", "说明": "演员列表" } ] ``` ### Body.copyright `Object Payload` 版权保护相关。apply_for_copyright_protection =1时必填，否则无需填写 。 ```json [ { "参数名": "copyright_role", "类型": "number", "必填": "是", "说明": "提审主体身份，1. 剧目制作方; 2. 授权播出方或版权方。\n2024年12月30日00:00起，apply_for_copyright_protection=1时必填。" }, { "参数名": "apply_for_copyright_protection", "类型": "number", "必填": "是", "说明": "是否申请版权保护，0. 不申请; 1. 申请。不申请时必须上传权利声明/播放授权材料。\n\n2026年7月28日0:00起，存量apply_for_copyright_protection=0的剧目提交修改时默认传1且不支持修改，同时需按要求补充copyright_verification及对应字段。" }, { "参数名": "copyright_verification", "类型": "string", "必填": "否", "说明": "版权验证方式：1. 基于版权证明材料; 2. 基于版权授权关系。\n（2024年12月30日00:00起，apply_for_copyright_protection=1时必填。）" }, { "参数名": "proof_of_production", "类型": "array", "必填": "否", "说明": "剧目制作证明材料临时 material_id，apply_for_copyright_protection=1时必填，最多支持上传10个。\n2026年7月28日0:00起，存量apply_for_copyright_protection=0的剧目提交修改时需补充。" }, { "参数名": "purchase_or_broadcast_authorization_certificate", "类型": "array", "必填": "否", "说明": "版权采买/播出授权证明材料临时 material_id，最多支持上传 4 个。\n提审身份非剧目制作方时请上传：\n1. 版权采买证明材料 (提审身份为版权方/授权播出方时需提供)；\n2. 播出授权材料 (提审身份为授权播出方时需提供)\n（apply_for_copyright_protection=1时选填。）" } ] ``` "> ### 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", "示例": "ok", "说明": "错误信息" } ] ``` ## 4. 注意事项 1. 剧目必须已经审核通过。 2. 审核完成后会发送[事件通知](/miniprogram/dev/server/event_push/mini_drama/drama_review_status_event) 3. 本接口中使用的临时图片material_id可通过[新增临时素材接口](/miniprogram/dev/server/API/kf-mgnt/kf-message/api_uploadtempmedia)上传得到，对应临时素材接口中的media_id，本文档中为避免与剧集的media_id混淆，称其为material_id。 ## 5. 代码示例 请求示例 ```json { "drama_id": 10001, "description": "新剧目简介", "cover_material_id": "新剧目海报临时material_id", "recommendations": "新剧目推荐语", "promotion_poster_material_id": "新推广海报临时material_id", "alternate_name": "备用剧名", "actor_list": { "actor": [{ "name": "演员1", "photo_material_id": "xxxxxxxx", "role": "角色1", "profile": "简介" }, { "name": "演员2", "photo_material_id": "xxxxxxxx", "role": "角色2", "profile": "简介" }] }, "qualification_type": 1, "qualification_certificate_material_id": "xxxxxxxx", "registration_number":"V123456788888888", "other_material_material_id":"新其他材料临时material_id" } ``` 返回示例 ```json { "errcode": 0, "errmsg": "ok" } ``` ## 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)接口变更日志（1条） 2026 年 01 月 13 日更新制作成本金额