v4

latestOpenAPI 3.0.22026-08-02109239415.7 KB

provenance

Check whether content was created by Ideogram

Checks image content for an Ideogram provenance manifest (C2PA Content Credentials) and returns the disclosure it carries: the provider name, the generating system and its version, the creation time, and the content's unique identifier.

Upload the image to verify as the content part.

This endpoint is public and unauthenticated — no API key is required. Submitted content is analyzed in memory and never stored.

post/v1/provenance/verify

Response

The verification result.

provenance_detectedboolean required

Whether an Ideogram provenance manifest was found in the content.

validation_state'TRUSTED' | 'VALID' | 'INVALID'

Validation outcome for the detected manifest. VALID and TRUSTED both mean the content is unmodified since it was signed; INVALID means the content or its manifest was altered after signing.

providerstring

Name of the provider that created the content.

system_versionstring

Version of the generation system that created the content.

created_atstring

Creation time of the content, as an ISO 8601 timestamp.

generation_idstring

Unique identifier of the generation, as a base64 URL-safe string.

Example response

{
  "validation_state": "TRUSTED",
  "provider": "provider",
  "generation_id": "generation_id",
  "system_version": "system_version",
  "provenance_detected": true,
  "created_at": "created_at"
}