doc: Update readme

Author: osugikoji

README.md

@@ -85,6 +85,7 @@ try {
 
 ### Features
 
+- [ListModels](guides/Features.md#listmodels)
 - [Completions](guides/Features.md#completion)
 - [ChatCompletions](guides/Features.md#chatcompletions)
 - [ImageGenerations](guides/Features.md#imagegenerations)

guides/Features.md

@@ -1,10 +1,44 @@
 # Features
 
+- [ListModels](#listModels)
 - [Completion](#completion)
 - [ChatCompletions](#chatcompletions)
 - [ImageGenerations](#imagegenerations)
 - [Edits](#edits)
 
+## ListModels
+
+The listModels api lists the currently available models, and provides basic information about each one such as the owner and availability.
+
+### Swift
+
+```swift
+var yChat: YChat {
+    YChatCompanion.shared.create(apiKey: "your-api-key") 
+}
+
+do {
+  let result = try await yChat.listModels().execute()
+} catch {
+  // catch any error that may occurs on api call.  
+}
+```
+
+### Kotlin
+
+```kotlin
+val yChat by lazy {
+    YChat.create("your-api-key")
+}
+
+try {
+    val result = yChat.listModels().execute()
+
+} catch (e: exception) {
+    // catch any error that may occurs on api call.  
+}
+```
+
 ## Completion
 
 The completions api can be used for a wide variety of tasks. You input some text as a prompt, and the model will generate a text completion that attempts to match whatever context or pattern you gave it. For example, if you give the API the prompt, "As Descartes said, I think, therefore", it will return the completion " I am" with high probability.