rodiumai/laravel-sdk

SDK PHP / Laravel officiel pour l’API Rodium AI — accès unifié aux modèles IA (OpenAI, Anthropic, Google, DeepSeek, MiniMax…) avec facturation en crédits RODI et recharge Mobile Money.

API REST compatible OpenAI : mêmes endpoints et payloads que rodiumai.io/docs.

Liens

Table des matières

• Documentation officielle
• Prérequis
• Installation
• Configuration
• Démarrage rapide
• Modèles typés (enum)
• Paramètres chat
• Streaming (SSE)
• Liste des modèles
• Gestion des erreurs
• Référence SDK
• Tests & développement
• Contribuer
• Licence

Documentation officielle

Alignement détaillé SDK ↔ API : docs/api-alignment.md.

Prérequis

• PHP 8.1+ avec extension json
• Laravel 10, 11 ou 12 (optionnel — le client fonctionne en PHP pur)
• Laravel 12 : PHP 8.2+ → utilisez ^0.1.1 minimum
• Compte Rodium AI + clé API : dashboard

Installation

Le package est publié sur Packagist — aucune configuration repositories n’est nécessaire.

Laravel 10 / 11

composer require rodiumai/laravel-sdk

Laravel 12 (recommandé)

composer require rodiumai/laravel-sdk:^0.1.1

Après composer require

1. Publier la config (optionnel mais recommandé) :

php artisan vendor:publish --tag=rodiumai-config

1. Ajouter ta clé API dans .env (voir Configuration).

2. Le ServiceProvider et la Facade RodiumAI sont auto-découverts — rien à déclarer dans bootstrap/providers.php.

PHP sans Laravel

composer require rodiumai/laravel-sdk

Puis instancier RodiumAI\RodiumAIClient directement (voir Démarrage rapide).

Installation depuis GitHub (secours)

Uniquement si Packagist est indisponible :

composer config repositories.rodiumai-laravel-sdk vcs https://github.com/lecodeur228/rodiumai-laravel-sdk
composer require rodiumai/laravel-sdk:^0.1.1

Configuration

Fichier .env :

RODIUMAI_API_KEY=rd_sk_votre_cle_secrete
RODIUMAI_BASE_URL=https://api.rodiumai.io/v1
RODIUMAI_DEFAULT_MODEL=openai/gpt-4o
RODIUMAI_TIMEOUT=30

Ne jamais committer .env ni une clé API dans le dépôt.

Démarrage rapide

Laravel (Facade)

use RodiumAI\Enums\RodiumAIModel;
use RodiumAI\Facades\RodiumAI;

$response = RodiumAI::model(RodiumAIModel::OpenAiGpt4o)
    ->temperature(0.7)
    ->maxTokens(300)
    ->chat('Explique Rodium AI en deux phrases.');

echo $response->content;
echo $response->totalTokens(); // tokens facturés

PHP pur

use RodiumAI\Enums\RodiumAIModel;
use RodiumAI\RodiumAIClient;

$client = new RodiumAIClient(
    apiKey: getenv('RODIUMAI_API_KEY'),
);

$response = $client
    ->model(RodiumAIModel::AnthropicClaudeSonnet46)
    ->chat('Bonjour !');

echo $response->content;

Équivalent quickstart cURL / OpenAI SDK : POST https://api.rodiumai.io/v1/chat/completions avec Authorization: Bearer {RODIUMAI_API_KEY}.

Modèles typés (enum)

Les 45+ modèles du catalogue sont exposés via RodiumAIModel — autocomplétion IDE et validation à l’exécution :

use RodiumAI\Enums\RodiumAIModality;
use RodiumAI\Enums\RodiumAIModel;
use RodiumAI\Enums\RodiumAIProvider;

RodiumAI::model(RodiumAIModel::OpenAiGpt4o)->chat('…');

// Filtres
RodiumAIModel::forProvider(RodiumAIProvider::Google);
RodiumAIModel::forModality(RodiumAIModality::Text);

// Chat texte uniquement
RodiumAIModel::OpenAiGpt4o->supportsChatCompletion(); // true

Quand Rodium AI ajoute des modèles :

RODIUMAI_API_KEY="…" php bin/generate-model-enum.php

Paramètres chat

Alignés sur chat-completions :

use RodiumAI\Data\ChatMessage;

$messages = [
    ChatMessage::system('Tu es un assistant Laravel.'),
    ChatMessage::user('C\'est quoi un Service Provider ?'),
];

$response = RodiumAI::model(RodiumAIModel::OpenAiGpt4o)
    ->temperature(0.5)
    ->topP(0.9)
    ->maxTokens(500)
    ->chat($messages);

Streaming (SSE)

Conforme à docs/api/streaming : lignes data: …, fin sur data: [DONE].

foreach (RodiumAI::model(RodiumAIModel::OpenAiGpt4o)->stream('Raconte une histoire courte.') as $delta) {
    echo $delta;
}

Laravel — réponse StreamedResponse

use Illuminate\Http\Request;
use Symfony\Component\HttpFoundation\StreamedResponse;
use RodiumAI\Facades\RodiumAI;

public function streamChat(Request $request): StreamedResponse
{
    return response()->stream(function () use ($request) {
        foreach (RodiumAI::stream($request->string('message')) as $delta) {
            echo 'data: ' . json_encode(['delta' => $delta]) . "\n\n";
            ob_flush();
            flush();
        }
        echo "data: [DONE]\n\n";
    }, 200, [
        'Content-Type' => 'text/event-stream',
        'Cache-Control' => 'no-cache',
        'X-Accel-Buffering' => 'no',
    ]);
}

Liste des modèles

GET /v1/models — tarifs RODI et métadonnées :

$models = RodiumAI::models();

foreach ($models->ids() as $id) {
    echo $id . PHP_EOL;
}

$anthropic = $models->byProvider(RodiumAIProvider::Anthropic);

Gestion des erreurs

Voir docs/api/errors.

use RodiumAI\Exceptions\InsufficientCreditsException;
use RodiumAI\Exceptions\RodiumAIException;
use RodiumAI\Facades\RodiumAI;

try {
    $response = RodiumAI::chat('Test');
} catch (InsufficientCreditsException $e) {
    logger()->warning('RODI insuffisant', ['body' => $e->responseBody()]);
} catch (RodiumAIException $e) {
    logger()->error('Rodium AI', ['code' => $e->getCode(), 'body' => $e->responseBody()]);
}

Référence SDK

DTOs : ChatResponse, ChatMessage, ModelCollection.

Versions

Historique : CHANGELOG.md.

Tests & développement

composer install
composer test                 # PHPUnit (HTTP mocké)
export RODIUMAI_API_KEY="…"
php bin/smoke-test.php        # Parcours live dans la console

Contribuer

Voir CONTRIBUTING.md et docs/architecture.md.

Mainteneurs : guide docs/PUBLISHING.md (tags, Packagist).

Licence

MIT — voir LICENSE.