feat!: multi-SDK response shapes for /v1/models

client-sdks/stainless/openapi.yml

@@ -1179,28 +1179,99 @@ paths:
     get:
       responses:
         '200':
-          description: A list of OpenAI model objects.
+          description: Returns OpenAI format by default. Send `anthropic-version` header for Anthropic format, or any Google SDK header (`x-goog-api-key`, `x-goog-user-project`, `x-goog-api-client`) for Google format.
           content:
             application/json:
               schema:
-                $ref: '#/components/schemas/OpenAIListModelsResponse'
+                oneOf:
+                - $ref: '#/components/schemas/OpenAIListModelsResponse'
+                  title: OpenAIListModelsResponse
+                - $ref: '#/components/schemas/AnthropicListModelsResponse'
+                  title: AnthropicListModelsResponse
+                - $ref: '#/components/schemas/GoogleListModelsResponse'
+                  title: GoogleListModelsResponse
         '400':
-          description: Bad Request
           $ref: '#/components/responses/BadRequest400'
+          description: Bad Request
         '429':
-          description: Too Many Requests
           $ref: '#/components/responses/TooManyRequests429'
+          description: Too Many Requests
         '500':
-          description: Internal Server Error
           $ref: '#/components/responses/InternalServerError500'
+          description: Internal Server Error
         default:
-          description: Default Response
           $ref: '#/components/responses/DefaultError'
+          description: Default Response
       tags:
       - Models
-      summary: List models using the OpenAI API.
-      description: List models using the OpenAI API.
-      operationId: openai_list_models_v1_models_get
+      summary: List models.
+      description: List models. Returns OpenAI, Anthropic, or Google response format based on SDK detection headers.
+      operationId: list_models_v1_models_get
+      parameters:
+      - name: before_id
+        in: query
+        required: false
+        schema:
+          anyOf:
+          - type: string
+          - type: 'null'
+          description: Return models before this model ID (Anthropic SDK format only).
+          title: Before Id
+        description: Return models before this model ID (Anthropic SDK format only).
+      - name: after_id
+        in: query
+        required: false
+        schema:
+          anyOf:
+          - type: string
+          - type: 'null'
+          description: Return models after this model ID (Anthropic SDK format only).
+          title: After Id
+        description: Return models after this model ID (Anthropic SDK format only).
+      - name: limit
+        in: query
+        required: false
+        schema:
+          anyOf:
+          - type: integer
+            maximum: 1000
+            minimum: 1
+          - type: 'null'
+          description: Maximum number of models to return (Anthropic SDK format only).
+          title: Limit
+        description: Maximum number of models to return (Anthropic SDK format only).
+      - name: anthropic-version
+        in: header
+        required: false
+        schema:
+          anyOf:
+          - type: string
+          - type: 'null'
+          title: Anthropic-Version
+      - name: x-goog-api-key
+        in: header
+        required: false
+        schema:
+          anyOf:
+          - type: string
+          - type: 'null'
+          title: X-Goog-Api-Key
+      - name: x-goog-user-project
+        in: header
+        required: false
+        schema:
+          anyOf:
+          - type: string
+          - type: 'null'
+          title: X-Goog-User-Project
+      - name: x-goog-api-client
+        in: header
+        required: false
+        schema:
+          anyOf:
+          - type: string
+          - type: 'null'
+          title: X-Goog-Api-Client
       x-codeSamples:
       - lang: Python
         label: OpenAI
@@ -1216,11 +1287,17 @@ paths:
     get:
       responses:
         '200':
-          description: The model object.
+          description: Returns OpenAI format by default. Send `anthropic-version` header for Anthropic format, or any Google SDK header (`x-goog-api-key`, `x-goog-user-project`, `x-goog-api-client`) for Google format.
           content:
             application/json:
               schema:
-                $ref: '#/components/schemas/Model'
+                oneOf:
+                - $ref: '#/components/schemas/Model'
+                  title: Model
+                - $ref: '#/components/schemas/AnthropicModelInfo'
+                  title: AnthropicModelInfo
+                - $ref: '#/components/schemas/GoogleModelInfo'
+                  title: GoogleModelInfo
         '400':
           $ref: '#/components/responses/BadRequest400'
           description: Bad Request
@@ -1236,7 +1313,7 @@ paths:
       tags:
       - Models
       summary: Get a model by its identifier.
-      description: Get a model by its identifier.
+      description: Get a model by its identifier. Returns OpenAI, Anthropic, or Google response format based on SDK detection headers.
       operationId: get_model_v1_models__model_id__get
       parameters:
       - name: model_id
@@ -1247,6 +1324,38 @@ paths:
           description: The ID of the model to get.
           title: Model Id
         description: The ID of the model to get.
+      - name: anthropic-version
+        in: header
+        required: false
+        schema:
+          anyOf:
+          - type: string
+          - type: 'null'
+          title: Anthropic-Version
+      - name: x-goog-api-key
+        in: header
+        required: false
+        schema:
+          anyOf:
+          - type: string
+          - type: 'null'
+          title: X-Goog-Api-Key
+      - name: x-goog-user-project
+        in: header
+        required: false
+        schema:
+          anyOf:
+          - type: string
+          - type: 'null'
+          title: X-Goog-User-Project
+      - name: x-goog-api-client
+        in: header
+        required: false
+        schema:
+          anyOf:
+          - type: string
+          - type: 'null'
+          title: X-Goog-Api-Client
       x-codeSamples:
       - lang: Python
         label: OpenAI
@@ -13559,6 +13668,117 @@ components:
       - data
       title: ListModelsResponse
       type: object
+    AnthropicModelInfo:
+      description: |-
+        Anthropic model info response object.
+
+        :id: Unique model identifier
+      properties:
+        id:
+          description: Unique model identifier.
+          title: Id
+          type: string
+        type:
+          description: Object type, always 'model'.
+          title: Type
+          type: string
+          enum:
+          - model
+        display_name:
+          description: A human-readable name for the model.
+          title: Display Name
+          type: string
+        created_at:
+          description: RFC 3339 datetime string representing when the model was released.
+          title: Created At
+          type: string
+        max_input_tokens:
+          anyOf:
+          - type: integer
+          - type: 'null'
+          description: Maximum input context window size in tokens.
+          nullable: true
+        max_tokens:
+          anyOf:
+          - type: integer
+          - type: 'null'
+          description: Maximum value for the max_tokens parameter when using this model.
+          nullable: true
+      required:
+      - id
+      - display_name
+      - created_at
+      title: AnthropicModelInfo
+      type: object
+    AnthropicListModelsResponse:
+      description: Response containing a list of Anthropic model objects.
+      properties:
+        data:
+          description: List of Anthropic model objects.
+          items:
+            $ref: '#/components/schemas/AnthropicModelInfo'
+          title: Data
+          type: array
+        has_more:
+          default: false
+          description: Whether there are more results in the requested page direction.
+          title: Has More
+          type: boolean
+        first_id:
+          anyOf:
+          - type: string
+          - type: 'null'
+          description: First ID in the data list, usable as before_id for the previous page.
+          nullable: true
+        last_id:
+          anyOf:
+          - type: string
+          - type: 'null'
+          description: Last ID in the data list, usable as after_id for the next page.
+          nullable: true
+      required:
+      - data
+      title: AnthropicListModelsResponse
+      type: object
+    GoogleModelInfo:
+      description: |-
+        Google model info response object.
+
+        :name: Model resource name, e.g. 'models/gemini-pro'
+        :display_name: A human-readable name for the model
+        :description: A description of the model
+      properties:
+        name:
+          description: Model resource name, e.g. 'models/gemini-pro'.
+          title: Name
+          type: string
+        display_name:
+          description: A human-readable name for the model.
+          title: Display Name
+          type: string
+        description:
+          default: ''
+          description: A description of the model.
+          title: Description
+          type: string
+      required:
+      - name
+      - display_name
+      title: GoogleModelInfo
+      type: object
+    GoogleListModelsResponse:
+      description: Response containing a list of Google model objects.
+      properties:
+        models:
+          description: List of Google model objects.
+          items:
+            $ref: '#/components/schemas/GoogleModelInfo'
+          title: Models
+          type: array
+      required:
+      - models
+      title: GoogleListModelsResponse
+      type: object
     GetModelRequest:
       description: Request model for getting a model by ID.
       properties:

docs/docs/api-openai/conformance.mdx

@@ -18,12 +18,12 @@ This documentation is auto-generated from the OpenAI API specification compariso
 
 | Metric | Value |
 |--------|-------|
-| **Overall Conformance Score** | 93.4% |
+| **Overall Conformance Score** | 93.2% |
 | **Endpoints Implemented** | 29/146 |
 | **Total Properties Checked** | 3432 |
-| **Schema/Type Issues** | 168 |
-| **Missing Properties** | 59 |
-| **Total Issues to Fix** | 227 |
+| **Schema/Type Issues** | 167 |
+| **Missing Properties** | 65 |
+| **Total Issues to Fix** | 232 |
 
 ## Integration Test Coverage
 
@@ -46,11 +46,11 @@ Categories are sorted by conformance score (lowest first, needing most attention
 |----------|-------|------------|--------|---------|
 | Batch | 39.9% | 168 | 60 | 41 |
 | Completions | 58.7% | 46 | 17 | 2 |
+| Models | 60.0% | 15 | 0 | 6 |
 | Embeddings | 78.6% | 14 | 3 | 0 |
 | Vector stores | 82.9% | 310 | 41 | 12 |
 | Responses | 88.8% | 223 | 25 | 0 |
 | Files | 92.9% | 42 | 1 | 2 |
-| Models | 93.3% | 15 | 1 | 0 |
 | Chat | 98.7% | 449 | 5 | 1 |
 | Conversations | 99.3% | 2165 | 15 | 1 |
 
@@ -437,6 +437,36 @@ Below is a detailed breakdown of conformance issues and missing properties for e
 
 </details>
 
+### Models
+
+**Score:** 60.0% · **Issues:** 0 · **Missing:** 6
+
+#### `/models`
+
+**GET**
+
+<details>
+<summary>Missing Properties (2)</summary>
+
+- `responses.200.content.application/json.properties.data`
+- `responses.200.content.application/json.properties.object`
+
+</details>
+
+#### `/models/{model}`
+
+**GET**
+
+<details>
+<summary>Missing Properties (4)</summary>
+
+- `responses.200.content.application/json.properties.created`
+- `responses.200.content.application/json.properties.id`
+- `responses.200.content.application/json.properties.object`
+- `responses.200.content.application/json.properties.owned_by`
+
+</details>
+
 ### Embeddings
 
 **Score:** 78.6% · **Issues:** 3 · **Missing:** 0
@@ -745,23 +775,6 @@ Below is a detailed breakdown of conformance issues and missing properties for e
 
 </details>
 
-### Models
-
-**Score:** 93.3% · **Issues:** 1 · **Missing:** 0
-
-#### `/models/{model}`
-
-**GET**
-
-<details>
-<summary>Schema Issues (1)</summary>
-
-| Property | Issues |
-|----------|--------|
-| `responses.200.content.application/json.properties.owned_by` | Default changed: None -&gt; ogx |
-
-</details>
-
 ### Chat
 
 **Score:** 98.7% · **Issues:** 5 · **Missing:** 1