使用內容來源驗證 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 服務協議。
如需瞭解適用於整個平台的監控和資料保留設定,請參閱資料控管。