Add dimensions option for ZhiPuAi embedding model

 - Add dimentions options
 - Add doc for ZhiPuAi embedding dimensions option

Signed-off-by: Assassinxc <[email protected]>

Author: Assassinxc

models/spring-ai-zhipuai/src/main/java/org/springframework/ai/zhipuai/ZhiPuAiEmbeddingModel.java

@@ -224,11 +224,13 @@ private ZhiPuAiEmbeddingOptions mergeOptions(@Nullable EmbeddingOptions runtimeO
 
 		return ZhiPuAiEmbeddingOptions.builder()
 			.model(ModelOptionsUtils.mergeOption(runtimeOptionsForProvider.getModel(), defaultOptions.getModel()))
+			.dimensions(ModelOptionsUtils.mergeOption(runtimeOptionsForProvider.getDimensions(),
+					defaultOptions.getDimensions()))
 			.build();
 	}
 
 	private ZhiPuAiApi.EmbeddingRequest<String> createEmbeddingRequest(String text, EmbeddingOptions requestOptions) {
-		return new ZhiPuAiApi.EmbeddingRequest<>(text, requestOptions.getModel());
+		return new ZhiPuAiApi.EmbeddingRequest<>(text, requestOptions.getModel(), requestOptions.getDimensions());
 	}
 
 	public void setObservationConvention(EmbeddingModelObservationConvention observationConvention) {

models/spring-ai-zhipuai/src/main/java/org/springframework/ai/zhipuai/ZhiPuAiEmbeddingOptions.java

@@ -39,6 +39,10 @@ public class ZhiPuAiEmbeddingOptions implements EmbeddingOptions {
 	 * ID of the model to use.
 	 */
 	private @JsonProperty("model") String model;
+	/**
+	 * Dimension value of the model to use.
+	 */
+	private @JsonProperty("dimensions") Integer dimensions;
 	// @formatter:on
 
 	public static Builder builder() {
@@ -54,6 +58,10 @@ public void setModel(String model) {
 		this.model = model;
 	}
 
+	public void setDimensions(Integer dimensions) {
+		this.dimensions = dimensions;
+	}
+
 	@Override
 	@JsonIgnore
 	public Integer getDimensions() {
@@ -73,6 +81,11 @@ public Builder model(String model) {
 			return this;
 		}
 
+		public Builder dimensions(Integer dimensions) {
+			this.options.setDimensions(dimensions);
+			return this;
+		}
+
 		public ZhiPuAiEmbeddingOptions build() {
 			return this.options;
 		}

models/spring-ai-zhipuai/src/main/java/org/springframework/ai/zhipuai/api/ZhiPuAiApi.java

@@ -295,7 +295,12 @@ public enum EmbeddingModel {
 		/**
 		 * DIMENSION: 1024
 		 */
-		Embedding_2("Embedding-2");
+		Embedding_2("Embedding-2"),
+
+		/**
+		 * DIMENSION: up to 2048
+		 */
+		Embedding_3("Embedding-3");
 
 		public final String  value;
 
@@ -956,15 +961,27 @@ public String toString() {
 	@JsonInclude(Include.NON_NULL)
 	public record EmbeddingRequest<T>(
 			@JsonProperty("input") T input,
-			@JsonProperty("model") String model) {
+			@JsonProperty("model") String model,
+			@JsonProperty("dimensions") Integer dimensions) {
 
 
 		/**
-		 * Create an embedding request with the given input. Encoding model is set to 'embedding-2'.
-		 * @param input Input text to embed.
-		 */
+         * Create an embedding request with the given input. Encoding model is set to 'embedding-2'.
+         *
+         * @param input Input text to embed.
+         */
 		public EmbeddingRequest(T input) {
-			this(input, DEFAULT_EMBEDDING_MODEL);
+			this(input, DEFAULT_EMBEDDING_MODEL,null);
+		}
+
+		/**
+		 * Create an embedding request with the given input and model.
+		 *
+		 * @param input
+		 * @param model
+		 */
+		public EmbeddingRequest(T input, String model) {
+			this(input, model,null);
 		}
 	}
 

models/spring-ai-zhipuai/src/test/java/org/springframework/ai/zhipuai/api/ZhiPuAiApiIT.java

@@ -83,4 +83,15 @@ void embeddings() {
 		assertThat(response.getBody().data().get(0).embedding()).hasSize(1024);
 	}
 
+	@Test
+	void embeddingsWithDimensions() {
+		ResponseEntity<EmbeddingList<Embedding>> response = this.zhiPuAiApi
+			.embeddings(new ZhiPuAiApi.EmbeddingRequest<>("Hello world",
+					ZhiPuAiApi.EmbeddingModel.Embedding_3.getValue(), 1536));
+
+		assertThat(response).isNotNull();
+		assertThat(Objects.requireNonNull(response.getBody()).data()).hasSize(1);
+		assertThat(response.getBody().data().get(0).embedding()).hasSize(1536);
+	}
+
 }

spring-ai-docs/src/main/antora/modules/ROOT/pages/api/embeddings/zhipuai-embeddings.adoc

@@ -91,6 +91,7 @@ The prefix `spring.ai.zhipuai.embedding` is property prefix that configures the
 | spring.ai.zhipuai.embedding.base-url   | Optional overrides the spring.ai.zhipuai.base-url to provide embedding specific url | -
 | spring.ai.zhipuai.embedding.api-key    | Optional overrides the spring.ai.zhipuai.api-key to provide embedding specific api-key  | -
 | spring.ai.zhipuai.embedding.options.model      | The model to use      | embedding-2
+| spring.ai.zhipuai.embedding.options.dimensions      | The number of dimensions, the default value is 2048 when the model is embedding-3 | -
 |====
 
 NOTE: You can override the common `spring.ai.zhipuai.base-url` and `spring.ai.zhipuai.api-key` for the `ChatModel` and `EmbeddingModel` implementations.
@@ -185,7 +186,8 @@ var zhiPuAiApi = new ZhiPuAiApi(System.getenv("ZHIPU_AI_API_KEY"));
 
 var embeddingModel = new ZhiPuAiEmbeddingModel(api, MetadataMode.EMBED,
 				ZhiPuAiEmbeddingOptions.builder()
-						.model("embedding-2")
+						.model("embedding-3")
+						.dimensions(1536)
 						.build());
 
 EmbeddingResponse embeddingResponse = this.embeddingModel