Merge remote-tracking branch 'origin/main'

Author: Layoric

MyApp/Pages/Index.cshtml

@@ -110,26 +110,26 @@
             </div>
 
             <div class="text-center sm:col-span-6">
-                <a href="https://servicestack.net/creatorkit/">
+                <a href="/ai-server/">
                     <div class="text-center">
-                        <svg class="w-20 h-20 inline-block text-indigo-600" xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24"><path fill="currentColor" d="M13 23V13h10v10H13Zm1.5-1.5h7v-.8q-.625-.775-1.525-1.238T18 19q-1.075 0-1.975.463T14.5 20.7v.8ZM18 18q.625 0 1.063-.438T19.5 16.5q0-.625-.438-1.063T18 15q-.625 0-1.063.438T16.5 16.5q0 .625.438 1.063T18 18Zm-8.75 4l-.4-3.2q-.325-.125-.613-.3t-.562-.375L4.7 19.375l-2.75-4.75l2.575-1.95Q4.5 12.5 4.5 12.337v-.674q0-.163.025-.338L1.95 9.375l2.75-4.75l2.975 1.25q.275-.2.575-.375t.6-.3l.4-3.2h5.5l.4 3.2q.325.125.613.3t.562.375l2.975-1.25l2.75 4.75L19.925 11H15.4q-.35-1.075-1.25-1.788t-2.1-.712q-1.45 0-2.475 1.025T8.55 12q0 1.2.675 2.1T11 15.35V22H9.25Z"></path></svg>
+                        <svg class="w-20 h-20 inline-block text-indigo-600" xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path fill="none" stroke="currentColor" stroke-linecap="round" stroke-linejoin="round" stroke-width="1.5" d="M17.478 8h.022a4.5 4.5 0 0 1 2.5 8.242M17.478 8q.021-.247.022-.5a5.5 5.5 0 0 0-10.98-.477M17.478 8a5.5 5.5 0 0 1-.578 2M6.52 7.023a5 5 0 0 0-2.168 9.22m2.168-9.22Q6.757 7 7 7c1.126 0 2.165.372 3 1m3 6h-2c-.943 0-1.414 0-1.707.293S9 15.057 9 16v2c0 .943 0 1.414.293 1.707S10.057 20 11 20h2c.943 0 1.414 0 1.707-.293S15 18.943 15 18v-2c0-.943 0-1.414-.293-1.707S13.943 14 13 14m-2.5 6v2m3-2v2m-3-10v2m3-2v2M9 15.5H7m2 3H7m10-3h-2m2 3h-2" color="currentColor"/></svg>
                     </div>
-                    <h3 class="text-lg font-semibold leading-7 text-gray-900 dark:text-gray-50">Creator Kit</h3>
+                    <h3 class="text-lg font-semibold leading-7 text-gray-900 dark:text-gray-50">AI Server</h3>
                 </a>
                 <p class="text-base leading-7 text-gray-600 dark:text-gray-300">
-                    Add Mailchimp and Disqus features to any website
+                    Unified APIs for LLM APIs, Ollama, ComfyUI & FFmpeg
                 </p>
             </div>
 
             <div class="text-center sm:col-span-6">
-                <a href="https://razor-press.web-templates.io">
+                <a href="https://servicestack.net/creatorkit/">
                     <div class="text-center">
-                        <svg class="w-20 h-20 inline-block text-indigo-600" xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24"><path fill="none" stroke="currentColor" stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M3 19a9 9 0 0 1 9 0a9 9 0 0 1 9 0M3 6a9 9 0 0 1 9 0a9 9 0 0 1 9 0M3 6v13m9-13v13m9-13v13"></path></svg>
+                        <svg class="w-20 h-20 inline-block text-indigo-600" xmlns="http://www.w3.org/2000/svg" width="24" height="24" viewBox="0 0 24 24"><path fill="currentColor" d="M13 23V13h10v10H13Zm1.5-1.5h7v-.8q-.625-.775-1.525-1.238T18 19q-1.075 0-1.975.463T14.5 20.7v.8ZM18 18q.625 0 1.063-.438T19.5 16.5q0-.625-.438-1.063T18 15q-.625 0-1.063.438T16.5 16.5q0 .625.438 1.063T18 18Zm-8.75 4l-.4-3.2q-.325-.125-.613-.3t-.562-.375L4.7 19.375l-2.75-4.75l2.575-1.95Q4.5 12.5 4.5 12.337v-.674q0-.163.025-.338L1.95 9.375l2.75-4.75l2.975 1.25q.275-.2.575-.375t.6-.3l.4-3.2h5.5l.4 3.2q.325.125.613.3t.562.375l2.975-1.25l2.75 4.75L19.925 11H15.4q-.35-1.075-1.25-1.788t-2.1-.712q-1.45 0-2.475 1.025T8.55 12q0 1.2.675 2.1T11 15.35V22H9.25Z"></path></svg>
                     </div>
-                    <h3 class="text-lg font-semibold leading-7 text-gray-900 dark:text-gray-50">Razor Press</h3>
+                    <h3 class="text-lg font-semibold leading-7 text-gray-900 dark:text-gray-50">Creator Kit</h3>
                 </a>
                 <p class="text-base leading-7 text-gray-600 dark:text-gray-300">
-                    Static Site Generator for fast Documentation
+                    Add Mailchimp and Disqus features to any website
                 </p>
             </div>
 

MyApp/Pages/Shared/Header.cshtml

@@ -8,7 +8,8 @@
         ("/ormlite/", "OrmLite"),
         ("/redis/", "Redis"),
         ("/locode/", "Locode"),
-        ("/grpc/", "gRPC")
+        ("/grpc/", "gRPC"),
+        ("/ai-server/", "AI Server")
     };
 }
 <header id="header" class="top-0 fixed z-50 h-14 bg-white dark:bg-black opacity-90 w-full shadow">

MyApp/_includes/npx-get-dtos.md

@@ -0,0 +1,15 @@
+### Alternative (without .NET): npx get-dtos
+
+Alternatively API consumers can use [npx get-dtos](/npx-get-dtos) to Add/Update ServiceStack References without needing .NET installed, where any command starting with:
+
+```txt
+x <lang>
+```
+
+Can be replaced with:
+
+```txt
+npx get-dtos <lang>
+```
+
+To instead Add / Update ServiceStack references using the npm get-dtos package.

MyApp/_pages/add-servicestack-reference.md

@@ -140,6 +140,8 @@ The [x dotnet tool](/dotnet-tool) provides simple command-line utilities to easi
 dotnet tool install --global x 
 :::
 
+::include npx-get-dtos.md::
+
 This will make the following utilities available from your command-line which will let you download the Server DTO classes for a remote ServiceStack endpoint in your chosen language which you can use with ServiceStack's generic Service clients to be able to make end-to-end API calls.
 
 <table class="table table-bordered">
@@ -390,6 +392,119 @@ in the right-click context menu:
 
 If you're updating references frequently you can save time by [assigning it a keyboard shortcut](https://www.jetbrains.com/help/rider/Configuring_Keyboard_and_Mouse_Shortcuts.html).
 
+
+## Multiple File Upload Support with API Requests supported in all languages
+
+To be able to call [AI Server](/ai-server/) APIs requiring file uploads we've added multiple file upload support with API Requests to the generic service clients for all our supported languages.
+
+Here's what that looks like for different languages calling AI Server's `SpeechToText` API:
+
+### C# Speech to Text
+
+```csharp
+using var fsAudio = File.OpenRead("audio.wav");
+var response = client.PostFileWithRequest(new SpeechToText(),
+    new UploadFile("audio.wav", fsAudio, "audio"));
+```
+
+### Dart Speech to Text
+
+```dart
+var audioFile = new File('audio.wav');
+var uploadFile = new UploadFile(
+    fieldName: 'audio',
+    fileName: audioFile.uri.pathSegments.last,
+    contentType: 'audio/wav',
+    contents: await audioFile.readAsBytes()
+);
+
+var response = await client.postFileWithRequest(new SpeechToText(), uploadFile);
+```
+
+### Python Speech to Text
+
+```python
+with open("files/audio.wav", "rb") as audio:
+  response = client.post_file_with_request(SpeechToText(), 
+    UploadFile(field_name="audio", file_name="audio.wav", content_type="audio/wav", stream=audio))
+```
+
+### PHP Speech to Text
+
+```php
+$audioFile = __DIR__ . '/files/audio.wav';
+
+/** @var GenerationResponse $response */
+$response = $client->postFileWithRequest(new SpeechToText(),
+    new UploadFile(
+        filePath: $audioFile,
+        fileName: 'audio.wav',
+        fieldName: 'audio',
+        contentType: 'audio/wav'
+    ));
+```
+
+### Swift Speech to Text
+
+```swift
+guard let audioURL = Bundle.module.url(forResource: "audio.wav", withExtension: nil) else {
+    return
+}
+
+let audioData = try Data(contentsOf: audioURL)
+let response: TextGenerationResponse = try await client.postFileWithRequestAsync(
+    request:SpeechToText(), 
+    file:UploadFile(fileName: "audio.wav", data:audioData, fieldName:"audio"))
+```
+
+### Kotlin Speech to Text
+
+```kotlin
+val audioBytes = Files.readAllBytes(Paths.get("audio.wav"))
+val response = client.postFileWithRequest(SpeechToText(),
+    UploadFile("audio", "audio.wav", "audio/wav", audioBytes))
+```
+
+### Java Speech to Text
+
+```java
+byte[] audioBytes = Files.readAllBytes(Paths.get("audio.wav"));
+var response = client.postFileWithRequest(request,
+    new UploadFile("audio", "audio.wav", "audio/wav", audioBytes));
+```
+
+### TypeScript Speech to Text
+
+```js
+// Create FormData and append the file
+const formData = new FormData()
+const audioFile = fs.readFileSync('audio.wav')
+const blob = new Blob([audioFile], { type: 'audio/wav' })
+
+// Explicitly set the field name as 'audio'
+formData.append('audio', blob, 'audio.wav')
+
+const api = await client.apiForm(new SpeechToText(), formData)
+```
+
+### Multiple File Uploads
+
+All languages also support a `postFilesWithRequest` variant for uploading multiple files with an API Request.
+E.g. here's an example of using `PostFilesWithRequest` to generate a video with a Watermark:
+
+### C# Watermark Video
+
+```csharp
+using var fsVideo = File.OpenRead("video.mp4");
+using var fsWatermark = File.OpenRead("watermark.png");
+var response = client.PostFilesWithRequest(new QueueWatermarkVideo {
+        Position = WatermarkPosition.BottomRight
+    }, [
+        new UploadFile("video.mp4", fsVideo, "video"),
+        new UploadFile("watermark.png", fsWatermark, "watermark")
+    ]);
+```
+
 ## Advantages over WCF
 
  - **Simple** Server provides DTOs based on metadata and options provided. No heavy client side tools, just a HTTP request!