小程序
取消
开发
中文
EN
取消
  • 服务端

    • # 剧目提审

    调试诊断

    接口应在服务器端调用，不可在前端（小程序、网页、APP等）直接调用，具体可参考接口调用指南。

    接口英文名：auditDrama

    剧目提交审核

    # 1. 调用方式

    # HTTPS 调用

    POST https://api.weixin.qq.com/wxa/sec/vod/auditdrama?access_token=ACCESS_TOKEN

    # 云调用

    • 本接口不支持云调用。

    # 第三方调用

    • 本接口支持第三方平台代商家调用。

    • 该接口所属的权限集 id 为：153

    • 服务商获得其中之一权限集授权后，可通过使用 authorizer_access_token 代商家进行调用，具体可查看 第三方调用 说明文档。

    # 2. 请求参数

    # 查询参数 Query String Parameters

    参数名类型必填示例说明
    access_tokenstring是ACCESS_TOKEN接口调用凭证，可使用 access_token、authorizer_access_token

    # 请求体 Request Payload

    参数名类型必填说明
    drama_idnumber是剧目id，首次提审不需要填该参数，重新提审时必填
    namestring是剧目名称，首次提审时必填，重新提审时根据是否需要修改选填。
    media_countnumber是剧集数目。首次提审时必填， 重新提审时可不填，如要填写也要和第一次提审时一样。
    media_id_listnumarray是剧集媒资media_id列表。首次提审时必填，而且元素个数必须与media_count一致。重新提审时为可选，如果剧集有内容有变化，可以通过新的列表替换未通过的剧集（推荐使用replace_media_list进行替换，避免顺序和原列表不一致）。
    descriptionstring是剧目简介，可填写200个字符。
    recommendationsstring否剧目推荐语，可填写30个字符。
    cover_material_idstring是剧目海报临时material_id。首次提审时必填，重新提审时根据是否需要修改选填。
    promotion_poster_material_idstring否推广海报临时material_id。
    producerstring是剧目制作方 。首次提审时必填，重新提审时根据是否需要修改选填。
    authorized_material_idstring否不申请版权保护时必填，权利声明/播放授权材料material_id。 需上传《权利声明及不侵权承诺函》 注：(1) 剧目制作方/版权方与账号主体一致时，请上传附件1（需签章）； (2) 剧目制作方/版权方与账号主体不一致时，请上传附件2或完整的播放授权材料（需签章）。
    qualification_typenumber是剧目资质：1-取得《网络剧片发行许可证》或重点节目备案号；2-未取得《网络剧片发行许可证》或重点节目备案，且制作成本小于30万元 注： 1、 （1）剧目资质=1：需上传“网络剧片发行许可证”或“广电备案系统截图”，平台会在视频播放环节展示备案号水印； （2）剧目资质=2：制作成本在30万以内，需上传《成本配置比例情况报告》。剧目经平台审核后由平台下发备案号（备案号仅适用微信小程序平台）并在视频播放环节展示备案号水印。 2、2024年5月27日前发起提审的剧目可支持修改，且同一剧目仅支持修改一次。
    registration_numberstring否剧目备案号，当qualification_type=1时必填。根据提供的剧目资质证明文件填写对应的网络剧片发行许可证编号或剧目备案号。如：(沪)网剧审字(2023)第001号 或 V123456788888888
    qualification_certificate_material_idstring否否 剧目资质证明文件，当qualification_type=1时必填。请提供网络剧片发行许可证或广电备案系统截图。查看截图示例
    cost_commitment_letter_material_idstring否《成本配置比例情况报告》material_id，当qualification_type=2时必填。2026年1月14日00:00起提审需使用新模板。点击下载旧模板，点击下载新模板
    cost_of_productionnumber否剧目制作成本（单位：万元），当qualification_type=2时必填。请填写“1-29” 的整数（如非整数将截断取整），数值需与《成本配置比例情况报告》中对应剧目制作成本一致。
    expeditednumber否填1表示审核加急，0或不填为不加急。每天有5次加急机会。该字段在首次提审时才有效，重新提审时会沿用首次提审时的属性，重新提审不会扣次数。最终是否为加急单，可以根据drama_info_list.expedited属性(1表示审核加急，0或空为非加急审核)判断
    actor_listobject是演员信息，需填写2-5位演员。
    other_material_material_idstring否其他材料material_id，如涉及互动短剧，请上传完整剧情走线示意图。
    replace_media_listobjarray否用于重新提审时替换审核不通过的剧集。
    copyrightobject是版权保护相关。
    drama_typenumber否填1表示为动漫剧目，填2表示为真人剧目（2026年1月14日00:00起必填）
    content_declarednumber否填1表示上传的视频包含AI生成的内容，填0或不填表示上传的视频不包含AI生成的内容

    # Body.actor_list Object Payload

    演员信息，需填写2-5位演员。

    参数名类型必填说明
    actorobjarray是演员列表

    # Body.replace_media_list(Array) Object Payload

    用于重新提审时替换审核不通过的剧集。

    参数名类型必填说明
    oldnumber否旧的剧集media_id
    newnumber否新的剧集media_id

    # Body.copyright Object Payload

    版权保护相关。

    参数名类型必填说明
    copyright_rolenumber是提审主体身份，1. 剧目制作方; 2. 授权播出方或版权方。 number 必填 number 选填。

    2024年12月30日00:00起，apply_for_copyright_protection=1时必填。

    apply_for_copyright_protectionnumber是是否申请版权保护，0. 不申请; 1. 申请。不申请时必须上传权利声明/播放授权材料。
    copyright_verificationstring否版权验证方式：1. 基于版权证明材料; 2. 基于版权授权关系。 （2024年12月30日00:00起，apply_for_copyright_protection=1时必填。）
    proof_of_productionarray否剧目制作证明材料临时 material_id，最多支持上传 4 个。（apply_for_copyright_protection=1时必填。

    2024年12月30日00:00起，apply_for_copyright_protection=1且copyright_verification=2时无需填写。 ）

    purchase_or_broadcast_authorization_certificatearray否版权采买/播出授权证明材料临时 material_id，最多支持上传 4 个。 提审身份非剧目制作方时请上传： 1. 版权采买证明材料 (提审身份为版权方/授权播出方时需提供)； 2. 播出授权材料 (提审身份为授权播出方时需提供) （apply_for_copyright_protection=1时选填。）

    # Body.actor_list.actor(Array) Object Payload

    演员列表

    参数名类型必填说明
    namestring是演员姓名，格式要求：可填写30个字符，支持输入中文、英文和·
    photo_material_idstring是演员照片临时material_id
    rolestring是饰演角色，格式要求：可填写30个字符，支持输入中文、英文及，。；”“？、—《》！（）-·
    profilestring是演员简介，填写内容可参考：生日、星座、籍贯、身高、毕业院校、历史/代表作品、获奖信息、成就等(以上要素需至少满足3项或涵盖任一要素且不少于20字）。 格式要求：可填写100个字符，支持输入中文、英文、阿拉伯数字及，。：；“”？、—《》！（）-·

    # 3. 返回参数

    # 返回体 Response Payload

    参数名类型说明
    errcodenumber错误码
    errmsgstring错误信息
    drama_idnumber剧目id。

    # 4. 注意事项

    1. Content-Type 需要指定为 application/json。
    2. 剧目信息与审核材料在首次提审时为必填，重新提审时根据是否需要修改选填，
    3. 本接口中使用的临时图片material_id可通过新增临时素材接口上传得到，对应临时素材接口中的media_id，本文档中为避免与剧集的media_id混淆，称其为material_id。
    4. 新增临时素材接口可以被小程序调用，调用的小程序账号和剧目提审的小程序账号必须是同一个，否则提交审核时会无法识别素材id。
    5. 为规范微短剧行业健康有序发展，平台将对微短剧剧目提审及备案机制进行调整：2024年5月27日起，针对制作成本在30万元以下的微短剧，开发者需上传《成本配置比例情况报告》，剧目经平台审核后由平台下发备案号（备案号仅适用微信小程序平台）。

    # 5. 代码示例

    # 5.1 首次提审请求数据示例

    请求示例

    {
    "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"
        ]
    }
}

    返回示例

    {
    "errcode": 0,
    "errmsg": "ok",
    "drama_id": 10001
}

    # 5.2 重新提审请求数据示例

    请求示例

    {
    "drama_id": 10001,
    "replace_media_list": [
        {
            "old": 20001,
            "new": 20021
        },
        {
            "old": 20002,
            "new": 20022
        }
    ]
}

    返回示例

    {
    "errcode": 0,
    "errmsg": "ok",
    "drama_id": 10001
}

    # 6. 错误码

    以下是本接口的错误码列表，其他错误码可参考 通用错误码；调用接口遇到报错，可使用官方提供的 API 诊断工具 辅助定位和分析问题。

    错误码错误描述
    -2初始化未完成，请稍后再试
    -1系统错误
    43002HTTP请求必须使用POST方法
    44002POST内容为空
    47001输入格式错误
    47003参数不符合要求
    10090001视频类型不支持
    10090002图片类型不支持
    10090003图片URL无效
    10090005resource_type无效
    10090038被授权账号没有【文娱-微短剧】类目
    10090039已经被解除授权
    10090040剧集已经被占用
    10090041剧目名称不符合规范
    10090042剧集名称不符合规范
    10090043不存在授权关系
    10093011操作失败
    10093014参数错误（包括参数格式、类型等错误）
    10093023操作过于频繁
    10093030资源不存在

    # 7. 适用范围

    本接口暂未明确可调用账号类型，或在业务中根据调用传参自行确定是否可调用，请已实际调用情况为准。