diff --git a/packages/contracts/openapi.yaml b/packages/contracts/openapi.yaml
index 1fd58be..8157edf 100644
--- a/packages/contracts/openapi.yaml
+++ b/packages/contracts/openapi.yaml
@@ -783,7 +783,7 @@ paths:
               schema:
                 $ref: '#/components/schemas/PublicAlbum'
         '400':
-          description: 查询参数校验失败（VALIDATION_FAILED）。
+          description: 查询参数校验失败（VALIDATION_FAILED；locale 取值不支持时不报错，按 defaultLocale 回退）。
           content:
             application/json:
               schema:
@@ -832,7 +832,7 @@ paths:
               schema:
                 $ref: '#/components/schemas/PublicPhotoList'
         '400':
-          description: 查询参数校验失败（VALIDATION_FAILED）。
+          description: 查询参数校验失败（category/cursor/limit；locale 取值不支持时不报错，按 defaultLocale 回退）。
           content:
             application/json:
               schema:
@@ -935,7 +935,7 @@ components:
     LocaleQuery:
       name: locale
       in: query
-      description: 请求语言；缺省时按相册 defaultLocale 回退。
+      description: 请求语言；缺省或取值不支持时按相册 defaultLocale 回退（不报 400，响应 resolvedLocale 指示实际返回语言）。
       schema:
         $ref: '#/components/schemas/Locale'
 
diff --git a/packages/contracts/src/generated/openapi.d.ts b/packages/contracts/src/generated/openapi.d.ts
index 6f1bff1..3699948 100644
--- a/packages/contracts/src/generated/openapi.d.ts
+++ b/packages/contracts/src/generated/openapi.d.ts
@@ -908,7 +908,7 @@ export interface components {
         AlbumPublicToken: string;
         /** @description 分页游标（上一页响应的 nextCursor）。 */
         CursorQuery: string;
-        /** @description 请求语言；缺省时按相册 defaultLocale 回退。 */
+        /** @description 请求语言；缺省或取值不支持时按相册 defaultLocale 回退（不报 400，响应 resolvedLocale 指示实际返回语言）。 */
         LocaleQuery: components["schemas"]["Locale"];
     };
     requestBodies: never;
@@ -1783,7 +1783,7 @@ export interface operations {
     getPublicAlbum: {
         parameters: {
             query?: {
-                /** @description 请求语言；缺省时按相册 defaultLocale 回退。 */
+                /** @description 请求语言；缺省或取值不支持时按相册 defaultLocale 回退（不报 400，响应 resolvedLocale 指示实际返回语言）。 */
                 locale?: components["parameters"]["LocaleQuery"];
             };
             header?: never;
@@ -1804,7 +1804,7 @@ export interface operations {
                     "application/json": components["schemas"]["PublicAlbum"];
                 };
             };
-            /** @description 查询参数校验失败（VALIDATION_FAILED）。 */
+            /** @description 查询参数校验失败（VALIDATION_FAILED；locale 取值不支持时不报错，按 defaultLocale 回退）。 */
             400: {
                 headers: {
                     [name: string]: unknown;
@@ -1830,7 +1830,7 @@ export interface operations {
             query?: {
                 /** @description 分类 ID 过滤（来自 PublicAlbum.categories 的 id）。 */
                 category?: string;
-                /** @description 请求语言；缺省时按相册 defaultLocale 回退。 */
+                /** @description 请求语言；缺省或取值不支持时按相册 defaultLocale 回退（不报 400，响应 resolvedLocale 指示实际返回语言）。 */
                 locale?: components["parameters"]["LocaleQuery"];
                 /** @description 分页游标（上一页响应的 nextCursor）。 */
                 cursor?: components["parameters"]["CursorQuery"];
@@ -1855,7 +1855,7 @@ export interface operations {
                     "application/json": components["schemas"]["PublicPhotoList"];
                 };
             };
-            /** @description 查询参数校验失败（VALIDATION_FAILED）。 */
+            /** @description 查询参数校验失败（category/cursor/limit；locale 取值不支持时不报错，按 defaultLocale 回退）。 */
             400: {
                 headers: {
                     [name: string]: unknown;