Skip to content
HALOWERK

Bildwerk

camera fingerprint

Photo-response non-uniformity camera identification (Lukáš, Fridrich and Goljan 2006; maximum-likelihood fingerprint and peak-to-correlation energy after Goljan, Fridrich and Filler 2009). No database is used: the caller supplies 2–10 reference photos known to come from one camera, in native resolution. A central square crop (crop_size, at most the short side) of each image is converted to luminance; the noise residual is the image minus a local 3×3 Wiener estimate, with row and column means.

POST https://bild.halowerk.com/v1/camera-fingerprint

Inputs

Fields of the published input schema
FieldTypeRequiredDescription
reference_imagesarrayYesPhotos known to come from one camera, unedited, same stored size (more and flatter images give a better fingerprint; 10+ are recommended in practice).
query_imageobjectYesThe photo to test, in native resolution (may be rotated by 90°).
crop_sizeintegerNoSide of the central square crop that is compared.
Show full input schema
{
  "type": "object",
  "additionalProperties": false,
  "required": [
    "reference_images",
    "query_image"
  ],
  "properties": {
    "reference_images": {
      "type": "array",
      "minItems": 2,
      "maxItems": 10,
      "items": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
          "image_base64": {
            "type": "string",
            "minLength": 16,
            "maxLength": 14000000,
            "description": "Image (JPEG, PNG, WebP, GIF, TIFF, AVIF) as base64 or data: URL, at most 10 MB. Give image_base64 or image_url."
          },
          "image_url": {
            "type": "string",
            "format": "uri",
            "maxLength": 2048,
            "description": "Public http(s) URL of the image (at most 10 MB)."
          }
        }
      },
      "description": "Photos known to come from one camera, unedited, same stored size (more and flatter images give a better fingerprint; 10+ are recommended in practice)."
    },
    "query_image": {
      "type": "object",
      "additionalProperties": false,
      "properties": {
        "image_base64": {
          "type": "string",
          "minLength": 16,
          "maxLength": 14000000,
          "description": "Image (JPEG, PNG, WebP, GIF, TIFF, AVIF) as base64 or data: URL, at most 10 MB. Give image_base64 or image_url."
        },
        "image_url": {
          "type": "string",
          "format": "uri",
          "maxLength": 2048,
          "description": "Public http(s) URL of the image (at most 10 MB)."
        }
      },
      "description": "The photo to test, in native resolution (may be rotated by 90°)."
    },
    "crop_size": {
      "type": "integer",
      "minimum": 64,
      "maximum": 1024,
      "default": 512,
      "description": "Side of the central square crop that is compared."
    }
  }
}

Open original schema

Published input example

{
  "reference_images": [
    {
      "image_base64": "/9j/2wBDAA0JCgsKCA0LCgsODg0PEyAVExISEyccHhcgLikxMC4pLSwzOko+MzZGNywtQFdBRkxOUlNSMj5aYVpQYEpRUk//2wBDAQ4ODhMREyYVFSZPNS01T09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT0//wAARCABAAEADASIAAhEBAxEB/8QAGQAAAwEBAQAAAAAAAAAAAAAAAwQFAgEA/8QAKhAAAgIBAwMCBgMBAAAAAAAAAQIAEQMEEiETMUEFIkJRUmGRoTJxgbH/xAAYAQADAQEAAAAAAAAAAAAAAAADBAUCAf/EACIRAAEEAwACAgMAAAAAAAAAAAEAAgMRBBIhIkEFFBMxcf/aAAwDAQACEQMRAD8AeAv4f1BOqE2VWz9oyBBZqC3YBvuZCjlddKDG54PtL5ETpsQi9j4iNx/IQcbgMD7TEhjPciV8ImjavfHyFsbi8rperM6upauDMshbgeY5pdDu5Ijkrwxi1EGb25I5epl+cwmmbdZl1tImNbMTzuiGhUUhe554u/I5vhoxPsdo8RPKd7e43BPqXcWoJH2EXOYg82DD/XjibYHVhkDmtspzYhXngwGSl+K4I5zUXzO+0kTMPjZJ4sakCynsFFrlbFlTGniRtGjDGruxthdfaNMS1AxPJzo3O1AKLFFfSseo+pAAgGQ21bZX7w/qGlcZRtJZW8mb0Pp5JBIlCKWJkWzfaFmfjYaVtcajuAZ5sONv5Iv4hJyJFxJtVj0UVObTBGILCCz4V6RAIJ47f3HtUBsu+REWa/yIxGzZl2lTjeVXxa07HEmxuQO3HaHGUWOIJe09fMTOLGTZCdEEbeAIrlXa2Xt2FwuLOq+KipaCzFvbtPJMYbEON9JSfAikt1d/pVb/AGe8zABI7zu35mBJpFdIB+kvq2HRPNWQBEkUswr5x7KvUNeBNY8SqpMPDIdaAQfsC+JDK5xttA5/5BdXJ9X6hdWCNQxPmiIAxZ7nWqd31GTIcjbQAGrxKGh0nVy0w7C5P0q3mvwBzK2m1C4WLH6ahYy5yDLsWkNX/9k="
    },
    {
      "image_base64": "/9j/2wBDAA0JCgsKCA0LCgsODg0PEyAVExISEyccHhcgLikxMC4pLSwzOko+MzZGNywtQFdBRkxOUlNSMj5aYVpQYEpRUk//2wBDAQ4ODhMREyYVFSZPNS01T09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT0//wAARCABAAEADASIAAhEBAxEB/8QAGwAAAwADAQEAAAAAAAAAAAAAAwQFAQIGAAf/xAA0EAABAwIEAwINBQAAAAAAAAABAAIDBBEFEiExE0FRMrEGFCIjNEJhcYGSotHhFSQzkcH/xAAaAQADAAMBAAAAAAAAAAAAAAADBAUAAQIG/8QAIBEAAgICAwEAAwAAAAAAAAAAAQIAAxEhBBIxIhMycf/aAAwDAQACEQMRAD8AmE8lswXIWrRco4AABU2x4YsFjFD6W08gD3I2ItkkyCMX3vr7kGhI8Z29Up5zcz7AbICWlHyJrTRCnonlwLwqkTGxM5LQvZD2yBbqUNzpZmh0THuYdi1pITiWPcNwbVAtkzaWXNcBAtrcoraefcxSfKUKaOcaCCX5Cm6qidTq2756JFxRAC5l+lHGH5mNPG3F+z+U47DidBP9H5TkVDljYOLezQL2Uq96wAVMUH5TtjJdPRcB/E4l+VstlipndG9zG2HtVKqYIbNvfmo9Yb1DvggIezZjtG/YtXSubSPIAvp3hL4Ti01LVsBLeC9wDwb2AJFzbqiV/oUnw7wpUfa+Ks8Q4rP9jddS2fJn0F9XT2sJ4vnCwx4kF2ODgdiDcLl23yNzb21XRYQ39hEbde8p+tojy+MtCBgc7h2m3Jb8Sw3IS0dQHuy5cp5a3W+pNl5XRmMCNGR8brJIaoEOJGQaE+0qHNiVSXE5Yyfcfuq/hFEfGITfQsPf+VAmaeIbAq3xKa2qBIjtKr13MTYhNLE6NzWAHewN+9b4dE6oqY4xa5cN9t1gxPNvNuPTyU1hjHtxOlOR38rdx7U6tSqMCF/QFl9l4YNUn14v7P2VihgdT0jIpCC5t7kbb3RllcsQPJJa6y0Ys8nPtnAIcGkncJ2Gsjc7Vkgt1A+6mtGiMXBrbKJx6EsyDHnRT7B+EDmzxskiDiYxr7uf+LnXZidQuhJLigfpTJX3Y/h33FrhWqFWlAsxMAYkmNnMp6hZ57iEeQzqOaYkw2OLtTkjmA2yG57R5EbQ1vQLdluRqHIWtOzR5pzanW63LgBYoMTw5gN9ea883RFrRhoannLb7LGO5//Z"
    }
  ],
  "query_image": {
    "image_base64": "/9j/2wBDAA0JCgsKCA0LCgsODg0PEyAVExISEyccHhcgLikxMC4pLSwzOko+MzZGNywtQFdBRkxOUlNSMj5aYVpQYEpRUk//2wBDAQ4ODhMREyYVFSZPNS01T09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT09PT0//wAARCABAAEADASIAAhEBAxEB/8QAGwAAAwEBAQEBAAAAAAAAAAAAAgMEBQEGAAf/xAAxEAABBAECAwMLBQAAAAAAAAABAAIDEQQhMQUScTNRYRMiMkGBgpGhorHRFBUWQmL/xAAaAQADAAMBAAAAAAAAAAAAAAADBAUAAQYC/8QAJBEAAgICAQQBBQAAAAAAAAAAAQIAAwQREhMhIjEUQVFhwdH/2gAMAwEAAhEDEQA/ANoYUpOpZ8So+N47o8FhJGsg+xW2NlBxqJ0+PHGw1cos1sKKgfMssYLF6sapDynkJGnm1rZABra9PFjRQdmwA1RcdyjIBBBAIIoqghOo0MwDQAk5CfDAyRgc69bTMiAVzsFVuF3G0jb7VTQhwYfMyi2NyQ67/owBiMad3I3Qta0kE6BOduhdqw9Fo1rr1ICXPy9y66SMokxDqmF48UDixwAcCQuRp8bATK1yELrUiIs2hAWgIYT/AE+ZQtx4/W35q0h3EATO+TckRxljQC4Gr2RZmdFiNt5snYBQM4hFPG3ke1t7hzgCnsRuTHU1ZY3TK/c/2Vlxc81sjcAI3E9yCAN5QeYEdUrNyY44JAXtB5TQsdycfWuIi4Ru3aTSZuS0dr9IU37hll1CX6R+FvSQwk15GM+6FyPEx7v9PEPcCmYqU1+TpuOX2WWvsHQk+DLkPAL5L90J+XkCGO71pcL4oS8BzRqdLWFxXKe+wwOPQLzYr5NvGtdD8DUpCtFr23czN4lmvnmLQTvqbWeyZ8b/ADaBB3Rta5zrIOqU8VI7qV09OOmPWEWDRR9Jp/yDLji5eSE16y06/NZuVxjJmd5zY/YD+UiUksNKYCykbalqfkJlh4CfqnpOTgF5SButkKgvoKdj1dckKfUVprLR2ZJU8g/0fuoDbijcS4r4BX0QVJCXNrxEyqo0RRChl7R3UrYy4HcxkYLaRZ8Cs040j3nlo8x070QuG7xysePKSP8ARPilgLUPCMlzQS6NvgSb+y5HwTJedHxfE/hTMp+o3b0IhZctlnFTP//Z"
  },
  "crop_size": 64
}

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 →