feat(api): add latest stable/preview version helper methods (#226)

* feat(api): add latest stable/preview version helper method

* add latestVersion to support the latest date version

* revert last commit with latest date changes

* fix the lint error

Author: mssfang

openai-java-core/src/main/kotlin/com/openai/azure/AzureOpenAIServiceVersion.kt

@@ -8,6 +8,18 @@ class AzureOpenAIServiceVersion private constructor(@get:JvmName("value") val va
         private val values: ConcurrentHashMap<String, AzureOpenAIServiceVersion> =
             ConcurrentHashMap()
 
+        @JvmStatic
+        fun latestStableVersion(): AzureOpenAIServiceVersion {
+            // We can update the value every general available(GA)/stable announcement.
+            return V2024_10_21
+        }
+
+        @JvmStatic
+        fun latestPreviewVersion(): AzureOpenAIServiceVersion {
+            // We can update the value every preview announcement.
+            return V2025_01_01_PREVIEW
+        }
+
         @JvmStatic
         fun fromString(version: String): AzureOpenAIServiceVersion =
             values.computeIfAbsent(version) { AzureOpenAIServiceVersion(version) }

openai-java-core/src/main/kotlin/com/openai/core/ClientOptions.kt

@@ -4,7 +4,6 @@ package com.openai.core
 
 import com.fasterxml.jackson.databind.json.JsonMapper
 import com.openai.azure.AzureOpenAIServiceVersion
-import com.openai.azure.AzureOpenAIServiceVersion.Companion.V2024_10_21
 import com.openai.azure.credential.AzureApiKeyCredential
 import com.openai.core.http.Headers
 import com.openai.core.http.HttpClient
@@ -261,8 +260,10 @@ private constructor(
             if (isAzureEndpoint(baseUrl)) {
                 // Default Azure OpenAI version is used if Azure user doesn't
                 // specific a service API version in 'queryParams'.
-                // We can update the default value every major announcement if needed.
-                replaceQueryParams("api-version", (azureServiceVersion ?: V2024_10_21).value)
+                replaceQueryParams(
+                    "api-version",
+                    (azureServiceVersion ?: AzureOpenAIServiceVersion.latestStableVersion()).value,
+                )
             }
 
             headers.replaceAll(this.headers.build())