Passer au contenu principal

​
Vue d’ensemble

revolution/laravel-voicevox est un package pour utiliser VOICEVOX depuis Laravel. Il permet de gérer, dans un même style Laravel, un mode client qui se connecte au moteur officiel via HTTP et un mode natif qui, combiné à VOICEVOX Core for PHP, synthétise directement via PHP FFI.
Pour poser les prérequis FFI, consultez PHP FFI. Pour la mise en place de la bibliothèque core elle-même, consultez VOICEVOX Core for PHP et son Utilisation.

​
Tableau des fonctionnalités

FeatureSupportedDescription
VOICEVOX Client✅Accès HTTP à l’API du moteur officiel VOICEVOX. FFI n’est pas requis.
VOICEVOX Core✅Utilise la bibliothèque dynamique de VOICEVOX CORE via VOICEVOX Core for PHP.
Laravel style✅Utilisation façon Laravel avec Facade, helpers, config/voicevox.php et .env.
Intégration Laravel AI SDK✅Utilisable également depuis les workflows Audio du Laravel AI SDK.
VOICEVOX Engine⚠️Intègre une API compatible VOICEVOX dans l’application Laravel. Les parties non prises en charge sont relayées en fallback vers le moteur officiel.
VOICEVOX Engine / API TTS compatible OpenAI✅Pour /v1/audio/speech, voice accepte, comme dans l’AI SDK, les alias tels que « ずんだもん » en plus des ID de style.
VOICEVOX Editor⚠️Une application dédiée Song pour macOS a été développée, mais il n’est pas prévu de la publier sur l’App Store. Si le code est un jour publié sur GitHub, vous pourrez la compiler avec Xcode et l’utiliser.

​
Exigences

  • PHP 8.3+
  • Laravel 12+
  • ext-zip
  • ext-ffi pour le mode natif / l’API du moteur
  • Un environnement CLI local
Sur la plupart des environnements de serveur web, y compris Laravel Cloud, FFI est souvent désactivé : considérez donc que le mode natif et l’API du moteur reposent sur une CLI locale.

​
Liste des modes

ModeExécutionFFIUsage principalGuide
Client TalkRequête HTTP vers le moteur officielNon requisSynthèse vocale de texteclient-talk
Client SongRequête HTTP vers le moteur officielNon requisSynthèse chantéeclient-song
Native TalkAppel direct de VOICEVOX CORE via FFIRequisSynthèse vocale de texte en localnative-talk
Native SongAppel direct de VOICEVOX CORE via FFIRequisSynthèse chantée en localnative-song
API du moteurFournit une API compatible dans l’application LaravelRequisIntégration d’une API compatible VOICEVOXinstallation

​
Pourquoi tap() convient bien

Ce package retourne un objet Audio Query juste après talk() / song(), permettant d’insérer une phase d’ajustement avant generate(). Cela rend naturel l’usage de tap() pour ajuster uniquement la query sans changer la valeur de retour. 
use Revolution\Voicevox\Client\TalkAudioQuery;
use Revolution\Voicevox\Voicevox;

$response = Voicevox::talk('タップで調整できるのだ', id: 1)
    ->tap(function (TalkAudioQuery $talk) {
        $talk->audioQuery['speedScale'] = 1.2;
    })
    ->generate(id: 1);
  • En Talk, vous pouvez ajuster speedScale, pitchScale, etc.
  • En Song, sync() permet de recalculer F0 et le volume.
  • Vous pouvez chaîner proprement vers le VoicevoxResponse retourné par generate().
Le concept de tap() est expliqué dans Le helper tap() et le trait Tappable. Ce package est un cas d’usage particulièrement clair.

​
Documentation

Installation

Découvrez l’installation client seule, l’installation avec FFI, la publication du fichier de configuration et la préparation des ressources du moteur.

Client Talk

Démarrez la synthèse vocale de texte via le moteur officiel VOICEVOX.

Client Song

Construisez un Score et des Note pour la synthèse chantée.

Native Talk

Synthétisez en local via PHP FFI et VOICEVOX CORE.

Native Song

Utilisez directement le modèle de chant via FFI.

VOICEVOX Core for PHP

Découvrez la mise en place de la bibliothèque core et son utilisation côté PHP pur.

​
Liens de référence

Dernière modification le 13 juillet 2026

Sujets connexes

VOICEVOX for Laravel