Update ImagenPersonFilterLevel refdocs to match the iOS SDK #6995
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Javadoc Changes:--- /home/runner/diff/original/firebase-kotlindoc/android/com/google/firebase/ai/type/ImagenPersonFilterLevel.html 2025-05-27 16:20:15.066206449 +0000
+++ /home/runner/diff/modified/firebase-kotlindoc/android/com/google/firebase/ai/type/ImagenPersonFilterLevel.html 2025-05-27 16:16:54.032005554 +0000
@@ -49,21 +49,21 @@
<td><code>static final @<a href="https://developer.android.com/reference/kotlin/androidx/annotation/NonNull.html">NonNull</a> <a href="/docs/reference/android/com/google/firebase/ai/type/ImagenPersonFilterLevel.html">ImagenPersonFilterLevel</a></code></td>
<td>
<div><code><a href="/docs/reference/android/com/google/firebase/ai/type/ImagenPersonFilterLevel.Companion.html#ALLOW_ADULT()">ALLOW_ADULT</a></code></div>
- <p>Filters out any images containing depictions of children.</p>
+ <p>Allow generation of images containing adults only; images of children are filtered out.</p>
</td>
</tr>
<tr>
<td><code>static final @<a href="https://developer.android.com/reference/kotlin/androidx/annotation/NonNull.html">NonNull</a> <a href="/docs/reference/android/com/google/firebase/ai/type/ImagenPersonFilterLevel.html">ImagenPersonFilterLevel</a></code></td>
<td>
<div><code><a href="/docs/reference/android/com/google/firebase/ai/type/ImagenPersonFilterLevel.Companion.html#ALLOW_ALL()">ALLOW_ALL</a></code></div>
- <p>No filters applied.</p>
+ <p>Allow generation of images containing people of all ages.</p>
</td>
</tr>
<tr>
<td><code>static final @<a href="https://developer.android.com/reference/kotlin/androidx/annotation/NonNull.html">NonNull</a> <a href="/docs/reference/android/com/google/firebase/ai/type/ImagenPersonFilterLevel.html">ImagenPersonFilterLevel</a></code></td>
<td>
<div><code><a href="/docs/reference/android/com/google/firebase/ai/type/ImagenPersonFilterLevel.Companion.html#BLOCK_ALL()">BLOCK_ALL</a></code></div>
- <p>Filters out any images containing depictions of people.</p>
+ <p>Disallow generation of images containing people or faces; images of people are filtered out.</p>
</td>
</tr>
</tbody>
@@ -74,17 +74,23 @@
<div class="api-item"><a name="getALLOW_ADULT()"></a><a name="setALLOW_ADULT()"></a><a name="getALLOW_ADULT--"></a><a name="setALLOW_ADULT--"></a>
<h3 class="api-name" id="ALLOW_ADULT()">ALLOW_ADULT</h3>
<pre class="api-signature no-pretty-print">public static final @<a href="https://developer.android.com/reference/kotlin/androidx/annotation/NonNull.html">NonNull</a> <a href="/docs/reference/android/com/google/firebase/ai/type/ImagenPersonFilterLevel.html">ImagenPersonFilterLevel</a> <a href="/docs/reference/android/com/google/firebase/ai/type/ImagenPersonFilterLevel.Companion.html#ALLOW_ADULT()">ALLOW_ADULT</a></pre>
- <p>Filters out any images containing depictions of children.</p>
+ <p>Allow generation of images containing adults only; images of children are filtered out.</p>
+ <blockquote>
+ <p>Important: Generation of images containing people or faces may require your use case to be reviewed and approved by Cloud support; see the <a href="https://cloud.google.com/vertex-ai/generative-ai/docs/image/responsible-ai-imagen#person-face-gen">Responsible AI and usage * guidelines</a> for more details.</p>
+ </blockquote>
</div>
<div class="api-item"><a name="getALLOW_ALL()"></a><a name="setALLOW_ALL()"></a><a name="getALLOW_ALL--"></a><a name="setALLOW_ALL--"></a>
<h3 class="api-name" id="ALLOW_ALL()">ALLOW_ALL</h3>
<pre class="api-signature no-pretty-print">public static final @<a href="https://developer.android.com/reference/kotlin/androidx/annotation/NonNull.html">NonNull</a> <a href="/docs/reference/android/com/google/firebase/ai/type/ImagenPersonFilterLevel.html">ImagenPersonFilterLevel</a> <a href="/docs/reference/android/com/google/firebase/ai/type/ImagenPersonFilterLevel.Companion.html#ALLOW_ALL()">ALLOW_ALL</a></pre>
- <p>No filters applied.</p>
+ <p>Allow generation of images containing people of all ages.</p>
+ <blockquote>
+ <p>Important: Generation of images containing people or faces may require your use case to be reviewed and approved by Cloud support; see the <a href="https://cloud.google.com/vertex-ai/generative-ai/docs/image/responsible-ai-imagen#person-face-gen">Responsible AI and usage * guidelines</a> for more details.</p>
+ </blockquote>
</div>
<div class="api-item"><a name="getBLOCK_ALL()"></a><a name="setBLOCK_ALL()"></a><a name="getBLOCK_ALL--"></a><a name="setBLOCK_ALL--"></a>
<h3 class="api-name" id="BLOCK_ALL()">BLOCK_ALL</h3>
<pre class="api-signature no-pretty-print">public static final @<a href="https://developer.android.com/reference/kotlin/androidx/annotation/NonNull.html">NonNull</a> <a href="/docs/reference/android/com/google/firebase/ai/type/ImagenPersonFilterLevel.html">ImagenPersonFilterLevel</a> <a href="/docs/reference/android/com/google/firebase/ai/type/ImagenPersonFilterLevel.Companion.html#BLOCK_ALL()">BLOCK_ALL</a></pre>
- <p>Filters out any images containing depictions of people.</p>
+ <p>Disallow generation of images containing people or faces; images of people are filtered out.</p>
</div>
</div>
</body>--- /home/runner/diff/original/firebase-kotlindoc/kotlin/com/google/firebase/ai/type/ImagenPersonFilterLevel.html 2025-05-27 16:20:15.120206503 +0000
+++ /home/runner/diff/modified/firebase-kotlindoc/kotlin/com/google/firebase/ai/type/ImagenPersonFilterLevel.html 2025-05-27 16:16:54.100005638 +0000
@@ -29,21 +29,21 @@
<td><code><a href="/docs/reference/kotlin/com/google/firebase/ai/type/ImagenPersonFilterLevel.html">ImagenPersonFilterLevel</a></code></td>
<td>
<div><code><a href="/docs/reference/kotlin/com/google/firebase/ai/type/ImagenPersonFilterLevel.Companion.html#ALLOW_ADULT()">ALLOW_ADULT</a></code></div>
- <p>Filters out any images containing depictions of children.</p>
+ <p>Allow generation of images containing adults only; images of children are filtered out.</p>
</td>
</tr>
<tr>
<td><code><a href="/docs/reference/kotlin/com/google/firebase/ai/type/ImagenPersonFilterLevel.html">ImagenPersonFilterLevel</a></code></td>
<td>
<div><code><a href="/docs/reference/kotlin/com/google/firebase/ai/type/ImagenPersonFilterLevel.Companion.html#ALLOW_ALL()">ALLOW_ALL</a></code></div>
- <p>No filters applied.</p>
+ <p>Allow generation of images containing people of all ages.</p>
</td>
</tr>
<tr>
<td><code><a href="/docs/reference/kotlin/com/google/firebase/ai/type/ImagenPersonFilterLevel.html">ImagenPersonFilterLevel</a></code></td>
<td>
<div><code><a href="/docs/reference/kotlin/com/google/firebase/ai/type/ImagenPersonFilterLevel.Companion.html#BLOCK_ALL()">BLOCK_ALL</a></code></div>
- <p>Filters out any images containing depictions of people.</p>
+ <p>Disallow generation of images containing people or faces; images of people are filtered out.</p>
</td>
</tr>
</tbody>
@@ -54,17 +54,23 @@
<div class="api-item"><a name="getALLOW_ADULT()"></a><a name="setALLOW_ADULT()"></a><a name="getALLOW_ADULT--"></a><a name="setALLOW_ADULT--"></a>
<h3 class="api-name" id="ALLOW_ADULT()">ALLOW_ADULT</h3>
<pre class="api-signature no-pretty-print">val <a href="/docs/reference/kotlin/com/google/firebase/ai/type/ImagenPersonFilterLevel.Companion.html#ALLOW_ADULT()">ALLOW_ADULT</a>: <a href="/docs/reference/kotlin/com/google/firebase/ai/type/ImagenPersonFilterLevel.html">ImagenPersonFilterLevel</a></pre>
- <p>Filters out any images containing depictions of children.</p>
+ <p>Allow generation of images containing adults only; images of children are filtered out.</p>
+ <blockquote>
+ <p>Important: Generation of images containing people or faces may require your use case to be reviewed and approved by Cloud support; see the <a href="https://cloud.google.com/vertex-ai/generative-ai/docs/image/responsible-ai-imagen#person-face-gen">Responsible AI and usage * guidelines</a> for more details.</p>
+ </blockquote>
</div>
<div class="api-item"><a name="getALLOW_ALL()"></a><a name="setALLOW_ALL()"></a><a name="getALLOW_ALL--"></a><a name="setALLOW_ALL--"></a>
<h3 class="api-name" id="ALLOW_ALL()">ALLOW_ALL</h3>
<pre class="api-signature no-pretty-print">val <a href="/docs/reference/kotlin/com/google/firebase/ai/type/ImagenPersonFilterLevel.Companion.html#ALLOW_ALL()">ALLOW_ALL</a>: <a href="/docs/reference/kotlin/com/google/firebase/ai/type/ImagenPersonFilterLevel.html">ImagenPersonFilterLevel</a></pre>
- <p>No filters applied.</p>
+ <p>Allow generation of images containing people of all ages.</p>
+ <blockquote>
+ <p>Important: Generation of images containing people or faces may require your use case to be reviewed and approved by Cloud support; see the <a href="https://cloud.google.com/vertex-ai/generative-ai/docs/image/responsible-ai-imagen#person-face-gen">Responsible AI and usage * guidelines</a> for more details.</p>
+ </blockquote>
</div>
<div class="api-item"><a name="getBLOCK_ALL()"></a><a name="setBLOCK_ALL()"></a><a name="getBLOCK_ALL--"></a><a name="setBLOCK_ALL--"></a>
<h3 class="api-name" id="BLOCK_ALL()">BLOCK_ALL</h3>
<pre class="api-signature no-pretty-print">val <a href="/docs/reference/kotlin/com/google/firebase/ai/type/ImagenPersonFilterLevel.Companion.html#BLOCK_ALL()">BLOCK_ALL</a>: <a href="/docs/reference/kotlin/com/google/firebase/ai/type/ImagenPersonFilterLevel.html">ImagenPersonFilterLevel</a></pre>
- <p>Filters out any images containing depictions of people.</p>
+ <p>Disallow generation of images containing people or faces; images of people are filtered out.</p>
</div>
</div>
</body> |
Generated by 🚫 Danger |
Test Results 24 files - 40 24 suites - 40 34s ⏱️ - 1m 47s Results for commit 8ea5863. ± Comparison against base commit ec4b353. This pull request removes 319 and adds 102 tests. Note that renamed tests count towards both.♻️ This comment has been updated with latest results. |
Coverage Report 1Affected ProductsNo changes between base commit (ec4b353) and merge commit (ec52df8).Test Logs |
Size Report 1Affected ProductsTest Logs |
davidmotson
approved these changes
May 27, 2025
rlazo
approved these changes
May 27, 2025
Sign up for free
to subscribe to this conversation on GitHub.
Already have an account?
Sign in.
4 participants
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
This PR updates the ImagenPersonFilter refdocs to match the iOS SDK, including the information about the Person and face generation allowlist.