🎉 🚀

Author: level7up

.vscode/settings.json

@@ -0,0 +1,21 @@
+{
+  "workbench.colorCustomizations": {
+    "activityBar.activeBackground": "#3a0000",
+    "activityBar.background": "#3a0000",
+    "activityBar.foreground": "#e7e7e7",
+    "activityBar.inactiveForeground": "#e7e7e799",
+    "activityBarBadge.background": "#006000",
+    "activityBarBadge.foreground": "#e7e7e7",
+    "commandCenter.border": "#e7e7e799",
+    "sash.hoverBorder": "#3a0000",
+    "statusBar.background": "#070000",
+    "statusBar.foreground": "#e7e7e7",
+    "statusBarItem.hoverBackground": "#3a0000",
+    "statusBarItem.remoteBackground": "#070000",
+    "statusBarItem.remoteForeground": "#e7e7e7",
+    "titleBar.activeBackground": "#070000",
+    "titleBar.activeForeground": "#e7e7e7",
+    "titleBar.inactiveBackground": "#07000099",
+    "titleBar.inactiveForeground": "#e7e7e799"
+  }
+}

README.md

@@ -0,0 +1,103 @@
+# OpenRouter Client for Laravel
+
+A simple Laravel wrapper for the [OpenRouter API](https://openrouter.ai/) to easily perform chat completions using models like `openai/gpt-4o`.
+
+---
+
+## 🧰 Features
+
+- Easy integration with Laravel via Service Provider
+- Customizable via `.env` or `config/openrouter.php`
+- Uses Guzzle for HTTP requests
+- Supports `max_tokens` for response control
+
+---
+
+## 🚀 Installation
+
+Require the package via Composer:
+
+```bash
+composer require level7up/openrouter-client
+```
+
+---
+
+## 🛠 Configuration
+
+Publish the configuration file:
+
+```bash
+php artisan vendor:publish --tag=config
+```
+
+Add your credentials to `.env`:
+
+```env
+OPENROUTER_API_KEY=your_openrouter_api_key
+OPENROUTER_BASE_URL=https://openrouter.ai/api/v1
+OPENROUTER_REFERER=https://your-site.com        # optional
+OPENROUTER_SITE_TITLE=Your Site Name            # optional
+```
+
+---
+
+## 🧪 Usage
+
+Inject the client into your controller or service:
+
+```php
+use Level7up\OpenRouter\OpenRouterClient;
+
+class ChatController extends Controller
+{
+    public function ask(OpenRouterClient $client)
+    {
+        $response = $client->getCompletion('Tell me a joke.', 50);
+        return response()->json(['reply' => $response]);
+    }
+}
+```
+
+---
+
+## ⚙️ Configuration File
+
+After publishing, you can modify `config/openrouter.php`:
+
+```php
+return [
+    'api_key'    => env('OPENROUTER_API_KEY'),
+    'base_url'   => env('OPENROUTER_BASE_URL', 'https://openrouter.ai/api/v1'),
+    'referer'    => env('OPENROUTER_REFERER'),
+    'site_title' => env('OPENROUTER_SITE_TITLE'),
+];
+```
+
+---
+
+## 📚 API Reference
+
+### `getCompletion(string $prompt, int $maxTokens = 100): ?string`
+
+Sends a prompt to the OpenRouter API and returns the response string.
+
+---
+
+## ✅ Requirements
+
+- PHP 8.0+
+- Laravel 8+
+- Guzzle 7+
+
+---
+
+## 📄 License
+
+This package is open-sourced software licensed under the [MIT license](LICENSE).
+
+---
+
+## 🧠 About
+
+Maintained by [Level7up](https://github.com/level7up). Contributions and issues are welcome!

composer.json

@@ -0,0 +1,22 @@
+{
+  "name": "level7up/openrouter-client",
+  "description": "OpenRouter API client for Laravel",
+  "type": "library",
+  "license": "MIT",
+  "autoload": {
+    "psr-4": {
+      "OpenRouter\\": "src/"
+    }
+  },
+  "extra": {
+    "laravel": {
+      "providers": [
+        "Level7up\\OpenRouter\\OpenRouterServiceProvider"
+      ]
+    }
+  },
+  "require": {
+    "php": "^8.0",
+    "guzzlehttp/guzzle": "^7.0|^8.0"
+  }
+}

config/openrouter.php

@@ -0,0 +1,5 @@
+<?php
+return [
+    'api_key'    => env('OPENROUTER_API_KEY'),
+    'base_url'   => env('OPENROUTER_BASE_URL', 'https://openrouter.ai/api/v1'),
+];

src/OpenRouterClient.php

@@ -0,0 +1,49 @@
+<?php
+
+namespace Level7up\OpenRouter;
+
+use GuzzleHttp\Client;
+use GuzzleHttp\Exception\GuzzleException;
+
+class OpenRouterClient
+{
+    protected Client $client;
+    protected string $apiKey;
+    protected string $baseUrl;
+
+    public function __construct()
+    {
+        $this->client = new Client();
+        $this->apiKey = env('OPENROUTER_API_KEY');
+        $this->baseUrl = 'https://openrouter.ai/api/v1';
+    }
+
+    public function getCompletion(string $prompt): ?string
+    {
+        try {
+            $headers = [
+                'Authorization' => 'Bearer ' . $this->apiKey,
+                'Content-Type' => 'application/json',
+            ];
+
+            $response = $this->client->post("{$this->baseUrl}/chat/completions", [
+                'headers' => $headers,
+                'json' => [
+                    'model' => 'mistralai/mistral-7b-instruct:free',
+                    'messages' => [
+                        [
+                            'role' => 'user',
+                            'content' => $prompt,
+                        ],
+                    ],
+                ],
+            ]);
+
+            $data = json_decode($response->getBody(), true);
+            return $data['choices'][0]['message']['content'] ?? null;
+
+        } catch (GuzzleException $e) {
+            throw new \RuntimeException('OpenRouter request failed: ' . $e->getMessage(), 0, $e);
+        }
+    }
+}

src/OpenRouterServiceProvider.php

@@ -0,0 +1,25 @@
+<?php
+declare(strict_types=1);
+
+namespace Level7up\OpenRouter;
+
+use Illuminate\Support\ServiceProvider;
+
+class OpenRouterServiceProvider extends ServiceProvider
+{
+    public function register()
+    {
+        $this->mergeConfigFrom(__DIR__ . '/../config/openrouter.php', 'openrouter');
+
+        $this->app->singleton(OpenRouterClient::class, function ($app) {
+            return new OpenRouterClient(config('openrouter'));
+        });
+    }
+
+    public function boot()
+    {
+        $this->publishes([
+            __DIR__ . '/../config/openrouter.php' => config_path('openrouter.php'),
+        ], 'config');
+    }
+}