Skip to content
HALOWERK

Bildwerk

ai disclosure metadata

Checks JPEG, PNG and WebP files for AI disclosure metadata: XMP DigitalSourceType and the IPTC Photo Metadata 2025.1 AI fields, C2PA/JUMBF stores (signatures are not validated), PNG text chunks and EXIF Software/UserComment, and returns a status with a recommendation. The set mode writes the Digital Source Type and optional AI fields into the XMP of a JPEG or PNG, leaves the image data untouched and returns the new file. Not legal advice on EU AI Act Art. 50.

POST https://bild.halowerk.com/v1/ai-disclosure-metadata

Inputs

Fields of the published input schema
FieldTypeRequiredDescription
image_base64stringNoThe image (PNG, JPEG, WebP, GIF, TIFF or AVIF) as base64 or data: URL, at most 10 MB decoded. Give either image_base64 or image_url.
image_urlstringNoPublic http(s) URL of the image, fetched once (at most 10 MB). Private and local addresses are refused.
modestringNocheck = read and assess; set = write the disclosure and return the new file.
digital_source_typestringNoFor set: IPTC Digital Source Type code, e.g. trainedAlgorithmicMedia (made with generative AI) or compositeWithTrainedAlgorithmicMedia (edited with generative AI).
ai_systemstringNoFor set: AI system and/or model used (IPTC AI System Used).
ai_system_versionstringNoFor set: version of the AI system (IPTC AI System Version Used).
ai_promptstringNoFor set: prompt information (IPTC AI Prompt Information).
allow_c2pa_invalidationbooleanNoFor set: write even if the file carries a C2PA manifest (changing the file breaks its hash binding).
Show full input schema
{
  "type": "object",
  "additionalProperties": false,
  "properties": {
    "image_base64": {
      "type": "string",
      "minLength": 16,
      "maxLength": 14000000,
      "description": "The image (PNG, JPEG, WebP, GIF, TIFF or AVIF) as base64 or data: URL, at most 10 MB decoded. Give either image_base64 or image_url."
    },
    "image_url": {
      "type": "string",
      "format": "uri",
      "maxLength": 2048,
      "description": "Public http(s) URL of the image, fetched once (at most 10 MB). Private and local addresses are refused."
    },
    "mode": {
      "type": "string",
      "enum": [
        "check",
        "set"
      ],
      "default": "check",
      "description": "check = read and assess; set = write the disclosure and return the new file."
    },
    "digital_source_type": {
      "type": "string",
      "enum": [
        "trainedAlgorithmicMedia",
        "compositeWithTrainedAlgorithmicMedia",
        "compositeSynthetic",
        "algorithmicMedia",
        "algorithmicallyEnhanced",
        "dataDrivenMedia",
        "digitalCapture",
        "computationalCapture",
        "negativeFilm",
        "positiveFilm",
        "print",
        "humanEdits",
        "digitalCreation",
        "screenCapture",
        "virtualRecording",
        "composite",
        "compositeCapture"
      ],
      "description": "For set: IPTC Digital Source Type code, e.g. trainedAlgorithmicMedia (made with generative AI) or compositeWithTrainedAlgorithmicMedia (edited with generative AI)."
    },
    "ai_system": {
      "type": "string",
      "minLength": 1,
      "maxLength": 120,
      "description": "For set: AI system and/or model used (IPTC AI System Used)."
    },
    "ai_system_version": {
      "type": "string",
      "minLength": 1,
      "maxLength": 60,
      "description": "For set: version of the AI system (IPTC AI System Version Used)."
    },
    "ai_prompt": {
      "type": "string",
      "minLength": 1,
      "maxLength": 2000,
      "description": "For set: prompt information (IPTC AI Prompt Information)."
    },
    "allow_c2pa_invalidation": {
      "type": "boolean",
      "default": false,
      "description": "For set: write even if the file carries a C2PA manifest (changing the file breaks its hash binding)."
    }
  }
}

Open original schema

Published input example

{
  "image_base64": "iVBORw0KGgoAAAANSUhEUgAAAEAAAAAwBAMAAABTZWEsAAAAJ1BMVEV6uOjo16j/003jzW9+ueX50lTmzmuIu9eyw6fmzmqzxKWzw6b40VZx3hZPAAAACXBIWXMAAAsTAAALEwEAmpwYAAAAV0lEQVQ4y2NgGLzAyzR4Cz559klKSmoFeBR4KgFBCh4Fi0AKNPAoMAIpUMajIAikQJWQAh1KrNhEyJFuhLzJnkQgoBg8TINbGEbBsAOCBMCoglEFJCkAAMKYNKuC2Gj3AAAAAElFTkSuQmCC",
  "mode": "check"
}

Result & documentation

Machine-readable documentation of this hub

Source of this page: the published HALOWERK catalog. Updated: 2026-11-17 UTC.

More endpoints in this hub

All endpoints in this hub →