feature #1689 [Platform][ModelsDev] Add well-known base URLs for providers with dedicated npm packages (fabpot)

This PR was squashed before being merged into the main branch.

Discussion
----------

[Platform][ModelsDev] Add well-known base URLs for providers with dedicated npm packages

| Q             | A
| ------------- | ---
| Bug fix?      | no
| New feature?  | yes <!-- please update src/**/CHANGELOG.md files -->
| Docs?         | no <!-- required for new features -->
| Issues        | n/a
| License       | MIT

<!--
Replace this notice by a description of your feature/bugfix.
This will help reviewers and should be a good start for the documentation.

Additionally (see https://symfony.com/releases):
 - Always add tests and ensure they pass.
 - For new features, provide some code snippets to help understand usage.
 - Features and deprecations must be submitted against branch main.
 - Update/add documentation as required (we can help!)
 - Changelog entry should follow https://symfony.com/doc/current/contributing/code/conventions.html#writing-a-changelog-entry
 - Never break backward compatibility (see https://symfony.com/bc).
-->

Commits
-------

c110084 [Platform][ModelsDev] Add well-known base URLs for providers with dedicated npm packages

Author: OskarStark

src/platform/src/Bridge/ModelsDev/CHANGELOG.md

@@ -1,6 +1,11 @@
 CHANGELOG
 ---------
 
+0.5
+---
+
+ * Add well-known base URLs for providers with dedicated npm packages
+
 0.4
 ---
 

src/platform/src/Bridge/ModelsDev/PlatformFactory.php

@@ -28,6 +28,25 @@
  */
 final class PlatformFactory
 {
+    /**
+     * Well-known API base URLs for providers whose models.dev entry
+     * omits the "api" field because the Vercel AI SDK hardcodes the
+     * URL inside their dedicated npm packages.
+     *
+     * @var array<string, string> npm package => base URL
+     */
+    private const NPM_PACKAGE_BASE_URLS = [
+        '@ai-sdk/cerebras' => 'https://api.cerebras.ai',
+        '@ai-sdk/cohere' => 'https://api.cohere.com/compatibility',
+        '@ai-sdk/deepinfra' => 'https://api.deepinfra.com/v1/openai',
+        '@ai-sdk/groq' => 'https://api.groq.com/openai',
+        '@ai-sdk/mistral' => 'https://api.mistral.ai',
+        '@ai-sdk/openai' => 'https://api.openai.com',
+        '@ai-sdk/perplexity' => 'https://api.perplexity.ai',
+        '@ai-sdk/togetherai' => 'https://api.together.xyz',
+        '@ai-sdk/xai' => 'https://api.x.ai',
+    ];
+
     public static function create(
         string $provider,
         #[\SensitiveParameter] ?string $apiKey = null,
@@ -75,7 +94,13 @@ public static function create(
         }
 
         // Use the generic OpenAI-compatible bridge
-        if ((null === $baseUrl) && null === $baseUrl = (new ProviderRegistry($dataPath))->getApiBaseUrl($provider)) {
+        if (null === $baseUrl) {
+            $baseUrl = (new ProviderRegistry($dataPath))->getApiBaseUrl($provider);
+        }
+        if (null === $baseUrl && null !== $npmPackage) {
+            $baseUrl = self::NPM_PACKAGE_BASE_URLS[$npmPackage] ?? null;
+        }
+        if (null === $baseUrl) {
             throw new InvalidArgumentException(\sprintf('Provider "%s" does not have a known API base URL; please provide one via the $baseUrl argument.', $provider));
         }
 

src/platform/src/Bridge/ModelsDev/Tests/PlatformFactoryTest.php

@@ -45,26 +45,25 @@ public function testCreateWithExplicitBaseUrl()
         $this->assertInstanceOf(Platform::class, $platform);
     }
 
-    public function testCreateThrowsWhenNoBaseUrlAvailable()
+    public function testCreateWithWellKnownNpmPackageProvider()
     {
-        $this->expectException(InvalidArgumentException::class);
-        $this->expectExceptionMessage('does not have a known API base URL');
-
-        PlatformFactory::create(
+        $platform = PlatformFactory::create(
             provider: 'openai',
             apiKey: 'test-key',
         );
+
+        $this->assertInstanceOf(Platform::class, $platform);
     }
 
-    public function testCreateWithGroq()
+    public function testCreateThrowsWhenNoBaseUrlAvailable()
     {
-        $platform = PlatformFactory::create(
-            provider: 'groq',
+        $this->expectException(InvalidArgumentException::class);
+        $this->expectExceptionMessage('does not have a known API base URL');
+
+        PlatformFactory::create(
+            provider: 'azure',
             apiKey: 'test-key',
-            baseUrl: 'https://api.groq.com/openai/v1',
         );
-
-        $this->assertInstanceOf(Platform::class, $platform);
     }
 
     public function testCreateWithProviderHavingApiUrl()