Passer au contenu principal

​
Ce qu’il faut installer

Selon le mode que vous souhaitez utiliser, les packages additionnels et la mise en place locale diffèrent.
Pour une simple connexion HTTP au moteur officiel VOICEVOX, seul revolution/laravel-voicevox suffit.
composer require revolution/laravel-voicevox

​
Exigences

ÉlémentContenu
PHP8.3+
Laravel12+
Extension requiseext-zip
FFI ext-ffiRequis en mode natif / API du moteur
Sur la plupart des serveurs web, y compris Laravel Cloud, FFI est désactivé. Essayez le mode natif et l’API du moteur en CLI locale.

​
Procédure d’installation

1

Installer le package

Installez avec Composer selon le mode souhaité. Le mode natif et l’API du moteur nécessitent également VOICEVOX Core for PHP.
2

Publier le fichier de configuration

php artisan vendor:publish --tag="voicevox-config"
3

Configurer le .env

Configurez VOICEVOX_URL en mode client uniquement, ou VOICEVOX_CORE_PATH pour utiliser FFI.
4

Installer les ressources du moteur si nécessaire

Pour utiliser /speaker_info ou /singer_info, des ressources supplémentaires sont requises.

​
config/voicevox.php

Toutes les options sont détaillées dans la Référence de configuration. 
return [
    'client' => [
        'url' => env('VOICEVOX_URL', 'http://127.0.0.1:50021'),
        'core_version' => env('VOICEVOX_CLIENT_CORE_VERSION'),
    ],

    'core' => [
        'path' => env('VOICEVOX_CORE_PATH'),
        'dict' => env('VOICEVOX_CORE_DICT_PATH', 'dict/open_jtalk_dic_utf_8-1.11'),
        'models' => env('VOICEVOX_CORE_MODELS_PATH', 'models/vvms'),
        'vvms' => ['0.vvm', '9.vvm', 's0.vvm'],
    ],

    'engine' => [
        'disabled' => env('VOICEVOX_ENGINE_DISABLED', false),
        'fallback_url' => env('VOICEVOX_ENGINE_FALLBACK_URL', 'http://127.0.0.1:50021'),
    ],
];

​
.env minimal

​
Mode client uniquement

Si vous démarrez le moteur officiel à l’adresse par défaut http://127.0.0.1:50021, aucune configuration supplémentaire n’est nécessaire. 
VOICEVOX_URL=http://127.0.0.1:50021

​
Mode natif / API du moteur

VOICEVOX_CORE_PATH=/path/to/voicevox_core/
Le contenu de VOICEVOX_CORE_PATH se prépare selon la procédure de VOICEVOX Core for PHP. Vérifiez également là-bas l’emplacement de la bibliothèque, du dictionnaire OpenJTalk et des fichiers modèles.

​
Activer FFI

En CLI, cela fonctionne normalement sans intervention. Pour démarrer localement l’API version Laravel, activez FFI dans php.ini. 
ffi.enable=true
Le fonctionnement et les contraintes de FFI sont résumés dans PHP FFI.

​
Installation des ressources du moteur

Pour utiliser les endpoints de type ressource comme /speaker_info ou /singer_info, installez les fichiers de ressources séparément. 
php artisan voicevox:install
Sous Orchestra Testbench, utilisez la commande suivante. 
vendor/bin/testbench voicevox:install

​
Points d’entrée par mode

Client Talk

Démarrez le moteur officiel VOICEVOX avec Docker et effectuez la synthèse vocale de texte.

Client Song

Effectuez la synthèse chantée avec Score et Note.

Native Talk

Appelez directement VOICEVOX CORE via FFI.

Native Song

Découvrez l’usage du modèle de chant et de sync().

​
Liens de référence

Dernière modification le 13 juillet 2026

Sujets connexes

Référence de configuration - VOICEVOX for LaravelPremière analyse de Laravel Passkeys (passkeys-server + @laravel/passkeys)Laravel Cashier (Stripe)Créer un serveur MCP avec LaravelConfiguration