AI网关新增xAI格式TTS端点与过滤弃用模型开关

- POST /ai/v1/tts:xAI 官方 TTS 格式转换层(text/voice_id→input/voice),复用 Speech 编排,model 缺省 xai.grok-tts;实测 output_format/speed 透传生效
- 「过滤弃用模型」开关(GET/PUT /api/v1/ai-settings,settings 表持久化):开启后已宣布弃用(未退役)模型从列表与路由排除;同步入库与退役提醒不受影响
- AI 网关文档更名 docs/AI网关.md,补 tts 矩阵段与开关说明;README 引用同步
- CHANGELOG 0.5.0(0.4.0 已发版冻结);DASH_VERSION v0.5.0

docs/swagger.yaml

@@ -46,6 +46,11 @@ definitions:
       key:
         type: string
     type: object
+  internal_api.aiSettingsResponse:
+    properties:
+      filterDeprecated:
+        type: boolean
+    type: object
   internal_api.attachBootVolumeRequest:
     properties:
       bootVolumeId:
@@ -1219,6 +1224,30 @@ definitions:
       type:
         type: string
     type: object
+  oci-portal_internal_aiwire.TtsOutputFormat:
+    properties:
+      bit_rate:
+        type: integer
+      codec:
+        type: string
+      sample_rate:
+        type: integer
+    type: object
+  oci-portal_internal_aiwire.TtsRequest:
+    properties:
+      language:
+        type: string
+      model:
+        type: string
+      output_format:
+        $ref: '#/definitions/oci-portal_internal_aiwire.TtsOutputFormat'
+      speed:
+        type: number
+      text:
+        type: string
+      voice_id:
+        type: string
+    type: object
   oci-portal_internal_aiwire.Usage:
     properties:
       completion_tokens:
@@ -2752,6 +2781,23 @@ paths:
       summary: OpenAI Responses 兼容端点
       tags:
       - AI 网关
+  /ai/v1/tts:
+    post:
+      parameters:
+      - description: xAI TTS 请求体(text/language 必填,voice_id 缺省 eve;model 为网关扩展,缺省 xai.grok-tts;未列字段原样透传)
+        in: body
+        name: body
+        required: true
+        schema:
+          $ref: '#/definitions/oci-portal_internal_aiwire.TtsRequest'
+      responses:
+        "200":
+          description: 音频字节(Content-Type 透传上游,默认 audio/mpeg)
+          schema:
+            type: file
+      summary: xAI 官方格式文本转语音端点
+      tags:
+      - AI 网关
   /api/v1/about:
     get:
       responses:
@@ -3040,6 +3086,36 @@ paths:
       summary: '---- 聚合模型与调用日志 ----'
       tags:
       - AI 管理
+  /api/v1/ai-settings:
+    get:
+      responses:
+        "200":
+          description: OK
+          schema:
+            $ref: '#/definitions/internal_api.aiSettingsResponse'
+      security:
+      - BearerAuth: []
+      summary: AI 网关全局设置
+      tags:
+      - AI 管理
+    put:
+      parameters:
+      - description: 开启后已宣布弃用(即使未退役)的模型从列表与路由中排除
+        in: body
+        name: body
+        required: true
+        schema:
+          $ref: '#/definitions/internal_api.aiSettingsResponse'
+      responses:
+        "200":
+          description: OK
+          schema:
+            $ref: '#/definitions/internal_api.aiSettingsResponse'
+      security:
+      - BearerAuth: []
+      summary: 更新 AI 网关全局设置
+      tags:
+      - AI 管理
   /api/v1/auth/credentials:
     get:
       responses: