POST/content_provenance_checks

Create content provenance check

Check whether an image or audio file contains known OpenAI provenance signals. Learn more about content provenance.

If not_detected, it means the tool did not find supported signals in the uploaded file. The content could still have been generated by OpenAI if the metadata was stripped or has evidence of tampering, the watermark was degraded, it comes from a legacy generation model, or it was created before provenance signals were available. Content could also still be AI-generated by another company's model, which the tool currently does not detect.

RetriesRetries up to 2×, 500ms backoff, 30s timeout.

1 body field

filestringrequired

The image or audio file to check for supported OpenAI provenance signals.

2 status codes

200Success

objectstringrequired

The object type. Always `content_provenance_check` for this endpoint.

Allowed:content_provenance_check

created_atintegerrequired

The Unix timestamp, in seconds, when the provenance check was created.

resultsarray<object>required

The provenance results that apply to the uploaded file. Image results include C2PA and SynthID; audio results include SynthID.

429The request was rejected because a rate limit was exceeded.

errorobjectrequired

Error handling

A 429 is returned: The request was rejected because a rate limit was exceeded.

import { Client } from "acme-sdk";

const client = new Client({
  baseUrl: "https://api.acme.com",
  auth: { bearer: process.env.API_TOKEN },
  retry: {
    maxAttempts: 3,
    retryOn: [
      408,
      425,
      429,
      500,
      502,
      503,
      504,
    ],
    backoffMs: 500,
    maxBackoffMs: 8000,
  },
  timeoutMs: 30000,
});

const result = await client.contentProvenanceChecks.create({ file: "example" });

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

Request

Response

Errors