OpenAI 创建内容来源检查

创建内容来源检查

post /content_provenance_checks

检查图像或音频文件是否含有已知的 OpenAI 来源信号。参阅内容来源指南。

返回 not_detected 表示工具未在上传文件中找到其支持的信号。如果元数据已被移除或有篡改痕迹、水印质量下降、内容来自早期生成模型，或生成时间早于来源信号的引入时间，内容仍可能由 OpenAI 生成。内容也可能由其他公司的模型生成，工具目前无法检测这些来源。

请求体参数

内容类型为 multipart/form-data。

• file: string

用于检查受支持 OpenAI 来源信号的图像或音频文件。支持的图像格式为 PNG、JPEG、WebP 和 GIF，包括动态 GIF。

返回值

• ContentProvenanceCheck object { created_at, object, results }

• created_at: integer

来源检查创建时间，采用 Unix 时间戳，单位为秒。

format: unixtime

• object: "content_provenance_check"

对象类型，此接口固定返回 content_provenance_check。

• "content_provenance_check"

• results: array of C2PA { generated_at, issuer, model, 3 more } or SynthID { generated_at, model, outcome, type }

适用于上传文件的来源检查结果。图像结果包含 C2PA 和 SynthID，音频结果包含 SynthID。

• C2PA object { generated_at, issuer, model, 3 more }

• generated_at: string or null

来源信号记录的素材生成时间（如有），采用 UTC 时区的 RFC 3339 时间戳。

• issuer: string or null

C2PA 清单的签发者（如有）。

• model: string or null

来源信号记录的 OpenAI 模型（如有）。

• outcome: "detected" or "not_detected"

是否检测到受支持的 OpenAI C2PA 来源信号。 返回 not_detected 表示工具未在上传文件中找到其支持的信号。如果元数据已被移除或有篡改痕迹、水印质量下降、内容来自早期生成模型，或生成时间早于来源信号的引入时间，内容仍可能由 OpenAI 生成。内容也可能由其他公司的模型生成，工具目前无法检测这些来源。

• "detected"

• "not_detected"

• type: "c2pa" (default: "c2pa")

来源信号类型，固定为 c2pa。

• "c2pa"

• validation_state: "trusted" or "valid" or "invalid" or "not_present"

上传图像中 C2PA 清单的验证状态。

• "trusted"

• "valid"

• "invalid"

• "not_present"

• SynthID object { generated_at, model, outcome, type }

• generated_at: string or null

来源信号记录的素材生成时间（如有），采用 UTC 时区的 RFC 3339 时间戳。

• model: string or null

来源信号记录的 OpenAI 模型（如有）。

• outcome: "detected" or "not_detected"

是否检测到受支持的 OpenAI SynthID 水印。 返回 not_detected 表示工具未在上传文件中找到其支持的信号。如果元数据已被移除或有篡改痕迹、水印质量下降、内容来自早期生成模型，或生成时间早于来源信号的引入时间，内容仍可能由 OpenAI 生成。内容也可能由其他公司的模型生成，工具目前无法检测这些来源。

• "detected"

• "not_detected"

• type: "synthid" (default: "synthid")

来源信号类型，固定为 synthid。

• "synthid"

请求示例

## 先设置 OPENAI_API_KEY，并替换文件路径或资源 ID 后再运行。
curl https://api.openai.com/v1/content_provenance_checks \
    -H 'Content-Type: multipart/form-data' \
    -H "Authorization: Bearer $OPENAI_API_KEY" \
    -F 'file=@/path/to/file'

200 响应示例

{
  "created_at": 0,
  "object": "content_provenance_check",
  "results": [
    {
      "generated_at": "generated_at",
      "issuer": "issuer",
      "model": "model",
      "outcome": "detected",
      "type": "c2pa",
      "validation_state": "trusted"
    }
  ]
}