Engine-API-modus: talk (tekst-naar-spraak) - VOICEVOX for Laravel

Wat is de engine-API-modus?

De engine-API-modus biedt een HTTP API in je Laravel-app die compatibel is met de officiële VOICEVOX-engine. Start de app met php artisan serve --port=50513 en je kunt /audio_query en /synthesis direct gebruiken.

Voorbereiding

VOICEVOX Core for PHP instellen

Zet voicevox-core-php en de corebibliotheek klaar volgens de stappen in Installatie en configuratie.

Omgevingsvariabelen instellen en FFI inschakelen

VOICEVOX_CORE_PATH=/path/to/voicevox_core/

ffi.enable=true

Karakterinformatie-resources installeren

php artisan voicevox:install

De Laravel-versie van de engine starten

php artisan serve --port=50513

Standaard start de engine op http://127.0.0.1:50513.

Over poort 50513

De standaardpoort van de officiële VOICEVOX-engine is 50021. Om de Laravel-versie en de officiële engine tegelijk te kunnen draaien, is 50513 als standaardpoort gekozen. Je start alleen maar met --port=50513, dus je mag ook een andere poort gebruiken, zoals --port=8000.

Als de poort in gebruik is, start de officiële engine automatisch op een vrije poort vanaf 50022. Ook php artisan serve wijkt zonder --port automatisch uit naar 8001 en hoger, maar als je --port opgeeft en de poort is bezet, mislukt het starten. We raden aan een vaste poort te kiezen die weinig conflicteert met andere services. 50513 is daar een voorbeeld van.

Spraak genereren

1. Een `audio_query` maken

curl -s -X POST "http://127.0.0.1:50513/audio_query?speaker=1&text=ララベルが好きなのだ" \
  -H "Content-Type: application/json" \
  > audio_query.json

2. Spraak synthetiseren met `synthesis`

curl -s -X POST "http://127.0.0.1:50513/synthesis?speaker=1" \
  -H "Content-Type: application/json" \
  -d @audio_query.json \
  > talk.wav

Gebruik vanuit de Laravel-client

Je kunt de Laravel-versie van de engine gebruiken als bestemming voor de clientmodus.

// config/voicevox.php
'client' => [
    'url' => env('VOICEVOX_URL', 'http://127.0.0.1:50513'),
],

use Revolution\Voicevox\Voicevox;

$response = Voicevox::talk('ララベルが好きなのだ', id: 1)
    ->generate(id: 1);

$response->storeAs('engine', 'talk.wav');

De engine-API in-/uitschakelen en fallback

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

Niet-geïmplementeerde endpoints zoals cancellable_synthesis en multi_synthesis kunnen terugvallen op de officiële engine.

Als je de fallback gebruikt, start dan de officiële engine op het adres van VOICEVOX_ENGINE_FALLBACK_URL.

Ondersteuningsstatus voor talk

Endpoint	Laravel-versie	Fallback	Opmerkingen
`POST /audio_query`	✅	✅	`enable_katakana_english` niet ondersteund
`POST /accent_phrases`	✅	✅	`enable_katakana_english` niet ondersteund
`POST /synthesis`	✅	✅
`POST /mora_data`	✅	✅
`POST /mora_length`	✅	✅
`POST /mora_pitch`	✅	✅
`GET /speakers`	✅	✅
`GET /speaker_info`	✅	✅	Vereist installatie van resources
`POST /cancellable_synthesis`	❌	✅	Alleen fallback
`POST /multi_synthesis`	❌	✅	Alleen fallback

OpenAI-compatibel TTS-endpoint

POST /v1/audio/speech accepteert hetzelfde requestformaat als de spraaksynthese-API van OpenAI. Door alleen de base-URL te wijzigen kun je het gebruiken vanuit veel tools die de OpenAI API ondersteunen, waaronder de Laravel AI SDK.

curl -s -X POST "http://127.0.0.1:50513/v1/audio/speech" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "voicevox",
    "input": "ララベルが好きなのだ",
    "voice": "ずんだもん"
  }' \
  > talk.wav

Parameters

Parameter	Beschrijving
`input`	De voor te lezen tekst (maximaal 4096 tekens)
`voice`	Een stijl-ID (getal), een alias (`ずんだもん`, `四国めたん`, enzovoort) of een OpenAI-stemnaam (`alloy`, `shimmer`, enzovoort)
`speed`	Afspeelsnelheid. Toegepast als `speedScale` (0.25–4.0, standaard 1.0)
`response_format`	Er wordt altijd wav teruggegeven. De opgegeven waarde wordt genegeerd
Overige parameters	Worden genegeerd

De OpenAI-stemnamen (alloy, shimmer, enzovoort) zijn een voorlopige toewijzing. Er bestaat geen definitie die het stemkarakter van elke OpenAI-stem aan een VOICEVOX-karakter koppelt; de mapping is er puur voor de compatibiliteit. We raden aan de aliassen van VOICEVOX-karakters te gebruiken (ずんだもん, 四国めたん/ノーマル, enzovoort).

Volgende pagina’s

Engine-API: song

Bekijk het gebruik van sing_frame_audio_query en frame_synthesis.

Laravel AI SDK-integratie

Bekijk de configuratie om VOICEVOX te gebruiken via de Audio-facade.

GitHub Copilot

SDK

AI SDK

VOICEVOX

Starter kits

Feeds en RSS

Middleware

Engine-API-modus: talk (tekst-naar-spraak) - VOICEVOX for Laravel

Wat is de engine-API-modus?

Voorbereiding

De Laravel-versie van de engine starten

Over poort 50513

Spraak genereren

1. Een `audio_query` maken

2. Spraak synthetiseren met `synthesis`

Gebruik vanuit de Laravel-client

De engine-API in-/uitschakelen en fallback

Ondersteuningsstatus voor talk

OpenAI-compatibel TTS-endpoint

Parameters

Volgende pagina’s

Engine-API: song

Laravel AI SDK-integratie

​Wat is de engine-API-modus?

​Voorbereiding

​De Laravel-versie van de engine starten

​Over poort 50513

​Spraak genereren

​1. Een audio_query maken

​2. Spraak synthetiseren met synthesis

​Gebruik vanuit de Laravel-client

​De engine-API in-/uitschakelen en fallback

​Ondersteuningsstatus voor talk

​OpenAI-compatibel TTS-endpoint

​Parameters

​Volgende pagina’s

Engine-API: song

Laravel AI SDK-integratie

Wat is de engine-API-modus?

Voorbereiding

De Laravel-versie van de engine starten

Over poort 50513

Spraak genereren

1. Een `audio_query` maken

2. Spraak synthetiseren met `synthesis`

Gebruik vanuit de Laravel-client

De engine-API in-/uitschakelen en fallback

Ondersteuningsstatus voor talk

OpenAI-compatibel TTS-endpoint

Parameters

Volgende pagina’s