Installatie en configuratie - VOICEVOX for Laravel

Wat installeer je

Welke extra pakketten en lokale setup je nodig hebt voor VOICEVOX for Laravel, hangt af van de modus die je wilt gebruiken.

Alleen client
Ook native / Engine API gebruiken

Als je alleen via HTTP verbinding maakt met de officiële VOICEVOX-engine, kun je beginnen met enkel revolution/laravel-voicevox.

composer require revolution/laravel-voicevox

Voor modi die FFI gebruiken installeer je ook revolution/voicevox-core.

composer require revolution/laravel-voicevox revolution/voicevox-core

Vereisten

Onderdeel	Inhoud
PHP	8.3+
Laravel	12+
Vereiste extensie	`ext-zip`
FFI `ext-ffi`	Nodig voor native modus / Engine API

Op gangbare webservers, waaronder Laravel Cloud, is FFI uitgeschakeld. Probeer de native modus en de Engine API in een lokale CLI.

Installatiestappen

Installeer het pakket

Installeer via Composer, afhankelijk van de modus die je wilt gebruiken. Voor de native modus en de Engine API heb je ook VOICEVOX Core for PHP nodig.

Publiceer het configuratiebestand

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

Stel .env in

Gebruik je alleen de clientmodus, stel dan VOICEVOX_URL in; gebruik je FFI, stel dan VOICEVOX_CORE_PATH in.

Installeer indien nodig engine-resources

Als je /speaker_info of /singer_info gebruikt, zijn extra resources nodig.

`config/voicevox.php`

Alle configuratieopties vind je in de configuratiereferentie.

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'),
    ],
];

Minimaal benodigde `.env`

Alleen clientmodus

Als je de officiële engine start op de standaard http://127.0.0.1:50021, is geen extra configuratie nodig.

VOICEVOX_URL=http://127.0.0.1:50021

Native modus / Engine API

VOICEVOX_CORE_PATH=/path/to/voicevox_core/

De inhoud van VOICEVOX_CORE_PATH bereid je voor volgens de stappen van VOICEVOX Core for PHP. Raadpleeg daar ook de plaatsing van de bibliotheek zelf, het OpenJTalk-woordenboek en de modelbestanden.

FFI inschakelen

In de CLI werkt het meestal direct. Als je de Laravel-versie van de Engine API lokaal start, schakel je FFI in via php.ini.

ffi.enable=true

Hoe FFI werkt en welke beperkingen er zijn, vind je in PHP FFI.

Engine-resources installeren

Als je resource-endpoints zoals /speaker_info of /singer_info gebruikt, installeer je apart de resourcebestanden.

php artisan voicevox:install

In een Orchestra Testbench-omgeving gebruik je dit commando:

vendor/bin/testbench voicevox:install

Ingang per modus

Client Talk

Start de officiële VOICEVOX-engine met Docker en synthetiseer tekst naar spraak.

Client Song

Synthetiseer zang met Score en Note.

Native Talk

Roep VOICEVOX CORE rechtstreeks aan via FFI.

Native Song

Bekijk zangmodellen en wanneer je sync() gebruikt.

GitHub Copilot

SDK

AI SDK

VOICEVOX

Starter kits

Feeds en RSS

Middleware

Installatie en configuratie - VOICEVOX for Laravel

Wat installeer je

Vereisten

Installatiestappen

`config/voicevox.php`

Minimaal benodigde `.env`

Alleen clientmodus

Native modus / Engine API

FFI inschakelen

Engine-resources installeren

Ingang per modus

Client Talk

Client Song

Native Talk

Native Song

Referentielinks

​Wat installeer je

​Vereisten

​Installatiestappen

​config/voicevox.php

​Minimaal benodigde .env

​Alleen clientmodus

​Native modus / Engine API

​FFI inschakelen

​Engine-resources installeren

​Ingang per modus

Client Talk

Client Song

Native Talk

Native Song

​Referentielinks

Wat installeer je

Vereisten

Installatiestappen

`config/voicevox.php`

Minimaal benodigde `.env`

Alleen clientmodus

Native modus / Engine API

FFI inschakelen

Engine-resources installeren

Ingang per modus

Referentielinks