Skip to main content

​
Overview

The AI Translations package can be configured through the config/ai-translations.php file. After installing the package, publish the configuration file using: 
php artisan vendor:publish --tag=ai-translations-config

​
Configuration Options

​
languages
array | null
default:"null"
The list of languages to support in your application.
  • When set to null, the package automatically reads existing languages from your lang_path() directory
  • You can manually specify an array of language codes to explicitly define supported languages
Example:
'languages' => ['en', 'es', 'fr', 'de']
​
provider
string
default:"gemini"
The AI provider to use for translations.Supported values:
  • "openai" - Use OpenAI’s GPT models
  • "gemini" - Use Google’s Gemini models
  • "anthropic" - Use Anthropic’s Claude models

​
OpenAI Configuration

​
openai.model
string
default:"gpt-5-mini"
The default OpenAI model to use for translations.This model is used for standard translation operations.
​
openai.fast_model
string
default:"gpt-5-nano"
The fast OpenAI model to use for quick translations.This model is optimized for speed and cost efficiency.
​
openai.api_key
string
Your OpenAI API key.Default: Reads from OPENAI_API_KEY environment variable
Store your API key in your .env file, never commit it to version control.

​
Gemini Configuration

​
gemini.model
string
default:"gemini-flash-latest"
The default Gemini model to use for translations.This model is used for standard translation operations.
​
gemini.fast_model
string
default:"gemini-flash-lite-latest"
The fast Gemini model to use for quick translations.This model is optimized for speed and cost efficiency.
​
gemini.api_key
string
Your Google Gemini API key.Default: Reads from GEMINI_API_KEY environment variable
Store your API key in your .env file, never commit it to version control.

​
Anthropic Configuration

​
anthropic.model
string
default:"claude-sonnet-4-5"
The default Anthropic Claude model to use for translations.This model is used for standard translation operations.
​
anthropic.fast_model
string
default:"claude-haiku-4-5"
The fast Anthropic Claude model to use for quick translations.This model is optimized for speed and cost efficiency.
​
anthropic.api_key
string
Your Anthropic API key.Default: Reads from ANTHROPIC_API_KEY environment variable
Store your API key in your .env file, never commit it to version control.

​
Example Configurations

<?php

return [
    // Automatically detect languages from lang_path()
    'languages' => null,
    
    'provider' => 'gemini',
    
    'gemini' => [
        'model' => 'gemini-flash-latest',
        'fast_model' => 'gemini-flash-lite-latest',
        'api_key' => env('GEMINI_API_KEY'),
    ],
];

​
Environment Variables

Add the appropriate API key to your .env file based on your chosen provider: 
OPENAI_API_KEY=sk-...

​
Complete Configuration File

<?php

return [
    // reads existing languages from the lang_path() directory
    "languages" => null,

    "provider" => "gemini",
    "openai" => [
        "model" => "gpt-5-mini",
        "fast_model" => "gpt-5-nano",
        "api_key" => env("OPENAI_API_KEY"),
    ],

    "gemini" => [
        "model" => "gemini-flash-latest",
        "fast_model" => "gemini-flash-lite-latest",
        "api_key" => env("GEMINI_API_KEY"),
    ],

    "anthropic" => [
        "model" => "claude-sonnet-4-5",
        "fast_model" => "claude-haiku-4-5",
        "api_key" => env("ANTHROPIC_API_KEY"),
    ],

    // Optionally, you can specify the languages manually:
    //'languages' => [
    //    'en',
    //    'de',
    //    'es',
    //    'fr',
    //    'it',
    //    'nl',
    //    'ua',
    //    'ar',
    //    'jp',
    //    'cn',
    //],
];

Build docs developers (and LLMs) love

Get started for freeTalk to us