为JPEG或PNG文件创建符合C2PA标准的内容凭证签名任务。
接口说明
请求说明
本接口用于为单个 JPEG 或 PNG 文件附加符合 C2PA 标准的内容凭证。
FileUrl必须是服务可以访问的绝对 HTTP 或 HTTPS 地址,并且 URL 路径需以包含扩展名的文件名结尾。当前版本不支持指定
SourceType和SoftwareAgent参数。源文件大小限制为 10MB,超过此限制的任务将失败。
服务仅接受直接返回 HTTP 200 状态码的源地址,不会跟随 3xx 重定向。
成功调用后返回的
TaskId用于后续通过GetC2paSignResult查询任务状态及结果。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| FileUrl |
string |
是 |
待签名 JPEG 或 PNG 文件的绝对 HTTP 或 HTTPS 地址,最多 4096 个字符。 |
https://example.com/images/photo.png?token=xxx |
| SourceType |
string |
否 |
当前版本暂不支持。 |
trainedAlgorithmicMedia |
| SoftwareAgent |
string |
否 |
当前版本暂不支持。 |
Alibaba Cloud Qwen ImageGen |
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
|||
| RequestId |
string |
本次 OpenAPI 调用的请求 ID。 |
A1B2C3D4-E5F6-7890-ABCD-EF1234567890 |
| TaskId |
string |
服务生成的不透明任务 ID,用于调用 GetC2paSignResult。 |
7093c29e-f472-4e1e-91c6-a43df7c7382e |
| Success |
boolean |
表示本次接口调用是否成功。 |
True |
| Message |
string |
附加信息。请求成功时返回 success。 |
success |
| HttpStatusCode |
integer |
HTTP 状态码。请求成功时返回 200。 |
200 |
| Code |
string |
业务错误码。请求成功时返回 OK。 |
OK |
示例
正常返回示例
JSON格式
{
"RequestId": "A1B2C3D4-E5F6-7890-ABCD-EF1234567890",
"TaskId": "7093c29e-f472-4e1e-91c6-a43df7c7382e",
"Success": true,
"Message": "success",
"HttpStatusCode": 200,
"Code": "OK"
}
错误码
访问错误中心查看更多错误码。
变更历史
更多信息,参考变更详情。