> ## Documentation Index
> Fetch the complete documentation index at: https://kawax.biz/llms.txt
> Use this file to discover all available pages before exploring further.

# Référence de configuration - VOICEVOX for Laravel

> Détail de toutes les options de config/voicevox.php, des variables d'environnement, des valeurs par défaut et des exemples de configuration.

Cette page récapitule toutes les options de `config/voicevox.php`.

## Publier le fichier de configuration

```shell theme={null}
php artisan vendor:publish --tag="voicevox-config"
```

## Configuration `client`

### `client.url`

* Type : `string`
* Valeur par défaut : `'http://127.0.0.1:50021'`
* Env : `VOICEVOX_URL`

```php theme={null}
'client' => [
    'url' => env('VOICEVOX_URL', 'http://127.0.0.1:50021'),
],
```

```dotenv theme={null}
VOICEVOX_URL=http://127.0.0.1:50021
```

### `client.core_version`

* Type : `string|null`
* Valeur par défaut : `null`
* Env : `VOICEVOX_CLIENT_CORE_VERSION`

```php theme={null}
'client' => [
    'core_version' => env('VOICEVOX_CLIENT_CORE_VERSION'),
],
```

```dotenv theme={null}
VOICEVOX_CLIENT_CORE_VERSION=0.15.0
```

## Configuration `core`

### `core.path`

* Type : `string|null`
* Valeur par défaut : `null`
* Env : `VOICEVOX_CORE_PATH`
* Requis : mode natif / mode API du moteur

```php theme={null}
'core' => [
    'path' => env('VOICEVOX_CORE_PATH'),
],
```

```dotenv theme={null}
# macOS
VOICEVOX_CORE_PATH=/Users/username/.local/voicevox_core/

# Linux
VOICEVOX_CORE_PATH=/home/username/.local/voicevox_core/

# Windows
VOICEVOX_CORE_PATH=C:\Users\username\.local\voicevox_core\
```

### `core.dict`

* Type : `string`
* Valeur par défaut : `'dict/open_jtalk_dic_utf_8-1.11'`
* Env : `VOICEVOX_CORE_DICT_PATH`

```php theme={null}
'core' => [
    'dict' => env('VOICEVOX_CORE_DICT_PATH', 'dict/open_jtalk_dic_utf_8-1.11'),
],
```

### `core.models`

* Type : `string`
* Valeur par défaut : `'models/vvms'`
* Env : `VOICEVOX_CORE_MODELS_PATH`

```php theme={null}
'core' => [
    'models' => env('VOICEVOX_CORE_MODELS_PATH', 'models/vvms'),
],
```

### `core.user_dict`

* Type : `string`
* Valeur par défaut : `storage_path('voicevox/user_dict.json')`
* Env : `VOICEVOX_CORE_USER_DICT_PATH`

```php theme={null}
'core' => [
    'user_dict' => env('VOICEVOX_CORE_USER_DICT_PATH', storage_path('voicevox/user_dict.json')),
],
```

```dotenv theme={null}
VOICEVOX_CORE_USER_DICT_PATH=/path/to/custom/user_dict.json
```

Page associée : [Dictionnaire utilisateur](/fr/packages/laravel-voicevox/native-user-dict)

### `core.presets`

* Type : `string`
* Valeur par défaut : `storage_path('voicevox/presets.json')`
* Env : `VOICEVOX_CORE_PRESETS_PATH`

```php theme={null}
'core' => [
    'presets' => env('VOICEVOX_CORE_PRESETS_PATH', storage_path('voicevox/presets.json')),
],
```

```dotenv theme={null}
VOICEVOX_CORE_PRESETS_PATH=/path/to/custom/presets.json
```

Page associée : [Presets](/fr/packages/laravel-voicevox/native-presets)

### `core.vvms`

* Type : `array`
* Valeur par défaut : `['0.vvm', '9.vvm', 's0.vvm']`
* Env : aucun

```php theme={null}
# Par défaut (démarrage rapide)
'core' => [
    'vvms' => ['0.vvm', '9.vvm', 's0.vvm'],
],

# Charger tous les modèles (le démarrage devient plus lent)
'core' => [
    'vvms' => [],
],
```

## Configuration `engine`

### `engine.disabled`

* Type : `bool`
* Valeur par défaut : `false`
* Env : `VOICEVOX_ENGINE_DISABLED`

```php theme={null}
'engine' => [
    'disabled' => env('VOICEVOX_ENGINE_DISABLED', false),
],
```

```dotenv theme={null}
VOICEVOX_ENGINE_DISABLED=true
```

### `engine.fallback_url`

* Type : `string`
* Valeur par défaut : `'http://127.0.0.1:50021'`
* Env : `VOICEVOX_ENGINE_FALLBACK_URL`

```php theme={null}
'engine' => [
    'fallback_url' => env('VOICEVOX_ENGINE_FALLBACK_URL', 'http://127.0.0.1:50021'),
],
```

```dotenv theme={null}
VOICEVOX_ENGINE_FALLBACK_URL=http://127.0.0.1:50021
```

### `engine.fallback_error`

* Type : `string`
* Valeur par défaut : `'The Laravel version of the engine does not support this endpoint. Please use the official engine instead.'`
* Env : aucun

```php theme={null}
'engine' => [
    'fallback_error' => 'The Laravel version of the engine does not support this endpoint. Please use the official engine instead.',
],
```

<Tip>
  Une configuration qui ne définit d'abord que `client.url` et `core.path`, puis ajuste `core.user_dict` et `core.presets` selon les besoins, est plus simple à maintenir.
</Tip>


## Related topics

- [Installation et configuration - VOICEVOX for Laravel](/fr/packages/laravel-voicevox/installation.md)
- [Guide de développement d'applications intégrées à l'API du moteur - VOICEVOX for Laravel](/fr/packages/laravel-voicevox/app-guide.md)
- [Mode natif : Talk (synthèse vocale de texte) - VOICEVOX for Laravel](/fr/packages/laravel-voicevox/native-talk.md)
- [Mode API du moteur : Talk (synthèse vocale de texte) - VOICEVOX for Laravel](/fr/packages/laravel-voicevox/engine-talk.md)
- [Mode client : Talk (synthèse vocale de texte) - VOICEVOX for Laravel](/fr/packages/laravel-voicevox/client-talk.md)