如需查看完整的文档索引,请参阅 llms.txt。在文档页面的 URL 末尾加上 .md 即可查看该页面的 Markdown 版本。
主导航
主题

内容溯源

检查图像、音频和 PDF 中是否含有内容溯源信号。

使用内容溯源 API 检查图像、音频文件或 PDF 中是否含有该 API 支持的 OpenAI 溯源信号。将文件发送到 POST /v1/content_provenance_checks,即可在该请求的响应中获取最终验证结果。您可以在内容审核、事实核查、内容标注以及信任与安全工作流程中使用这些信号。

要在浏览器中检查文件,请使用 openai.com/verify 上的网页工具。

有关请求参数和响应模式,请参阅内容溯源 API 参考文档。

如需检查文本,请申请访问权限。目前,只有获批的组织可以使用文本验证功能,其中包括 AI 研究机构和学术机构。OpenAI 会逐一审核申请。

not_detected 表示工具在上传的文件中未找到其支持的信号。即使得到这一结果,内容仍有可能由 OpenAI 生成。例如,文件的元数据可能已被移除或有篡改痕迹,水印可能已减弱,内容也可能由旧版生成模型生成,或生成于溯源信号推出之前。目前,该工具也无法检测其他公司 AI 模型生成的内容,因此 not_detected 同样不能排除这种可能。

内容溯源检查哪些信号

内容溯源 API 会检查支持的文件中是否含有以下信号:

信号 适用对象 检查内容
C2PA 内容凭证 图像和 PDF 经过签名的元数据,其中记录了签发方和 AI 使用情况
SynthID 图像和音频 直接嵌入受支持媒体文件中的水印

C2PA 元数据提供有关文件来源的更多信息。编辑、转换或分享文件时,其元数据可能会丢失。SynthID 水印是图像或音频本身的一部分,文件经过某些变换后仍可能保留水印。

从 ChatGPT 和 Responses API 导出的受支持 PDF 文件内嵌 C2PA 元数据。即使您上传 PDF 后未修改内容就将其重新下载,得到的 PDF 也可能属于这类导出文件。将导出的 PDF 上传到内容溯源 API,即可检查其元数据。

该 API 检查其支持的 OpenAI 信号。它不是通用 AI 检测工具,无法识别所有 AI 系统生成的内容。可见水印和标签与该 API 检查的溯源信号是不同的标识。

验证文件

使用 OpenAI SDK,通过 file 字段发送图像、音频文件或 PDF。SDK 会构建多部分请求,并从 OPENAI_API_KEY 环境变量中读取您的 API 密钥:

验证图像
import { createReadStream } from "node:fs";
import OpenAI, { toStreamingFile } from "openai";

const client = new OpenAI();

const result = await client.contentProvenanceChecks.create({
  file: toStreamingFile(createReadStream("myimage.png"), "myimage.png", {
    type: "image/png",
  }),
});

console.log(result);

请使用以下版本或更高版本的 OpenAI SDK:Python 2.52.0、Go 3.49.0 和 Ruby 0.75.0。

要验证 Opus 音频,请使用同一端点,并将上传文件的媒体类型设为 audio/ogg:

curl https://api.openai.com/v1/content_provenance_checks \
  -H "Authorization: Bearer $OPENAI_API_KEY" \
  -F "file=@./example.opus;type=audio/ogg"

要使用同一命令验证 PDF,请将文件路径替换为您的 PDF 路径,并将 file 部分的媒体类型设为 application/pdf。

响应包含最终验证结果。以下是验证图像时返回的响应示例:

{
  "object": "content_provenance_check",
  "created_at": 1778000000,
  "results": [
    {
      "type": "c2pa",
      "outcome": "detected",
      "validation_state": "trusted",
      "issuer": "OpenAI OpCo, LLC",
      "model": "gpt-image",
      "generated_at": "2026-07-27T18:34:12Z"
    },
    {
      "type": "synthid",
      "outcome": "not_detected",
      "model": null,
      "generated_at": null
    }
  ]
}

object 字段标识响应的类型,created_at 表示创建此次检查的时间,采用以秒为单位的 Unix 时间戳。results 中的条目取决于上传的文件。图像包含 C2PA 和 SynthID 两项检查结果,音频包含一项 SynthID 检查结果,PDF 包含一项 C2PA 检查结果。对于不适用的检查,API 会省略相应条目,而不会返回 not_detected。

API 会在返回响应前完成验证。您无需创建后台任务、轮询其他端点或将文件上传到 Files API。

如果请求失败,请检查 HTTP 状态码。如果响应中包含 error.code,也请检查该字段。如果文件格式有误、不受支持或被阻止,API 会返回 400。如果组织没有访问权限,API 会返回 404。如果请求超过速率限制,API 会返回 429。仅在遇到速率限制或服务器错误等暂时性故障时重试。一般性说明请参阅 API 错误码。

解读验证结果

请分别解读 results 中每个适用的条目。响应中没有顶层 outcome 字段。

C2PA 结果

C2PA 结果描述图像或 PDF 中内容凭证的状态。以下是图像的检查结果示例:

{
  "type": "c2pa",
  "outcome": "detected",
  "validation_state": "trusted",
  "issuer": "OpenAI OpCo, LLC",
  "model": "gpt-image",
  "generated_at": "2026-07-27T18:34:12Z"
}

各字段的含义如下:

  • outcome 表示是否检测到受支持的 OpenAI C2PA 信号。检测到时为 detected,未检测到时为 not_detected。
  • validation_state 表示清单的验证状态,取值为 trusted、valid、invalid 或 not_present。
  • issuer 表示清单的签发方(如有此信息)。
  • model 表示溯源信号中记录的模型(如有此信息)。
  • generated_at 表示内容的生成时间(如有此信息)。

对于图像,结果为 detected 必须同时满足以下条件:清单状态为 trusted 或 valid,清单标明签发方为 OpenAI,并且记录了 AI 生成操作。如果清单由第三方签发、未记录 AI 生成操作、状态为 invalid 或状态为 not_present,则结果为 not_detected。issuer 和 validation_state 仍可能提供清单的相关信息,即使结果为 not_detected。

对于 PDF,只有当文件包含状态为 trusted 的 OpenAI 清单,且清单中含有受支持的溯源信号时,结果才会是 detected。可信清单满足有效清单的要求,并且签名者的证书链可追溯到受认可的信任锚。在 PDF 中检测到信号,表明 OpenAI 工具处理过该文件。仅凭该信号无法确定该工具是否生成或编辑过文件内容,也无法确定生成或编辑的程度。

请勿将状态为 invalid 的清单视为可靠的溯源证据。not_present 表示该文件没有可用的 C2PA 清单。

SynthID 结果

SynthID 结果说明验证工具是否在图像或音频文件中检测到其支持的水印:

{
  "type": "synthid",
  "outcome": "detected",
  "model": null,
  "generated_at": null
}

detected 表示文件含有验证工具能够识别的水印。not_detected 表示验证工具未检测到该水印,仍不能排除内容由 AI 生成或修改的可能。如果有相关信息,model 和 generated_at 分别给出生成内容所用的模型和生成时间。这两个字段均可为 null。

支持上传的文件

默认情况下,API 支持以下文件格式:

  • 图像: PNG、JPEG、WebP 和 GIF。
  • 音频: MP3、Opus、AAC、FLAC、WAV 和 PCM。
  • 文档: PDF。

每个上传文件的大小不得超过 50 MiB。音频解码后的时长不得超过 60 秒。

请设置上传请求中 file 部分的媒体类型。GIF 使用 image/gif,PNG 图像使用 image/png,Opus 音频使用 audio/ogg,PDF 使用 application/pdf。请勿添加单独的 type 字段,也不要手动设置 multipart/form-data 请求头。curl 的 -F 选项会设置请求的内容类型和多部分请求的边界分隔符。每个请求只发送一个文件。

速率限制与零数据保留(ZDR)

在默认速率限制下使用公开的内容溯源 API 验证图像或音频时,符合零数据保留(ZDR)的适用条件。

严格的速率限制有助于防止 API 被滥用。组织可以申请提高速率限制,OpenAI 会逐一审核申请。

使用更高速率限制访问该 API 时,不适用 ZDR。

如果 API 返回 429 rate_limit_exceeded,请降低请求速率。如果响应中包含 Retry-After 响应头,请按其指示的时间重试。有关重试的一般性指导,请参阅速率限制。

负责任地使用验证结果

请将验证结果作为整个审核流程中的一项证据:

  • detected 表明检测到了某个受支持的信号,但不能据此了解文件的完整历史。
  • not_detected 仅表示未检测到相关证据,不能证明内容由人创作,也不能证明生成内容时未使用 OpenAI。
  • 在认定图像或 PDF 来自某家提供商之前,请先检查 C2PA 清单的签发方。
  • 尽可能验证原始文件。压缩、裁剪、截屏、移除元数据和转换格式都可能导致信号消失或减弱。
  • 请考虑生成内容所用的产品和模型,以及文件格式和创建日期。OpenAI 生成的内容并非都含有受支持的信号。
  • 在决策可能产生重大影响的工作流程中,请将自动化决策与人工审核结合使用。
  • 请勿通过反复查询对水印进行逆向工程、移除水印或规避水印检测。
  • 请勿根据验证结果推断提示词、账号或创作者的个人身份。

使用内容溯源 API 须遵守 OpenAI 服务协议。

有关平台整体监控和数据保留设置的信息,请参阅数据控制。