如需完整的文件索引,請參閱 llms.txt。在文件頁面的網址末尾加上 .md ,即可取得該頁面的 Markdown 版本。
主要導覽
主題

內容來源驗證

檢查圖片和音訊是否含有內容來源訊號。

使用內容來源驗證 API,檢查圖片或音訊檔案是否含有此 API 支援的 OpenAI 來源訊號。將檔案傳送至 POST /v1/content_provenance_checks,即可在同一個回應中取得驗證結果。這些訊號可用於內容審查、事實查核、內容標示,以及信任與安全相關工作流程。

若要在瀏覽器中檢查檔案,請使用 openai.com/verify 的線上工具。

如需請求參數和回應結構描述,請參閱內容來源驗證 API 參考文件。

若要檢查文字,請申請存取權。文字驗證目前僅開放給已獲核准的組織,包括 AI 研究機構和學術機構。OpenAI 會逐案審查申請。

not_detected 表示工具在上傳的檔案中未偵測到支援的訊號。如果檔案的中繼資料已遭移除或有竄改跡象、浮水印已弱化、內容出自舊版生成模型,或內容在來源訊號推出前就已建立,即使未偵測到訊號,內容仍可能是由 OpenAI 生成的。目前這項工具也無法偵測其他公司的 AI 模型所生成的內容,因此 not_detected 也無法排除這種可能。

內容來源驗證會檢查哪些訊號?

內容來源驗證會檢查支援的檔案是否含有下列訊號:

訊號 適用檔案 檢查項目
C2PA 內容憑證 圖片 經簽署的中繼資料,包含簽發者及 AI 使用情形的詳細資訊
SynthID 圖片和音訊 直接嵌入支援媒體中的浮水印

C2PA 中繼資料提供更詳細的檔案來源資訊。編輯、轉換或分享檔案時,中繼資料可能會遺失。SynthID 浮水印是圖片或音訊本身的一部分,經過某些轉換後仍可能保留。

此 API 會檢查其支援的 OpenAI 訊號。它並非通用的 AI 偵測工具,無法辨識所有 AI 系統生成的內容。可見的浮水印和標籤與此 API 檢查的來源訊號不同。

驗證檔案

使用 OpenAI SDK,透過 file 欄位傳送圖片或音訊檔案。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"

回應會包含驗證完成後的結果。以下是驗證圖片時的回應範例:

{
  "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 結果。API 會省略不適用的檢查項目,不會為這些項目傳回 not_detected。

API 會在傳回回應前完成驗證。你不需要建立背景作業、輪詢其他端點,或將檔案上傳至 Files API。

如果請求失敗,請檢查 HTTP 狀態碼。如果回應中有 error.code,也請一併檢查。若檔案格式有誤、不受支援或遭封鎖,API 會傳回 400。組織沒有存取權時會收到 404,請求超過速率限制時則會收到 429。只有遇到暫時性錯誤時才應重試,例如觸及速率限制或發生伺服器錯誤。如需一般指引,請參閱 API 錯誤碼。

解讀驗證結果

請分別解讀 results 中的每個適用項目。圖片的結果包含 C2PA 和 SynthID 項目,音訊的結果則包含 SynthID 項目。回應的最上層沒有 outcome 欄位。

C2PA 結果

C2PA 結果說明圖片的內容憑證狀態:

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

各欄位的意義如下:

  • outcome 表示是否偵測到 OpenAI 簽發、用來標示 AI 生成內容的憑證: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 也一樣。

請勿將狀態為 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。

每個上傳的檔案不得超過 50 MiB。音訊解碼後的長度不得超過 60 秒。

請設定上傳請求中 file 部分的媒體類型。GIF 請使用 image/gif,PNG 圖片請使用 image/png,Opus 音訊請使用 audio/ogg。請勿另外新增 type 欄位,也不要手動設定 multipart/form-data 請求標頭。curl 的 -F 選項會設定請求的內容類型,以及分隔各部分的邊界。每個請求只傳送一個檔案。

速率限制

嚴格的速率限制有助於防止 API 遭到濫用。組織可以申請提高速率限制,OpenAI 會逐案審查申請。

如果 API 傳回 429 rate_limit_exceeded,請降低傳送請求的頻率。如果回應包含 Retry-After 標頭,請依照標頭指示的時間重試。如需一般重試指引,請參閱速率限制。

負責任地使用驗證結果

請將驗證結果作為整體審查流程中的一項證據:

  • detected 表示偵測到某個受支援的特定訊號,無法據此得知檔案的完整歷程。
  • not_detected 僅表示未偵測到相關證據,無法證明內容由人類創作,也無法證明內容並非使用 OpenAI 生成。
  • 將圖片歸因於特定供應商前,請先確認 C2PA 憑證的簽發者。
  • 請盡可能驗證原始檔案。壓縮、裁切、擷取螢幕畫面、移除中繼資料和轉換格式都可能使訊號消失或減弱。
  • 請將生成內容所用的產品和模型、檔案格式,以及建立日期一併納入考量。OpenAI 生成的內容不一定含有支援的訊號。
  • 在決策影響重大的工作流程中,請搭配人工審查來進行自動化決策。
  • 請勿透過反覆查詢來逆向分析、移除或規避浮水印。
  • 請勿根據驗證結果推斷所用的提示詞、帳號或個別創作者的身分。

使用內容來源驗證 API 須遵守 OpenAI 服務協議。

如需瞭解適用於整個平台的監控和資料保留設定,請參閱資料控管。