feat(api): add safety identifiers to image requests and responses

.castiron.stats.yml

@@ -1,8 +1,8 @@
 schema_version: 1
-generation_id: 87b7588c-bf2a-41c6-9369-25b7fac9406c
-openapi_spec_hash: 5dc81283fba93dcfeaeca3da5226d157
-openapi_transformed_spec_hash: 42319a087893dfea0fdd818494eb2a8d
+generation_id: 45bb4cff-9dc4-4216-966d-b79c11bebfda
+openapi_spec_hash: 635c031247109fd4cd1b4b3015290a04
+openapi_transformed_spec_hash: e37900bf3b6f760c1ac154667fb4a5d3
 config_hash: c1867d38e1fb20037598907749312f81
-codegen_sha: 0312112d44322208df3d1587c5b6eac1867be196
-codegen_hash: c6efe506a6d3c692825695e888a088db61e9f7c1115801a7138ba4b3ec8b1d00
-public_codegen_sha: 54359420e01e63cc0b61838459b07fcf8cc3a7bd
+codegen_sha: d4d98934542b730bc6d1cbd3a2b059402846d750
+codegen_hash: 5a2c6ec20bd11650a52f85637e5c6687a634a4b6139160b98e9c33af31f449bb
+public_codegen_sha: 3bd55cae20dba1704ed6d324c2dbc53cbd0090c7

api_reference/openapi.transformed.yml

@@ -43282,8 +43282,8 @@ components:
         user:
           type: string
           example: user-1234
-          description: |
-            A unique identifier representing your end-user, which can help OpenAI to monitor and detect abuse. [Learn more](https://developers.openai.com/api/docs/guides/safety-best-practices#implement-safety-identifiers).
+          description: 'Deprecated: use `safety_identifier` instead. This parameter remains accepted for backward compatibility and is used when `safety_identifier` is omitted, null, or empty. [Learn more](https://developers.openai.com/api/docs/guides/safety-best-practices#implement-safety-identifiers).'
+          deprecated: true
         input_fidelity:
           anyOf:
           - $ref: '#/components/schemas/InputFidelity'
@@ -43318,6 +43318,13 @@ components:
           example: high
           description: |
             The quality of the image that will be generated for GPT image models. The GPT image models support `low`, `medium`, and `high`. `gpt-image-2.5-sunburst` and `gpt-image-2.5-flare`, including their `2026-09-08` snapshots, also support `xhigh` and `max`. Defaults to `auto`.
+        safety_identifier:
+          type:
+          - string
+          - 'null'
+          maxLength: 128
+          example: user-1234
+          description: A stable identifier for an end user in your organization, used for safety monitoring and abuse detection. Hash a username or email address to avoid sending identifying information. A non-empty value takes precedence over the deprecated `user` parameter. If omitted, null, or empty, the API uses `user` when available. [Learn more](https://developers.openai.com/api/docs/guides/safety-best-practices#implement-safety-identifiers).
       required:
       - prompt
       - image
@@ -43502,8 +43509,15 @@ components:
         user:
           type: string
           example: user-1234
-          description: |
-            A unique identifier representing your end-user, which can help OpenAI to monitor and detect abuse. [Learn more](https://developers.openai.com/api/docs/guides/safety-best-practices#implement-safety-identifiers).
+          description: 'Deprecated: use `safety_identifier` instead. This parameter remains accepted for backward compatibility and is used when `safety_identifier` is omitted, null, or empty. [Learn more](https://developers.openai.com/api/docs/guides/safety-best-practices#implement-safety-identifiers).'
+          deprecated: true
+        safety_identifier:
+          type:
+          - string
+          - 'null'
+          maxLength: 128
+          example: user-1234
+          description: A stable identifier for an end user in your organization, used for safety monitoring and abuse detection. Hash a username or email address to avoid sending identifying information. A non-empty value takes precedence over the deprecated `user` parameter. If omitted, null, or empty, the API uses `user` when available. [Learn more](https://developers.openai.com/api/docs/guides/safety-best-practices#implement-safety-identifiers).
       required:
       - prompt
     CreateImageVariationRequest:
@@ -45727,9 +45741,8 @@ components:
         user:
           type: string
           example: user-1234
-          description: |
-            A unique identifier representing your end-user, which can help OpenAI
-            monitor and detect abuse.
+          description: 'Deprecated: use `safety_identifier` instead. This parameter remains accepted for backward compatibility and is used when `safety_identifier` is omitted, null, or empty. [Learn more](https://developers.openai.com/api/docs/guides/safety-best-practices#implement-safety-identifiers).'
+          deprecated: true
         output_format:
           anyOf:
           - type: string
@@ -45779,6 +45792,13 @@ components:
           description: Stream partial image results as events.
         partial_images:
           $ref: '#/components/schemas/PartialImages'
+        safety_identifier:
+          type:
+          - string
+          - 'null'
+          maxLength: 128
+          example: user-1234
+          description: A stable identifier for an end user in your organization, used for safety monitoring and abuse detection. Hash a username or email address to avoid sending identifying information. A non-empty value takes precedence over the deprecated `user` parameter. If omitted, null, or empty, the API uses `user` when available. [Learn more](https://developers.openai.com/api/docs/guides/safety-best-practices#implement-safety-identifiers).
       required:
       - images
       - prompt
@@ -49074,6 +49094,11 @@ components:
           - jpeg
         usage:
           $ref: '#/components/schemas/ImagesUsage'
+        safety_identifier:
+          type:
+          - string
+          - 'null'
+          description: The effective safety identifier used for safety monitoring and abuse detection. This is the non-empty `safety_identifier` from the request, or the deprecated `user` value when `safety_identifier` is omitted, null, or empty.
       required:
       - type
       - b64_json
@@ -49258,6 +49283,11 @@ components:
           - jpeg
         usage:
           $ref: '#/components/schemas/ImagesUsage'
+        safety_identifier:
+          type:
+          - string
+          - 'null'
+          description: The effective safety identifier used for safety monitoring and abuse detection. This is the non-empty `safety_identifier` from the request, or the deprecated `user` value when `safety_identifier` is omitted, null, or empty.
       required:
       - type
       - b64_json
@@ -49593,6 +49623,11 @@ components:
           - max
         usage:
           $ref: '#/components/schemas/ImageGenUsage'
+        safety_identifier:
+          type:
+          - string
+          - 'null'
+          description: The effective safety identifier used for safety monitoring and abuse detection. This is the non-empty `safety_identifier` from the request, or the deprecated `user` value when `safety_identifier` is omitted, null, or empty.
       required:
       - created
       x-oaiMeta:

scripts/castiron/generated-files.json

@@ -579,7 +579,7 @@
     },
     "src/openai/resources/images.py": {
       "mode": "100644",
-      "sha256": "f487a91fa0a826fb25249ae85d9357350253ee79c40e09ea7c6820be8e23d171"
+      "sha256": "dfbe5ceeda53fd272b99583eaa1f684adf46183b71529c78324e3f2c926fb971"
     },
     "src/openai/resources/live/__init__.py": {
       "mode": "100644",
@@ -4459,11 +4459,11 @@
     },
     "src/openai/types/image_edit_completed_event.py": {
       "mode": "100644",
-      "sha256": "bd2f2d492c1db3bd37cea445b9cd1122181e3bcb60a74201962348f1fef36325"
+      "sha256": "8d288f7293dadacb3617c3dd90e3edfba15a04604910318ae4e4cab1f788ddb1"
     },
     "src/openai/types/image_edit_params.py": {
       "mode": "100644",
-      "sha256": "c790b739d4c387faf43ea11576b33fcc3d382d914115f33fa14ec3077012df66"
+      "sha256": "f3182c188012e2905ef4e2f192ee368d7ad1199e930698eb6ee1c2e69c5b2887"
     },
     "src/openai/types/image_edit_partial_image_event.py": {
       "mode": "100644",
@@ -4475,7 +4475,7 @@
     },
     "src/openai/types/image_gen_completed_event.py": {
       "mode": "100644",
-      "sha256": "88fc97c451571487171d858a0fc4a73fd6420051df424638fa0d01ac039c9e60"
+      "sha256": "422fc133a90e049156c0bc20fdbdfc9010e5ac5a861ae38f27f6ba988c0250ac"
     },
     "src/openai/types/image_gen_partial_image_event.py": {
       "mode": "100644",
@@ -4487,7 +4487,7 @@
     },
     "src/openai/types/image_generate_params.py": {
       "mode": "100644",
-      "sha256": "919da351f49bd9e944334efd6b0d44d014c64649d5afdcaad9eccb407bfe271f"
+      "sha256": "ce11e6fc1ad113d96c6d3a275a1906da43d7ea4718fb72d9804559bd9ef60709"
     },
     "src/openai/types/image_input_reference_param.py": {
       "mode": "100644",
@@ -4499,7 +4499,7 @@
     },
     "src/openai/types/images_response.py": {
       "mode": "100644",
-      "sha256": "45543776df980cb2b4ce5d0dfa1800959af88641a4a915bf19e665fedccbb422"
+      "sha256": "07b223269f452e7e06d7d037b3c4cb867f52d3f4f3a32d7cfe1160ceea0a2c1b"
     },
     "src/openai/types/live/__init__.py": {
       "mode": "100644",
@@ -7695,7 +7695,7 @@
     },
     "tests/api_resources/test_images.py": {
       "mode": "100644",
-      "sha256": "cb12a050f0b1aef0e444813b75f503914f64a4280011de339e8a6bb739c9693e"
+      "sha256": "39b8d0e03206abc79df8eb4c3fe5c6a928dfb22d2ccaa2423e0a0db011e2b049"
     },
     "tests/api_resources/test_live.py": {
       "mode": "100644",