C2PA 实例签名

使用说明

C2PA 证书的私钥由云端 HSM 托管，不支持导出。所有签名操作均通过本接口在云端完成。

本接口要求调用方在本地先对待签名的原始内容计算摘要（Hash），再将摘要 Base64 编码后作为 Message 传入。

请求的 C2PA 证书实例必须处于已签发状态，且未过期、未吊销、未欠费。

注意事项

请求频率：同一个租户每秒最多允许请求 20 次。

请求说明

请求方法：POST

接入地址：pca.volcengineapi.com

API 版本：2025-10-01

调试

API Explorer

您可以通过 API Explorer 在线发起调用，无需关注签名生成过程，快速获取调用结果。

去调试

请求参数

下方仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共参数。

Query

Action string 必选示例值：C2PASign

要执行的操作，取值：C2PASign。

Version string 必选示例值：2025-10-01

API的版本，取值：2025-10-01。

Body

InstanceId string 必选示例值：c2pa-cert-b7eb5c7094cc4e89ac806802361****

C2PA 证书实例 ID。实例需处于已签发状态。您可以调用 ListC2PAInstances 查询实例 ID。

MessageType string 必选示例值：DIGEST

消息类型。目前固定取值：DIGEST，表示 Message 为内容摘要。

Message string 必选示例值：vSsar3708Jvp9Szi2NWZZ02Bqp1q****

Base64 编码后的待签名摘要。摘要长度需与 SigningAlgorithm 对应的哈希算法一致：SHA-256 为 32 字节、SHA-384 为 48 字节、SHA-512 为 64 字节。

SigningAlgorithm string 必选示例值：RSASSA_PSS_SHA_256

签名算法。取值：

RSASSA_PSS_SHA_256

RSASSA_PSS_SHA_384

RSASSA_PSS_SHA_512

RSASSA_PKCS1_V1_5_SHA_256

RSASSA_PKCS1_V1_5_SHA_384

RSASSA_PKCS1_V1_5_SHA_512

ECDSA_SHA_256

ECDSA_SHA_384

ECDSA_SHA_512

ED25519_SHA_512

返回参数

下方仅列出本接口特有的返回参数。更多信息请参见返回结构。

InstanceId string 示例值：c2pa-cert-b7eb5c7094cc4e89ac806802361e****

C2PA 证书实例 ID。

Signature string 示例值：2hwgC/f0lbbo4/N5lXS595Cl****

Base64 编码后的签名值。

SigningAlgorithm string 示例值：RSASSA_PSS_SHA_256

本次签名实际使用的签名算法。

请求示例

返回示例

错误码

下表为您列举了该接口与业务逻辑相关的错误码。公共错误码请参见公共错误码文档。

状态码	错误码	错误信息	说明
400	MalformedRequest	The request is malformed.	请求格式错误。
400	MissingParameter.InstanceId	The required parameter InstanceId is missing.	未提供必填参数 InstanceId。
400	InvalidParameter.InstanceId	InstanceId format is invalid.	InstanceId 不合法。
400	MissingParameter.MessageType	The required parameter MessageType is missing.	未提供必填参数 MessageType。
400	InvalidParameter.MessageType	MessageType is invalid.	MessageType 无效，当前仅支持 DIGEST。
400	MissingParameter.Message	The required parameter Message is missing.	未提供必填参数 Message。
400	InvalidParameter.Message	Message is too large.	Message 长度不合法。
400	InvalidParameter.SigningAlgorithm	The signing algorithm is invalid.	SigningAlgorithm 不在接口支持的签名算法列表中。
400	InvalidParameter.DigestSize	The message digest size is invalid.	Message 的摘要长度与 SigningAlgorithm 不匹配。
400	InstanceCertificateNotIssued	The certificate has not been issued.	实例证书未签发。
400	InstanceCertificateExpired	The certificate has expired.	实例证书已超过有效期，无法继续用于签名。
400	InstanceCertificateRevoked	The certificate has been revoked.	实例证书已被吊销，无法继续用于签名。
400	InstanceOverdue	The instance is overdue.	实例已欠费，无法继续用于签名。
400	InvalidParameter.KeyAlgoSigningAlgoNotMatch	The key algorithm does not match the signing algorithm.	实例密钥算法与请求中的 SigningAlgorithm 不匹配。
404	InstanceNotFound	Instance not found.	当前账号下不存在指定的 InstanceId。
500	InternalError	The request failed due to an internal error.	服务内部错误。

证书中心