文档中心

证书中心

用户指南

C2PA Manifest 写入规范指导文档

本文定义 C2PA Manifest 的通用写入规范，目标是让签名产物通过 Asset Integrity 与 Asset Conformance 0.2（Spec 2.4）检测，从而具备加入 Conformance Product List 的资格。

必守硬规则：

Actions Assertion 标记 created=true 需紧跟 label，且首个 action 必须是 c2pa.created 或 c2pa.opened 并排在第一位；缺少 created 标记时，action 可能被 SDK 归入 gathered assertions，导致结构不符合 Rubric；

c2pa.opened 必须通过 parameters.ingredientIds 绑定一个 relationship 为 parentOf 的 ingredient（使用 c2patool 时由 -p / --parent 自动生成）；

验证前置：每次写入后使用 C2PA Verify 或 CLI 跑一遍 Rubric，全部通过再交付。

适用范围与前提条件

本规范面向需要在媒体产物（图片 / 视频 / 音频）中写入 C2PA Content Credentials 的服务端开发与接入方，用于统一 Manifest 的字段与结构写法。适用前提：

已使用 c2patool / c2pa-rs 作为写入工具，并使用支持 Spec 2.4 的较新版本（c2pa-rs ≥ 0.80、c2patool ≥ 0.20；本规范以 Spec 2.4 为基线）。

已获得可信签名证书。仅在证书链接入 C2PA Trust List 后，产物才能在严格模式下通过校验；加入 Conformance Product List 是申请对应证书的前置条件。

说明

本规范聚焦 Manifest 的 JSON 结构与字段写法，不覆盖证书申请、签名密钥托管与内容凭证验签的接入细节。

写入场景与 action 的选择

不同来源的内容对应不同的 action 组合与 digitalSourceType。请先按下图判断内容属于哪一类场景，再进入对应最佳实践查看完整写法：

场景	典型内容	对应最佳实践
纯 AI 生成	大模型输出的图片、视频、音频，首次写入 Manifest。	纯 AI 生成内容写入最佳实践
多素材 AI 合成	多段素材经 AI 合成，如 AI 特效视频、多图融合。	多素材 AI 合成写入最佳实践
含 C2PA 内容转码 / 重封装	对已含 C2PA 的输入做非编辑性变更，需保留 provenance。	含 C2PA 内容转码与重封装写入最佳实践

Manifest 通用结构

无论哪种场景，Manifest JSON 都应包含 claim_generator_info 与 assertions 两个基本部分。以下为最小结构骨架：

核心字段说明

字段	说明
claim_generator_info[].name	生成 Manifest 的软件 / 服务名称。必填，用于标识凭证的生成方。
claim_generator_info[].version	生成服务的软件版本号。必填，便于问题追溯与版本对齐。
claim_generator_info[].specVersion	声明本 Manifest 遵循的 C2PA 技术规范版本，是写入 Claim 的元数据，告诉验证方声明符合哪个规范版本。Spec 2.2 起必填，本规范基线取值 2.4.0；取值需与实际使用的写入工具版本匹配（见下方specVersion 与写入工具版本对照）。
assertions[].created	标记该 assertion 为 created assertion（inception）。使用 actions 时必填，且要确保 inception action 位置正确（排在首位）。取值为 true。
actions[].action	声明对内容执行的操作。必填。常用取值： c2pa.created：首次创建 c2pa.opened：打开已含凭证的内容 c2pa.transcoded / c2pa.repackaged / c2pa.edited：转码 / 重封装 / 编辑
actions[].digitalSourceType	IPTC 数字来源类型，声明内容的生成来源。当 action 为 c2pa.created（及 c2pa.edited）时必填，强烈推荐所有创建型 action 都写入。取值见下方 digitalSourceType 取值规范。
data.allActionsIncluded	布尔值，声明本 Manifest 是否包含该资产发生的全部 action。Spec 2.4 基线固定填写 true。

specVersion 与写入工具版本对照

specVersion 的取值必须与实际使用的 c2patool / c2pa-rs 版本能力匹配，否则可能生成不符合目标规范的结构。

C2PA Spec 版本	关键变化	c2pa-rs 最低版本	c2patool 最低版本	说明
1.x（≤1.4）	claim-map v1，扁平 assertions	任意早期版本	≤ 0.12.x	默认行为。
2.0	引入 claim-map-v2，created_assertions / gathered_assertions 分离	~0.44+	0.13.0	首次引入 Claim v2。
2.1	增强隐私特性	~0.50+	≥ 0.15.0	—
2.2	当前正式版（2025 年 5 月发布），本规范基线	~0.59+	≥ 0.19.0	对齐 2.2 spec 校验。
2.4	草案 / 预发布，V2 Claims 默认生成	≥ 0.80+	≥ 0.20.0	推荐使用最新工具时指定。

digitalSourceType 取值规范

digitalSourceType 用 IPTC URI 声明内容来源，是 AI 内容标识与 Conformance 校验的关键字段。按内容实际来源选择对应取值：

短名称	完整 URI	适用场景
trainedAlgorithmicMedia	http://cv.iptc.org/newscodes/digitalsourcetype/trainedAlgorithmicMedia	纯 AI 模型生成的媒体。
compositeWithTrainedAlgorithmicMedia	http://cv.iptc.org/newscodes/digitalsourcetype/compositeWithTrainedAlgorithmicMedia	真实素材 + AI 生成内容混合。
trainedAlgorithmicData	http://c2pa.org/digitalsourcetype/trainedAlgorithmicData	AI 生成的非媒体数据（如 CSV）。
algorithmicMedia	http://cv.iptc.org/newscodes/digitalsourcetype/algorithmicMedia	纯算法生成（非机器学习）。
compositeSynthetic	http://cv.iptc.org/newscodes/digitalsourcetype/compositeSynthetic	含合成元素的混合内容。
digitalCapture	http://cv.iptc.org/newscodes/digitalsourcetype/digitalCapture	数字设备实拍。

Conformance 硬性要求

C2PA Conformance 检测包含多个 Rubric。写入的 Manifest（除证书外）应满足 Asset Conformance 0.2 · Spec 2.4 的全部要求。以下为最常见、必须满足的检查点：

检查点	期望结果
specVersion 存在	claim_generator_info 含 specVersion。
inception action 位置	Actions Assertion 标记 created=true，且首个 action 为 c2pa.created 或 c2pa.opened 并排在第一位。
digitalSourceType 存在	首个 action 含合法的 IPTC digitalSourceType。
allActionsIncluded 存在	actions data 中 allActionsIncluded 为 true，声明本 Manifest 已记录该资产发生的全部 action。
签名证书可信	证书链接至 C2PA Trust List（测试环境可自定义）；需加入 Conformance Product List 才可申请对应证书。
Hard binding 完整	c2pa.hash.data assertion 自动生成且校验通过。

验证方法

写入并签名后，必须先验证再交付。

在线验证

上传签名后的文件到 C2PA Verify，选择全部 Rubrics 后点击 Evaluate selected，确认结果全部通过。当前公司写入的 Manifest（除证书外）应满足所有规范要求。

CLI 本地验证

说明

业务也可上传自己的产物到 C2PA Verify 自助检查是否满足 Rubric 要求，作为提测前的自检手段。