Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

0514 ml usage tags #516

Open
wants to merge 17 commits into
base: master
Choose a base branch
from
122 changes: 122 additions & 0 deletions recipe/0514-ml-usage-tags/index.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,122 @@
---
title: IIIF ML/AI Usage Tags Recipe
id:
layout: recipe
tags: [rights, requiredStatement]
summary: "Ethical ML/AI Use Tags for IIIF Manifests"
viewers:
- Mirador
- UV
topic: note
property: rights, requiredStatement
---

## Use Case

Similar to the initiatives crafted by other content communities in efforts to limit the scraping of images and text using “noai” and “noimageai” meta HTML tags, users of the IIIF APIs may consider implementing a set of tags/usage statements their IIIF manifests to help better regulate ML/AI content scraping and non-consented or attributed use of IIIF powered content in ML/AI applications.

## Implementation Notes

Use of these standardized ML/AI Usage tags in IIIF Manifests will always need to be paired with sophisticated, up-to-date DevOps and data security practices within the context of a repository environment.

Recommendation to use a single applicable tag, based on the particular concerns associated with an asset's use in ML/AI applications.

### Using `rights` statement URIs sourced from Wikidata

The examples shown here reference the Wikidata Items URIs for the different statements. As described in the [IIIF Presentation 3.0 `rights` property](https://iiif.io/api/presentation/3.0/#rights) related to `@context` requirements, and using the [Profiles Registry](https://iiif.io/api/registry/profiles/), you need to add the specified Profile URI for the Wikidata items to the `context` property at the beginning of your IIIF Manifest:

```JSON
{
"@context": [
"https://www.wikidata.org/entity/Q115365241",
"http://iiif.io/api/presentation/3/context.json"
]
}
```

Please also see the [goals statement on Stable URIs Development and Maintenance in the Ethical ML/AI Usage Tags Project Repository](https://github.com/alliomeria/ethical_ml_usage_tags/blob/main/README.md#stable-uris-development-and-maintenance) for information about the longer term plans regarding related URIs.

#### For humans, within [`requiredStatement`](https://iiif.io/api/presentation/3.0/#requiredstatement)

```JSON
{
"requiredStatement": {
"label": { "en": [ "No AI" ] },
"value": { "en": [ "Material related to this Digital Object should not be used for AI or ML training datasets." ] }
}
}
```
```JSON
{
"requiredStatement": {
"label": { "en": [ "No Image AI" ] },
"value": { "en": [ "Image-based material related to this Digital Object should not be used for AI or ML training datasets." ] }
}
}
```
```JSON
{
"requiredStatement": {
"label": { "en": [ "Regulated ML/AI Use Permitted - Attribution Required" ] },
"value": { "en": [ "material related to this Digital Object may be used for AI or ML training datasets, as long as Standard Attribution of source Digital Object Title and URL is maintained and referenced publicly for the ML/AI dataset." ] }
}
}
```
```JSON
{
"requiredStatement": {
"label": { "en": [ "Regulated ML/AI Use Permitted - Consent Required" ] },
"value": { "en": [ "Material related to this Digital Object may be used for AI or ML training datasets, if Prior Written Consent is obtained from the Source Holding Institution and Standard Attribution is maintained and referenced publicly." ] }
}
}
```

#### For machines, within [`rights`](https://iiif.io/api/presentation/3.0/#rights)

* No AI
```JSON
{ "rights": "https://www.wikidata.org/wiki/Q127515163" }

```

* No Image AI
```JSON
{ "rights": "https://www.wikidata.org/wiki/Q127516405" }

```

* Regulated ML/AI Use Permitted - Attribution Required
```JSON
{ "rights": "https://www.wikidata.org/wiki/Q127516763" }

```

* Regulated ML/AI Use Permitted - Consent Required
```JSON
{ "rights": "https://www.wikidata.org/wiki/Q127518037" }

```

#### Additional Considerations

* Simple use cases (apply per manifest) versus complex uses casses (apply per item/canvas)

* IIIF is an API based framework, geared to machine mediated interactions but: **IIIF resources are for humans**

* As we, professionally and personally, decide to use or integrate ML/AI tools into our repositories, we need to keep in mind our curatorial legacies and the complex nature of our own content.

* ML/AI technology will continue to shift over time and require diligent application and monitoring, for the rest of our professional lives.

## Restrictions

No known restrictions.

## Example

{% include manifest_links.html manifest="manifest.json" %}

{% include jsonviewer.html src="manifest.json" config='data-line="15-28"' %}

## Related Recipes

* [Rights][0008] for demonstrating use of `rights` and `requiredStatement`
65 changes: 65 additions & 0 deletions recipe/0514-ml-usage-tags/manifest.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,65 @@
{
"@context": "http://iiif.io/api/presentation/3/context.json",
"id": "{{ id.url }}",
"type": "Manifest",
"label": {
"en": [
"Picture of Göttingen taken during the 2019 IIIF Conference"
]
},
"summary": {
"en": [
"<p>Picture taken by the <a href=\"https://github.com/glenrobson\">IIIF Technical Coordinator</a></p>"
]
},
"rights": "https://www.wikidata.org/wiki/Q127518037",

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Cool!

"requiredStatement": {
"label": {
"en": [
"Regulated ML/AI Use Permitted - Consent Required"
]
},
"value": {
"en": [
"Material related to this Digital Object may be used for AI or ML training datasets, if Prior Written Consent is obtained from the Source Holding Institution and Standard Attribution is maintained and referenced publicly.",
"Attribution: <span>Glen Robson, IIIF Technical Coordinator. <a href=\"https://creativecommons.org/licenses/by-sa/3.0\">CC BY-SA 3.0</a> <a href=\"https://creativecommons.org/licenses/by-sa/3.0\" title=\"CC BY-SA 3.0\"><img src=\"https://licensebuttons.net/l/by-sa/3.0/88x31.png\"/></a></span>"
]
}
},
"items": [
{
"id": "{{ id.path }}/canvas/p1",
"type": "Canvas",
"height": 3024,
"width": 4032,
"items": [
{
"id": "{{ id.path }}/page/p1/1",
"type": "AnnotationPage",
"items": [
{
"id": "{{ id.path }}/annotation/p0001-image",
"type": "Annotation",
"motivation": "painting",
"body": {
"id": "https://iiif.io/api/image/3.0/example/reference/918ecd18c2592080851777620de9bcb5-gottingen/full/max/0/default.jpg",
"type": "Image",
"format": "image/jpeg",
"height": 3024,
"width": 4032,
"service": [
{
"id": "https://iiif.io/api/image/3.0/example/reference/918ecd18c2592080851777620de9bcb5-gottingen",
"profile": "level1",
"type": "ImageService3"
}
]
},
"target": "{{ id.path }}/canvas/p1"
}
]
}
]
}
]
}
Loading