Download the PHP package luminovang/php-ai-models-enum without Composer

PHP AI Model (Enum) Class

Type: enum Model: string (string-backed)

A string-backed enum cataloguing AI model identifiers. Each case name is a readable PHP identifier; its ->value is the exact API string the client expects.

The enum version extends the class version with native PHP enum capabilities: exhaustive match checking, built-in from() / tryFrom() / cases(), type-safe function signatures, and instance methods that let you interrogate any case directly.

Installation

Install via composer.

No additional dependencies beyond PHP 8.1.

Luminova\AI\Model (const version) — PHP constant final class.

Table of Contents

• Why an Enum?
• Installation / Import
• Naming Convention
• Getting the API String
• Cases Reference
  • OpenAI — GPT-5
  • OpenAI — GPT-4.1
  • OpenAI — GPT-4o
  • OpenAI — Reasoning (o-series)
  • OpenAI — Image Generation
  • OpenAI — Text-to-Speech
  • OpenAI — Transcription
  • OpenAI — Embeddings
  • OpenAI — Moderation
  • Claude (Anthropic) — 4.6 Generation
  • Claude (Anthropic) — 4.5 Generation
  • Claude (Anthropic) — 4.1 Generation
  • Claude (Anthropic) — 4.0 Generation
  • Claude (Anthropic) — 3.7 Generation
  • Claude (Anthropic) — 3.5 Generation
  • Ollama — Llama
  • Ollama — Gemma
  • Ollama — Mistral / Mixtral
  • Ollama — Qwen
  • Ollama — DeepSeek
  • Ollama — Phi
  • Ollama — Coding Models
  • Ollama — Vision Models
  • Ollama — Embedding Models
• Built-in Enum Methods
  • from()
  • tryFrom()
  • cases()
• Instance Methods
  • client()
  • capabilities()
  • isVision()
  • isReasoning()
  • isEmbedding()
  • isChat()
  • isCoding()
  • isFineTunable()
• Static Methods
  • forClient()
  • forCapability()
  • resolve()
• Usage Examples
  • Basic Usage
  • Type-Safe Function Signatures
  • Resolving from Config or User Input
  • Exhaustive match on Cases
  • Routing by Client
  • Guarding Capability Requirements
  • Building UI Select Lists
  • Pinned vs. Alias Snapshots
• Comparison with the Class Version

Why an Enum?

Choose the enum when you want PHP to enforce correctness at the type level; choose the class when you need to target PHP < 8.1 or prefer the Model::GPT_4 constant call style without ->value.

Import

Naming Convention

Getting the API String

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

Cases Reference

OpenAI — GPT-5 Family

OpenAI — GPT-4.1 Family

OpenAI — GPT-4o Family

OpenAI — Reasoning (o-series)

OpenAI — Image Generation

OpenAI — Text-to-Speech

OpenAI — Transcription

OpenAI — Embeddings

OpenAI — Moderation

Claude (Anthropic) — 4.6 Generation (current)

Claude (Anthropic) — 4.5 Generation

Claude (Anthropic) — 4.1 Generation

Claude (Anthropic) — 4.0 Generation

Claude (Anthropic) — 3.7 Generation

Claude (Anthropic) — 3.5 Generation (legacy)

Ollama — Llama Family (Meta)

Ollama — Gemma Family (Google)

Ollama — Mistral / Mixtral

Ollama — Qwen Family (Alibaba)

Ollama — DeepSeek Family

Ollama — Phi Family (Microsoft)

Ollama — Coding Models

Ollama — Vision Models

Ollama — Embedding Models

Built-in Enum Methods

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

from(string $modelId): self

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.

tryFrom(string $modelId): ?self

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

cases(): self[]

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

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(): string

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

capabilities(): array

Return all capability tags this case supports.

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

isVision(): bool

Whether this case accepts image input.

isReasoning(): bool

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

isEmbedding(): bool

Whether this case produces vector embeddings.

isChat(): bool

Whether this case supports chat / completion.

isCoding(): bool

Whether this case is optimized for code generation or completion.

isFineTunable(): bool

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

Static Methods

forClient(string $client): self[]

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

forCapability(string $capability): self[]

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

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

resolve(string $modelId): ?self

A readable alias for Model::tryFrom(). Returns the matching case or null — never throws. Intended to make call-site intent explicit when validating external input.

Usage Examples

Basic Usage

Type-Safe Function Signatures

The enum's biggest advantage — invalid model strings become impossible at the type level:

Resolving from Config or User Input

Exhaustive match on Cases

PHP enforces that all cases in a match are handled when matching on an enum. This prevents silent omissions as you add new cases:

Routing by Provider

Guarding Capability Requirements

Building UI Select Lists

Pinned vs. Alias Snapshots

For Claude models, Anthropic recommends using versioned snapshot strings in production to guarantee reproducible behavior. Luminova provides both:

Use the alias in development for the newest behavior; use the snapshot in staging/production for determinism.

Comparison with the Class Version

Both classes expose identical client data and capability tags. The enum is recommended for all new code.

See Also

• Luminova\AI\Model (class version) — Static constants for PHP style or pre-8.1 compatibility.