feat(api)!: support extra_body to embeddings and vector_stores APIs (#3794)

Applies the same pattern from
https://github.com/llamastack/llama-stack/pull/3777 to embeddings and
vector_stores.create() endpoints.

This should _not_ be a breaking change since (a) our tests were already
using the `extra_body` parameter when passing in to the backend (b) but
the backend probably wasn't extracting the parameters correctly. This PR
will fix that.

Updated APIs: `openai_embeddings(), openai_create_vector_store(),
openai_create_vector_store_file_batch()`

docs/static/stainless-llama-stack-spec.yaml

@@ -620,7 +620,7 @@ paths:
         content:
           application/json:
             schema:
-              $ref: '#/components/schemas/OpenaiEmbeddingsRequest'
+              $ref: '#/components/schemas/OpenAIEmbeddingsRequestWithExtraBody'
         required: true
       deprecated: false
   /v1/files:
@@ -2416,13 +2416,16 @@ paths:
       tags:
         - VectorIO
       summary: Creates a vector store.
-      description: Creates a vector store.
+      description: >-
+        Creates a vector store.
+
+        Generate an OpenAI-compatible vector store with the given parameters.
       parameters: []
       requestBody:
         content:
           application/json:
             schema:
-              $ref: '#/components/schemas/OpenaiCreateVectorStoreRequest'
+              $ref: '#/components/schemas/OpenAICreateVectorStoreRequestWithExtraBody'
         required: true
       deprecated: false
   /v1/vector_stores/{vector_store_id}:
@@ -2548,7 +2551,11 @@ paths:
       tags:
         - VectorIO
       summary: Create a vector store file batch.
-      description: Create a vector store file batch.
+      description: >-
+        Create a vector store file batch.
+
+        Generate an OpenAI-compatible vector store file batch for the given vector
+        store.
       parameters:
         - name: vector_store_id
           in: path
@@ -2561,7 +2568,7 @@ paths:
         content:
           application/json:
             schema:
-              $ref: '#/components/schemas/OpenaiCreateVectorStoreFileBatchRequest'
+              $ref: '#/components/schemas/OpenAICreateVectorStoreFileBatchRequestWithExtraBody'
         required: true
       deprecated: false
   /v1/vector_stores/{vector_store_id}/file_batches/{batch_id}:
@@ -6242,7 +6249,7 @@ components:
         - deleted
       title: ConversationItemDeletedResource
       description: Response for deleted conversation item.
-    OpenaiEmbeddingsRequest:
+    OpenAIEmbeddingsRequestWithExtraBody:
       type: object
       properties:
         model:
@@ -6261,6 +6268,7 @@ components:
             multiple inputs in a single request, pass an array of strings.
         encoding_format:
           type: string
+          default: float
           description: >-
             (Optional) The format to return the embeddings in. Can be either "float"
             or "base64". Defaults to "float".
@@ -6278,7 +6286,9 @@ components:
       required:
         - model
         - input
-      title: OpenaiEmbeddingsRequest
+      title: OpenAIEmbeddingsRequestWithExtraBody
+      description: >-
+        Request parameters for OpenAI-compatible embeddings endpoint.
     OpenAIEmbeddingData:
       type: object
       properties:
@@ -11057,19 +11067,18 @@ components:
         - metadata
       title: VectorStoreObject
       description: OpenAI Vector Store object.
-    OpenaiCreateVectorStoreRequest:
+    "OpenAICreateVectorStoreRequestWithExtraBody":
       type: object
       properties:
         name:
           type: string
-          description: A name for the vector store.
+          description: (Optional) A name for the vector store
         file_ids:
           type: array
           items:
             type: string
           description: >-
-            A list of File IDs that the vector store should use. Useful for tools
-            like `file_search` that can access files.
+            List of file IDs to include in the vector store
         expires_after:
           type: object
           additionalProperties:
@@ -11081,7 +11090,7 @@ components:
               - type: array
               - type: object
           description: >-
-            The expiration policy for a vector store.
+            (Optional) Expiration policy for the vector store
         chunking_strategy:
           type: object
           additionalProperties:
@@ -11093,8 +11102,7 @@ components:
               - type: array
               - type: object
           description: >-
-            The chunking strategy used to chunk the file(s). If not set, will use
-            the `auto` strategy.
+            (Optional) Strategy for splitting files into chunks
         metadata:
           type: object
           additionalProperties:
@@ -11106,21 +11114,12 @@ components:
               - type: array
               - type: object
           description: >-
-            Set of 16 key-value pairs that can be attached to an object.
-        embedding_model:
-          type: string
-          description: >-
-            The embedding model to use for this vector store.
-        embedding_dimension:
-          type: integer
-          description: >-
-            The dimension of the embedding vectors (default: 384).
-        provider_id:
-          type: string
-          description: >-
-            The ID of the provider to use for this vector store.
+            Set of key-value pairs that can be attached to the vector store
       additionalProperties: false
-      title: OpenaiCreateVectorStoreRequest
+      title: >-
+        OpenAICreateVectorStoreRequestWithExtraBody
+      description: >-
+        Request to create a vector store with extra_body support.
     OpenaiUpdateVectorStoreRequest:
       type: object
       properties:
@@ -11241,7 +11240,7 @@ components:
       title: VectorStoreChunkingStrategyStaticConfig
       description: >-
         Configuration for static chunking strategy.
-    OpenaiCreateVectorStoreFileBatchRequest:
+    "OpenAICreateVectorStoreFileBatchRequestWithExtraBody":
       type: object
       properties:
         file_ids:
@@ -11249,7 +11248,7 @@ components:
           items:
             type: string
           description: >-
-            A list of File IDs that the vector store should use.
+            A list of File IDs that the vector store should use
         attributes:
           type: object
           additionalProperties:
@@ -11261,16 +11260,19 @@ components:
               - type: array
               - type: object
           description: >-
-            (Optional) Key-value attributes to store with the files.
+            (Optional) Key-value attributes to store with the files
         chunking_strategy:
           $ref: '#/components/schemas/VectorStoreChunkingStrategy'
           description: >-
             (Optional) The chunking strategy used to chunk the file(s). Defaults to
-            auto.
+            auto
       additionalProperties: false
       required:
         - file_ids
-      title: OpenaiCreateVectorStoreFileBatchRequest
+      title: >-
+        OpenAICreateVectorStoreFileBatchRequestWithExtraBody
+      description: >-
+        Request to create a vector store file batch with extra_body support.
     VectorStoreFileBatchObject:
       type: object
       properties: