chore: update OpenAPI spec [sdk-bot]

Co-authored-by: OpenRouter SDK Bot <sdk-bot@openrouter.ai>

.speakeasy/in.openapi.yaml

@@ -1057,6 +1057,33 @@ components:
         - type
         - data
       type: object
+    AnthropicRefusalStopDetails:
+      description: Structured information about a refusal
+      example:
+        category: cyber
+        explanation: The request was refused due to policy.
+        type: refusal
+      nullable: true
+      properties:
+        category:
+          enum:
+            - cyber
+            - bio
+            - null
+          nullable: true
+          type: string
+        explanation:
+          nullable: true
+          type: string
+        type:
+          enum:
+            - refusal
+          type: string
+      required:
+        - type
+        - category
+        - explanation
+      type: object
     AnthropicSearchResultBlockParam:
       example:
         content:
@@ -2315,6 +2342,7 @@ components:
         id: msg_01XFDUDYJgAACzvnptvVoYEL
         model: claude-sonnet-4-5-20250929
         role: assistant
+        stop_details: null
         stop_reason: end_turn
         stop_sequence: null
         type: message
@@ -2338,6 +2366,8 @@ components:
           enum:
             - assistant
           type: string
+        stop_details:
+          $ref: '#/components/schemas/AnthropicRefusalStopDetails'
         stop_reason:
           $ref: '#/components/schemas/ORAnthropicStopReason'
         stop_sequence:
@@ -2375,6 +2405,7 @@ components:
         - content
         - model
         - stop_reason
+        - stop_details
         - stop_sequence
         - usage
       type: object
@@ -3464,6 +3495,7 @@ components:
             - function
           type: object
         - $ref: '#/components/schemas/DatetimeServerTool'
+        - $ref: '#/components/schemas/ChatSearchModelsServerTool'
         - $ref: '#/components/schemas/OpenRouterWebSearchServerTool'
         - $ref: '#/components/schemas/ChatWebSearchShorthand'
       description: Tool definition for function calling (regular function or OpenRouter built-in server tool)
@@ -3905,6 +3937,22 @@ components:
         - object
         - system_fingerprint
       type: object
+    ChatSearchModelsServerTool:
+      description: 'OpenRouter built-in server tool: searches and filters AI models available on OpenRouter'
+      example:
+        parameters:
+          max_results: 5
+        type: openrouter:experimental__search_models
+      properties:
+        parameters:
+          $ref: '#/components/schemas/SearchModelsServerToolConfig'
+        type:
+          enum:
+            - openrouter:experimental__search_models
+          type: string
+      required:
+        - type
+      type: object
     ChatStreamChoice:
       description: Streaming completion choice chunk
       example:
@@ -4787,6 +4835,7 @@ components:
           - deepseek
         description: A guardrail for limiting API usage
         enforce_zdr: false
+        ignored_models: null
         ignored_providers: null
         limit_usd: 50
         name: My New Guardrail
@@ -4825,6 +4874,15 @@ components:
           example: false
           nullable: true
           type: boolean
+        ignored_models:
+          description: Array of model identifiers to exclude from routing (slug or canonical_slug accepted)
+          example:
+            - openai/gpt-4o-mini
+          items:
+            type: string
+          minItems: 1
+          nullable: true
+          type: array
         ignored_providers:
           description: List of provider IDs to exclude from routing
           example:
@@ -4862,6 +4920,7 @@ components:
           description: A guardrail for limiting API usage
           enforce_zdr: false
           id: 550e8400-e29b-41d4-a716-446655440000
+          ignored_models: null
           ignored_providers: null
           limit_usd: 50
           name: My New Guardrail
@@ -5385,6 +5444,24 @@ components:
       required:
         - type
       type: object
+    FrameImage:
+      allOf:
+        - $ref: '#/components/schemas/ContentPartImage'
+        - properties:
+            frame_type:
+              description: Whether this image represents the first or last frame of the video
+              enum:
+                - first_frame
+                - last_frame
+              example: first_frame
+              type: string
+          required:
+            - frame_type
+          type: object
+      example:
+        image_url:
+          url: https://example.com/image.png
+        type: image_url
     FunctionCallArgsDeltaEvent:
       allOf:
         - $ref: '#/components/schemas/BaseFunctionCallArgsDeltaEvent'
@@ -5508,6 +5585,7 @@ components:
           description: Guardrail for production environment
           enforce_zdr: false
           id: 550e8400-e29b-41d4-a716-446655440000
+          ignored_models: null
           ignored_providers: null
           limit_usd: 100
           name: Production Guardrail
@@ -5570,6 +5648,7 @@ components:
         description: Guardrail for production environment
         enforce_zdr: false
         id: 550e8400-e29b-41d4-a716-446655440000
+        ignored_models: null
         ignored_providers: null
         limit_usd: 100
         name: Production Guardrail
@@ -5615,6 +5694,14 @@ components:
           example: 550e8400-e29b-41d4-a716-446655440000
           format: uuid
           type: string
+        ignored_models:
+          description: Array of model canonical_slugs to exclude from routing
+          example:
+            - openai/gpt-4o-mini-2024-07-18
+          items:
+            type: string
+          nullable: true
+          type: array
         ignored_providers:
           description: List of provider IDs to exclude from routing
           example:
@@ -6377,6 +6464,7 @@ components:
             description: Guardrail for production environment
             enforce_zdr: false
             id: 550e8400-e29b-41d4-a716-446655440000
+            ignored_models: null
             ignored_providers: null
             limit_usd: 100
             name: Production Guardrail
@@ -6737,6 +6825,7 @@ components:
       description: Event sent when the message metadata changes (e.g., stop_reason)
       example:
         delta:
+          stop_details: null
           stop_reason: end_turn
           stop_sequence: null
         type: message_delta
@@ -6747,6 +6836,8 @@ components:
           properties:
             container:
               $ref: '#/components/schemas/AnthropicContainer'
+            stop_details:
+              $ref: '#/components/schemas/AnthropicRefusalStopDetails'
             stop_reason:
               $ref: '#/components/schemas/ORAnthropicStopReason'
             stop_sequence:
@@ -6754,6 +6845,7 @@ components:
               type: string
           required:
             - container
+            - stop_details
             - stop_reason
             - stop_sequence
           type: object
@@ -7456,6 +7548,7 @@ components:
                   - name
                 type: object
               - $ref: '#/components/schemas/DatetimeServerTool'
+              - $ref: '#/components/schemas/ChatSearchModelsServerTool'
               - $ref: '#/components/schemas/OpenRouterWebSearchServerTool'
           type: array
         top_k:
@@ -7537,6 +7630,7 @@ components:
         id: msg_01XFDUDYJgAACzvnptvVoYEL
         model: claude-sonnet-4-5-20250929
         role: assistant
+        stop_details: null
         stop_reason: end_turn
         stop_sequence: null
         type: message
@@ -7557,6 +7651,7 @@ components:
           id: msg_01XFDUDYJgAACzvnptvVoYEL
           model: claude-sonnet-4-5-20250929
           role: assistant
+          stop_details: null
           stop_reason: null
           stop_sequence: null
           type: message
@@ -7631,6 +7726,7 @@ components:
                 - Crusoe
                 - DeepInfra
                 - DeepSeek
+                - DekaLLM
                 - Featherless
                 - Fireworks
                 - Friendli
@@ -7665,6 +7761,7 @@ components:
                 - Parasail
                 - Perplexity
                 - Phala
+                - Recraft
                 - Reka
                 - Relace
                 - SambaNova
@@ -7688,6 +7785,8 @@ components:
               enum:
                 - assistant
               type: string
+            stop_details:
+              $ref: '#/components/schemas/AnthropicRefusalStopDetails'
             stop_reason:
               nullable: true
             stop_sequence:
@@ -7724,6 +7823,7 @@ components:
             - content
             - model
             - stop_reason
+            - stop_details
             - stop_sequence
             - usage
           type: object
@@ -10009,6 +10109,7 @@ components:
         - Crusoe
         - DeepInfra
         - DeepSeek
+        - DekaLLM
         - Featherless
         - Fireworks
         - Friendli
@@ -10043,6 +10144,7 @@ components:
         - Parasail
         - Perplexity
         - Phala
+        - Recraft
         - Reka
         - Relace
         - SambaNova
@@ -10320,6 +10422,7 @@ components:
             - Crusoe
             - DeepInfra
             - DeepSeek
+            - DekaLLM
             - Featherless
             - Fireworks
             - Friendli
@@ -10354,6 +10457,7 @@ components:
             - Parasail
             - Perplexity
             - Phala
+            - Recraft
             - Reka
             - Relace
             - SambaNova
@@ -11313,6 +11417,7 @@ components:
               - $ref: '#/components/schemas/ApplyPatchServerTool'
               - $ref: '#/components/schemas/CustomTool'
               - $ref: '#/components/schemas/DatetimeServerTool'
+              - $ref: '#/components/schemas/ChatSearchModelsServerTool'
               - $ref: '#/components/schemas/WebSearchServerTool_OpenRouter'
           type: array
         top_k:
@@ -11342,6 +11447,16 @@ components:
         - high
       example: medium
       type: string
+    SearchModelsServerToolConfig:
+      description: Configuration for the openrouter:experimental__search_models server tool
+      example:
+        max_results: 5
+      properties:
+        max_results:
+          description: Maximum number of models to return. Defaults to 5, max 20.
+          example: 5
+          type: integer
+      type: object
     SearchQualityLevel:
       description: >-
         How much context to retrieve per result. Defaults to medium (15000 chars). Only applies when using the Exa
@@ -11968,6 +12083,15 @@ components:
           example: true
           nullable: true
           type: boolean
+        ignored_models:
+          description: Array of model identifiers to exclude from routing (slug or canonical_slug accepted)
+          example:
+            - openai/gpt-4o-mini
+          items:
+            type: string
+          minItems: 1
+          nullable: true
+          type: array
         ignored_providers:
           description: List of provider IDs to exclude from routing
           example:
@@ -12001,6 +12125,7 @@ components:
           description: Updated description
           enforce_zdr: true
           id: 550e8400-e29b-41d4-a716-446655440000
+          ignored_models: null
           ignored_providers: null
           limit_usd: 75
           name: Updated Guardrail Name
@@ -12106,13 +12231,19 @@ components:
         duration:
           description: Duration of the generated video in seconds
           example: 8
-          exclusiveMinimum: true
-          minimum: 0
+          minimum: 1
           type: integer
+        frame_images:
+          description: >-
+            Images to use as the first and/or last frame of the generated video. Each image must specify a frame_type of
+            first_frame or last_frame.
+          items:
+            $ref: '#/components/schemas/FrameImage'
+          type: array
         generate_audio:
           description: >-
-            Whether to generate audio alongside the video. Defaults to true for models that support audio output, false
-            otherwise.
+            Whether to generate audio alongside the video. Defaults to the endpoint's generate_audio capability flag,
+            false if not set.
           example: true
           type: boolean
         input_references:
@@ -12252,6 +12383,10 @@ components:
                   additionalProperties:
                     nullable: true
                   type: object
+                dekallm:
+                  additionalProperties:
+                    nullable: true
+                  type: object
                 enfer:
                   additionalProperties:
                     nullable: true
@@ -12452,6 +12587,10 @@ components:
                   additionalProperties:
                     nullable: true
                   type: object
+                recraft:
+                  additionalProperties:
+                    nullable: true
+                  type: object
                 recursal:
                   additionalProperties:
                     nullable: true
@@ -12636,15 +12775,20 @@ components:
         canonical_slug: google/veo-3.1
         created: 1700000000
         description: Google video generation model
+        generate_audio: true
         id: google/veo-3.1
         name: Veo 3.1
         pricing_skus:
           generate: '0.50'
+        seed: null
         supported_aspect_ratios:
           - '16:9'
         supported_durations:
           - 5
           - 8
+        supported_frame_images:
+          - first_frame
+          - last_frame
         supported_resolutions:
           - 720p
         supported_sizes: null
@@ -12666,6 +12810,10 @@ components:
           description: Description of the model
           example: GPT-4 is a large multimodal model that can solve difficult problems with greater accuracy.
           type: string
+        generate_audio:
+          description: Whether the model supports generating audio alongside video
+          nullable: true
+          type: boolean
         hugging_face_id:
           description: Hugging Face model identifier, if applicable
           example: microsoft/DialoGPT-medium
@@ -12685,6 +12833,10 @@ components:
           description: Pricing SKUs with provider prefix stripped, values as strings
           nullable: true
           type: object
+        seed:
+          description: Whether the model supports deterministic generation via seed parameter
+          nullable: true
+          type: boolean
         supported_aspect_ratios:
           description: Supported output aspect ratios
           items:
@@ -12705,6 +12857,15 @@ components:
             type: integer
           nullable: true
           type: array
+        supported_frame_images:
+          description: Supported frame image types (e.g. first_frame, last_frame)
+          items:
+            enum:
+              - first_frame
+              - last_frame
+            type: string
+          nullable: true
+          type: array
         supported_resolutions:
           description: Supported output resolutions
           items:
@@ -12762,6 +12923,9 @@ components:
         - supported_aspect_ratios
         - supported_sizes
         - supported_durations
+        - supported_frame_images
+        - generate_audio
+        - seed
         - allowed_passthrough_parameters
       type: object
     VideoModelsListResponse:
@@ -12771,15 +12935,20 @@ components:
             canonical_slug: google/veo-3.1
             created: 1700000000
             description: Google video generation model
+            generate_audio: true
             id: google/veo-3.1
             name: Veo 3.1
             pricing_skus:
               generate: '0.50'
+            seed: null
             supported_aspect_ratios:
               - '16:9'
             supported_durations:
               - 5
               - 8
+            supported_frame_images:
+              - first_frame
+              - last_frame
             supported_resolutions:
               - 720p
             supported_sizes: null
@@ -13792,8 +13961,7 @@ paths:
                 dimensions:
                   description: The number of dimensions for the output embeddings
                   example: 1536
-                  exclusiveMinimum: 0
-                  minimum: 0
+                  minimum: 1
                   type: integer
                 encoding_format:
                   description: The format of the output embeddings
@@ -14662,6 +14830,7 @@ paths:
                     description: Guardrail for production environment
                     enforce_zdr: false
                     id: 550e8400-e29b-41d4-a716-446655440000
+                    ignored_models: null
                     ignored_providers: null
                     limit_usd: 100
                     name: Production Guardrail
@@ -14722,6 +14891,7 @@ paths:
                 - deepseek
               description: A guardrail for limiting API usage
               enforce_zdr: false
+              ignored_models: null
               ignored_providers: null
               limit_usd: 50
               name: My New Guardrail
@@ -14744,6 +14914,7 @@ paths:
                   description: A guardrail for limiting API usage
                   enforce_zdr: false
                   id: 550e8400-e29b-41d4-a716-446655440000
+                  ignored_models: null
                   ignored_providers: null
                   limit_usd: 50
                   name: My New Guardrail
@@ -14871,6 +15042,7 @@ paths:
                   description: Guardrail for production environment
                   enforce_zdr: false
                   id: 550e8400-e29b-41d4-a716-446655440000
+                  ignored_models: null
                   ignored_providers: null
                   limit_usd: 100
                   name: Production Guardrail
@@ -14950,6 +15122,7 @@ paths:
                   description: Updated description
                   enforce_zdr: true
                   id: 550e8400-e29b-41d4-a716-446655440000
+                  ignored_models: null
                   ignored_providers: null
                   limit_usd: 75
                   name: Updated Guardrail Name
@@ -18435,8 +18608,7 @@ paths:
                 top_n:
                   description: Number of most relevant documents to return
                   example: 3
-                  exclusiveMinimum: 0
-                  minimum: 0
+                  minimum: 1
                   type: integer
               required:
                 - model
@@ -19085,15 +19257,20 @@ paths:
                     canonical_slug: google/veo-3.1
                     created: 1700000000
                     description: Google video generation model
+                    generate_audio: true
                     id: google/veo-3.1
                     name: Veo 3.1
                     pricing_skus:
                       generate: '0.50'
+                    seed: null
                     supported_aspect_ratios:
                       - '16:9'
                     supported_durations:
                       - 5
                       - 8
+                    supported_frame_images:
+                      - first_frame
+                      - last_frame
                     supported_resolutions:
                       - 720p
                     supported_sizes: null