文档反馈官招募中，报名立赚积分兑换代金券！> HOT
文档中心>API 中心>数据万象>媒体处理>查询 AIGC 音视频元数据标识

查询 AIGC 音视频元数据标识

最近更新时间：2025-08-08 10:20:21

我的收藏

本页目录：

功能描述

AIGC 音视频元数据中包含了内容生产平台标识、内容传播平台标识等信息，您可以通过本接口获取视频、音频中的 AIGC 元数据标识信息。

授权说明

通过子账号使用时，需要在 授权策略 的 action 中添加 cos:GetObject 权限，具体请参见 COS action，数据万象其他权限请参见 数据万象 action。

服务开通

使用该功能需将 存储桶绑定数据万象。
使用该功能需提前通过 控制台 或 接口 开通媒体处理服务。

使用限制

使用该接口时，请先确认相关限制条件。详情请参见 使用限制。
支持获取 MP4、AVI、MKV、FLV、WebM、MOV 格式视频的 AIGC 元数据标识信息。
支持获取 MP3、FLAC、WAV、M4A 格式音频的 AIGC 元数据标识信息。

费用说明

该接口为付费服务，将产生视频元信息费用，详细计费说明可参见 媒体处理费用。

接口示例

请求示例

GET /<ObjectKey>?ci-process=MediaAIGCMetadata HTTP/1.1
Host: <BucketName-APPID>.cos.<Region>.myqcloud.com
Date: <GMT Date>
Authorization: <Auth String>
Content-Length: <length>
注意：
Authorization: 携带鉴权信息，用于验证请求的合法性的请求头，ci-process=MediaAIGCMetadata 请求参数需签入签名信息中，详情请参见 请求签名 文档。

请求头

此接口仅使用公共请求头部，详情请参见 公共请求头部 文档。

请求参数说明

参数
描述
类型
是否必选
ObjectKey
对象文件名，例如 folder/sample.mp4 。
String
是
ci-process
代表数据万象处理操作的参数，查询 AIGC 图片元数据的操作，值固定为 MediaAIGCMetadata 。
String
是

请求体

该请求无请求体。

响应示例

返回的内容为音视频 AIGC 元数据标识信息。
{
    "AIGC": {
        "Label": "1",
        "ContentProducer": "000123",
        "ProduceID": "testProduceId",
        "ReservedCode1": "ewogICAgIm****UiLAp9",
        "ContentPropagator": "000123",
        "PropagateID": "testPropagatorId",
        "ReservedCode2": "ewogICAg*****UyIiwKfQ"
    }
}

响应参数说明

参数
描述
类型
Label
用来标识内容是否属于 AI 生成的。
String
ContentProducer
AI 生产方业务标识，每个业务唯一。
String
ProduceID
AI 生产方提供的，文件标识，每个文件唯一
String
ReservedCode1
生产方提供的，用于防止数据篡改的标识，每个文件唯一。
String
ContentPropagator
内容传播方业务标识，每个业务唯一。
String
PropagateID
内容传播方提供的，文件标识，每个文件唯一。
String
ReservedCode2
内容传播方提供的，用于防止数据篡改的标识，每个文件唯一。
String

错误码

该请求操作无特殊错误信息，常见的错误信息请参见 错误码 文档。

实际案例

请求

GET /for-test.mp4?ci-process=MediaAIGCMetadata HTTP/1.1
Host: examplebucket-1250000000.cos.ap-beijing.myqcloud.com
Date: Fri, 10 Mar 2025 09:45:46 GMT
Authorization: q-sign-algorithm=sha1&q-ak=******&q-key-time=1484213027;32557109027&q-header-list=host&q-url-param-list=acl&q-signature=********
Content-Length: 0

响应

HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 666
Connection: keep-alive
Date: Fri, 10 Mar 2025 09:45:46 GMT
Server: tencent-ci
x-cos-request-id: NTg3NzRiMjV******mNw==

{
    "AIGC": {
        "Label": "1",
        "ContentProducer": "000123",
        "ProduceID": "testProduceId",
        "ReservedCode1": "ewogICAgIm****UiLAp9",
        "ContentPropagator": "000123",
        "PropagateID": "testPropagatorId",
        "ReservedCode2": "ewogICAg*****UyIiwKfQ"
    }
}
中国站
目录