PHP Luminova: AI Models BackedEnum Helper

Last updated: 2026-03-19 09:05:05

The Luminova\AI\Model is an optional Luminova enum component. Each enum case has a readable PHP identifier, and its ->value holds the exact API string required by the AI client.

The Model class extends native PHP enum features: exhaustive match checking, built-in from(), tryFrom(), cases(), type-safe function signatures, and instance methods that let you inspect any case directly.

Installation

Install via Composer:

composer require luminovang/php-ai-models-enum

Requires PHP 8.1 or higher. No additional dependencies are needed.

Luminova\AI\Model — a final PHP enum class with constant-like behavior.

Naming Conventions

Rule	Example
Replace hyphens and dots with underscores	`gpt-4.1-mini` → `GPT_4_1_MINI`
Append size tags (`:8b`)	`llama3.1:8b` → `LLAMA_3_1_8B`
Append MoE tags (`8x7b`)	`mixtral:8x7b` → `MIXTRAL_8X7B`
Versioned snapshots	`claude-opus-4-5-20251101` → `CLAUDE_OPUS_4_5_SNAP`
Clean alias for snapshot	`claude-opus-4-5` → `CLAUDE_OPUS_4_5`

Usages

Setting Model

Every client method that accepts a model parameter expects a plain string. Use ->value to extract the API string from a case:

use Luminova\AI\Model;

// Correct — pass ->value to the client
AI::message('Hello!', ['model' => Model::GPT_4_1_MINI->value]);

// Also correct when your method accepts Model directly and extracts ->value internally
AI::message('Hello!', ['model' => Model::GPT_4_1_MINI]);
Luminova\Funcs\ask('Hello!', Model::GPT_4_1_MINI);

Built-in Enum Methods

These are standard PHP 8.1 backed-enum methods available on every string-backed enum automatically.

from

Resolve a case from its API string value. Throws \ValueError when the string is not a known case — use this when the input is trusted.

use Luminova\AI\Model;

$model = Model::from('gpt-4.1-mini');  // Model::GPT_4_1_MINI
$model = Model::from('unknown');        // throws \ValueError

tryFrom

Resolve a case from its API string value. Returns null when the string is not known — use this for user or config input.

use Luminova\AI\Model;

$model = Model::tryFrom('gpt-4.1-mini'); // Model::GPT_4_1_MINI
$model = Model::tryFrom('unknown');       // null

cases

Return all cases as an array of enum instances. The order matches declaration order in the source file.

use Luminova\AI\Model;

foreach (Model::cases() as $model) {
    echo $model->name . ' => ' . $model->value . PHP_EOL;
}
// GPT_5 => gpt-5
// GPT_5_MINI => gpt-5-mini
// ...
// ALL_MINILM => all-minilm

Note: cases() returns only enum cases, never private constants like PROVIDER_MAP or CAPABILITY_MAP.

Instance Methods

Called directly on a case — no arguments needed.

client

Return the client short-name. Matches the key registered in AI::$clients: 'openai', 'anthropic', or 'ollama'.

use Luminova\AI\Model;

Model::GPT_4_1_MINI->client();      // 'openai'
Model::CLAUDE_SONNET_4_6->client(); // 'anthropic'
Model::LLAVA->client();             // 'ollama'
Model::DEEPSEEK_R1->client();       // 'ollama'

capabilities

Return all capability tags this case supports.

Available tags: chat, vision, image, embedding, speech, transcription, reasoning, coding, fine-tuning, moderation.

use Luminova\AI\Model;

Model::O3->capabilities();
// ['chat', 'vision', 'reasoning', 'coding']

Model::GPT_4_1_MINI->capabilities();
// ['chat', 'vision', 'coding', 'fine-tuning']

Model::NOMIC_EMBED_TEXT->capabilities();
// ['embedding']

Model::DALL_E_3->capabilities();
// ['image']

Model::WHISPER_1->capabilities();
// ['transcription']

isVision

Whether this case accepts image input.

use Luminova\AI\Model;

Model::GPT_4_1->isVision();          // true
Model::WHISPER_1->isVision();        // false

isReasoning

Whether this is a reasoning / chain-of-thought model.

use Luminova\AI\Model;

Model::O3_PRO->isReasoning();        // true
Model::GPT_4_1_MINI->isReasoning();  // false

isEmbedding

Whether this case produces vector embeddings.

use Luminova\AI\Model;

Model::TEXT_EMBEDDING_3_SMALL->isEmbedding(); // true
Model::GPT_4_1->isEmbedding();               // false

isChat

Whether this case supports chat / completion.

use Luminova\AI\Model;

Model::GPT_4_1_MINI->isChat(); // true
Model::WHISPER_1->isChat();    // false

isCoding

Whether this case is optimized for code generation or completion.

use Luminova\AI\Model;

Model::DEEPSEEK_CODER->isCoding();   // true
Model::LLAVA->isCoding();            // false

isFineTunable

Whether this case supports fine-tuning via the client API.

use Luminova\AI\Model;

Model::GPT_4_1->isFineTunable();      // true
Model::CLAUDE_SONNET_4_6->isFineTunable(); // false

Static Methods

forClient

Return all cases belonging to a specific client as an array of enum instances.

use Luminova\AI\Model;

$cases = Model::forClient('openai');
// [Model::GPT_5, Model::GPT_5_MINI, ..., Model::TEXT_MODERATION]

$cases = Model::forClient('anthropic');
// [Model::CLAUDE_OPUS_4_6, Model::CLAUDE_SONNET_4_6, ...]

$cases = Model::forClient('ollama');
// [Model::LLAMA_3, Model::LLAMA_3_1, ..., Model::ALL_MINILM]

foreach (Model::forClient('ollama') as $model) {
    echo $model->name . ' = ' . $model->value . PHP_EOL;
}

forCapability

Return all cases that support a given capability tag as an array of enum instances.