C2PA Trust Label & AI Image Detector

LICENSE

Analyze images for C2PA content credentials to detect AI-generated content and verify authenticity. This Actor checks images for embedded metadata that proves their origin and creation method.

🎯 What This Actor Does

This Actor analyzes images to determine:

• ✅ Whether the image contains C2PA (Content Provenance and Authenticity) metadata
• 🤖 If the image was AI-generated (Firefly, DALL-E, Midjourney, etc.)
• 📸 If the image was captured by a verified camera
• 🔒 The authenticity and trustworthiness of the image

🚀 Quick Start

Input

Choose ONE of the following input methods:

1. Image URL - Analyze an image from a public URL
2. Key-Value Store - Analyze an image stored in Apify storage
3. Base64 String - Analyze Base64-encoded image data

Example Input

{
  "imageUrl": "https://example.com/photo.jpg"
}

Or using Key-Value Store:

{
  "kvsRecordKey": "my-image",
  "storeId": "HzkIFDV9Ktd2wJQI7"
}

Example Output

{
  "trust_label": "AI-Generated",
  "is_ai": true,
  "score": 20,
  "confidence": "high",
  "status": "Success",
  "source": "URL: https://example.com/photo.jpg",
  "has_c2pa_metadata": true,
  "generator": "Adobe Firefly"
}

📋 Features

✨ Core Capabilities

• C2PA Metadata Detection - Reads embedded content credentials
• AI Detection - Identifies AI-generated images from major tools
• Multi-Format Support - Works with JPEG, PNG, WebP, and GIF
• Trust Scoring - Assigns confidence scores (0-100)
• Detailed Reports - Optional verbose output with full manifests

🔍 Supported AI Tools

The Actor can detect images generated by:

• Adobe Firefly
• OpenAI DALL-E
• Midjourney
• Stable Diffusion
• Microsoft Designer/Bing Create
• And more...

📖 Input Parameters

Parameter	Type	Required	Description
imageUrl	String	No*	URL of the image to analyze
kvsRecordKey	String	No*	Key name in Apify Key-Value Store
storeId	String	No	Store ID (optional, for named stores)
imageBase64	String	No*	Base64-encoded image data
outputFormat	String	No	Output detail level: simple or detailed (default: simple)
debugMode	Boolean	No	Enable detailed logging (default: false)

*At least one input method must be provided.

📤 Output Fields

Simple Format (Default)

{
  "trust_label": "AI-Generated" | "Verified Camera Capture" | "No Credentials Found",
  "is_ai": true | false,
  "score": 0-100,
  "confidence": "low" | "medium" | "high",
  "status": "Success" | "Error",
  "source": "Description of input source",
  "has_c2pa_metadata": true | false,
  "generator": "Tool name or Unknown"
}

Detailed Format

When outputFormat: "detailed" is set, output includes:

{
  "manifest_summary": {
    "title": "Image title",
    "format": "image/jpeg",
    "instance_id": "unique-id",
    "detected_ai_keywords": ["firefly", "generative"]
  }
}

🔧 Usage Examples

Example 1: Analyze from URL

{
  "imageUrl": "https://contentcredentials.org/examples/sample.jpg",
  "outputFormat": "simple"
}

Example 2: Analyze from Storage

{
  "kvsRecordKey": "uploaded-image",
  "storeId": "your-store-id-here"
}

Example 3: Detailed Analysis with Debug

{
  "imageUrl": "https://example.com/photo.jpg",
  "outputFormat": "detailed",
  "debugMode": true
}

Example 4: Base64 Input

{
  "imageBase64": "data:image/jpeg;base64,/9j/4AAQSkZJRg..."
}

💡 Understanding the Results

Trust Labels

Label	Meaning	Score Range
Verified Camera Capture	Image has C2PA credentials from a verified camera	100
AI-Generated	Image was created by AI tools with C2PA support	20
No Credentials Found	Image has no C2PA metadata embedded	0

Confidence Levels

• High - Multiple AI indicators found or strong camera credentials
• Medium - Single AI indicator detected
• Low - No C2PA metadata present

⚠️ Important Notes

About C2PA Detection

This Actor only detects C2PA metadata embedded in images. Important limitations:

• ❌ Most AI images don't have C2PA - Tools like ChatGPT, most Stable Diffusion implementations, and older AI tools don't embed credentials
• ✅ Works best with: Adobe Firefly, Microsoft Designer, Leica cameras (M11-P and newer)
• ⚠️ Metadata can be stripped during editing, social media uploads, or screenshots

When No Credentials Are Found

If you get "trust_label": "No Credentials Found", it means:

1. The image predates C2PA adoption
2. The tool doesn't support C2PA
3. Metadata was removed during processing
4. The image is a screenshot or edited version

This doesn't mean the image is authentic - it just means there's no embedded proof of origin.

🧪 Testing the Actor

Get Test Images with C2PA

To test with images that definitely have C2PA metadata:

1. Adobe Firefly - Generate free images at firefly.adobe.com
2. Content Credentials - Download samples from contentcredentials.org/verify
3. Bing Image Creator - Create images at bing.com/create

Sample Test Run

$apify run -i '{"imageUrl": "https://contentcredentials.org/examples/sample.jpg"}'

💰 Pricing

• $0.02 per image analyzed
• Pay only for successful analyses

🔒 Privacy & Security

• Images are processed in-memory only
• No images are stored or logged
• Metadata analysis is read-only
• Complies with Apify security standards

🛠️ Technical Details

Supported Formats

• JPEG (.jpg, .jpeg)
• PNG (.png)
• WebP (.webp)
• GIF (.gif)

Image Size Limits

• Maximum file size: 10MB (recommended)
• Larger files may timeout

Dependencies

• c2pa-python - C2PA SDK for metadata reading
• requests - HTTP client for URL downloads
• apify - Apify Actor SDK

📚 Learn More About C2PA

• C2PA Official Website
• Content Credentials
• Coalition for Content Provenance and Authenticity

🐛 Troubleshooting

"Key not found in Key-Value Store"

• Verify the key name exactly matches your uploaded file
• Check that you're using the correct Store ID

"Unknown image format"

• Ensure the image is a valid JPEG, PNG, WebP, or GIF
• Try re-downloading the image and uploading again

"No C2PA metadata found"

• This is normal for most images - see "About C2PA Detection" above
• Try testing with a known C2PA image from Adobe Firefly

💬 Support

Need help?

• Check the Apify documentation
• Visit C2PA documentation
• Report issues in the Actor's feedback section

📄 License

Apache 2.0

---

Built with ❤️ for content authenticity and transparency