From ae28788597665ac25af5b6e4347a1159e7f392c8 Mon Sep 17 00:00:00 2001 From: Allison Sherrick <67483756+alliomeria@users.noreply.github.com> Date: Fri, 19 Jul 2024 14:28:07 -0400 Subject: [PATCH] Update index.md - Adjust order or rights & requiredStatement - Add more detailed information about the URIs, potential current & potential future machinable, and notes detailed the Example shown --- recipe/0514-ml-usage-tags/index.md | 70 +++++++++++++++--------------- 1 file changed, 35 insertions(+), 35 deletions(-) diff --git a/recipe/0514-ml-usage-tags/index.md b/recipe/0514-ml-usage-tags/index.md index 5c72737e3..861d96e29 100644 --- a/recipe/0514-ml-usage-tags/index.md +++ b/recipe/0514-ml-usage-tags/index.md @@ -13,21 +13,49 @@ 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. +Similar to the initiatives crafted by other communities of practice 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/statements in 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. +Use of these standardized ML/AI Usage tags/statements 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. +Recommendation is to use a single applicable tag/statement, 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 URIs for the different statements. As described in the [IIIF Presentation 3.0 `rights` property](https://iiif.io/api/presentation/3.0/#rights), currently URIs should be sourced from Creative Commons or RightsStatements.org. For URIs that do not reference either of these sources, the [`extensions`](https://iiif.io/api/presentation/3.0/#46-linked-data-context-and-extensions) mechanism using a source found in one of the [IIIF Registry of Known Extensions](https://iiif.io/api/registry/) can also be used. Wikidata is included in the [Profiles Registry](https://iiif.io/api/registry/profiles/). +The examples shown here reference the Wikidata URIs for the different statements. As described in the [IIIF Presentation 3.0 `rights` property](https://iiif.io/api/presentation/3.0/#rights), URIs should be sourced from Creative Commons or RightsStatements.org. For URIs that do not reference either of these sources, the [`extensions`](https://iiif.io/api/presentation/3.0/#46-linked-data-context-and-extensions) mechanism using a source found in one of the [IIIF Registry of Known Extensions](https://iiif.io/api/registry/) can also be used. Wikidata is included in the [Profiles Registry](https://iiif.io/api/registry/profiles/). Please 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. When those stable URIs are finalized, a proposal will be made to add to the [Rights Registry](https://iiif.io/api/registry/rights/). -#### For humans, within [`requiredStatement`](https://iiif.io/api/presentation/3.0/#requiredstatement) +Aside from providing a link reference which typically leads to a static webpage that describes a license/statement in greater detail, a machineable outcome of the usage of Creative Commons or RightsStatement.org URIs within the `rights` property is the display of the corresponding license/statement icon or badge within one of the standard IIIF viewers (as shown in the example below). In the future, there may be ways to extend the machineable outcomes associated with these ML/AI Usage tags/statements (or other `rights` values) in ways that direct responses to machine-mediated interactions. + +#### 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" } +``` + +#### For humans (public display), within [`requiredStatement`](https://iiif.io/api/presentation/3.0/#requiredstatement) ```JSON { @@ -62,36 +90,6 @@ Please see the [goals statement on Stable URIs Development and Maintenance in th } ``` -#### 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) @@ -108,6 +106,8 @@ No known restrictions. ## Example +The [IIIF 3.0 Specs](https://iiif.io/api/presentation/3.0/) restrict `rights` to a single value string format, and `requiredStatement` to a single value JSON Object. The example shown below uses a singe applicable ML/AI Usage statement Wikidata URI in `rights`, paired with a set of two human-readable `value` statements (one for ML/AI usage and one for a standard Creative Commons reference) in `requiredStatement` (structured as a single JSON object). + {% include manifest_links.html manifest="manifest.json" %} {% include jsonviewer.html src="manifest.json" config='data-line="15-28"' %}