--- license: apache-2.0 language: - ja pipeline_tag: text-to-speech tags: - text-to-speech base_model: - n4ze3m/tiny-voca datasets: - gachimoto/tiny-voca-ja --- # tiny-voca-ja > **日本語要約**: tiny-voca-ja は、英語 TTS モデル tiny-voca(n4ze3m)を日本語で > ゼロから学習し直した派生モデルです。パラメータ 4.5M、声は F2(女性)と M2(男性)の > 2 声、出力は 24 kHz モノラル。学習データは Qwen3-TTS で生成した合成音声 16,321 > クリップ(16.6 時間)で、実在の話者の録音は含まれません。CPU で実時間より速く > 動きます。未学習16文の正式評価では CER 平均 6.6%(数字・単位の表記を読みにそろえた正規化後は 1.6%)でした。日付・数字の読み誤りの主因はモデルではなく、読み処理(フロントエンド)側にありました。2026年11月20日に、読み処理を pyopenjtalk-plus にそろえて再注釈したデータで追加学習した v2(114,000ステップ)を公開しました。同じ16文評価で、正規化後CERは 1.6% から 1.0% に改善しています。 tiny-voca-ja is a Japanese text-to-speech model with two voices, F2 (female) and M2 (male). It is a from-scratch retrain of [tiny-voca](https://huggingface.co/n4ze3m/tiny-voca) — the same architecture and recipe by Muhammed Nazeem — on Japanese data. It is **not** a fine-tune of the English weights: no pretrained weights are part of the model. The complete model, including the waveform generator, has 4.5M parameters and was trained on about 16.6 hours of synthetic speech. It runs faster than real time on CPU. A fine-tuned **v2** (step 114,000, 2026-11-20) is the current checkpoint in this repository; see **Fine-tune v2** below. The v1 checkpoint remains available in the revision history. - Code (Japanese recipe): https://github.com/gachimoto-code/tiny-voca-ja - Original project: https://github.com/n4ze3m/tiny-voca - Dataset: https://huggingface.co/datasets/gachimoto/tiny-voca-ja | | | |---|---| | Parameters | 4,538,827 | | Voices | F2, M2 (Japanese) | | Output | 24 kHz mono | | Input | Japanese text, converted to phonemes with eSpeak NG (`ja` voice); kanji readings resolved with pykakasi | | Pretrained weights in the model | None | | License | Apache-2.0 | The parameter count is 1,536 higher than the English model (4,537,291) because the phoneme inventory grew from 76 to 84 symbols (8 Japanese additions). ## Files | File | Size | Contents | |---|---:|---| | `tiny-voca-ja.pt` | 18.2 MB | PyTorch weights, float32 (inference checkpoint, format 4; v2, step 114,000) | | `onnx/model.onnx` | 21.4 MB | ONNX export, float32, opset 17 | | `config.json` | | Model settings, phoneme vocabulary, voices, front-end identity | | `samples/` | | The audio samples on this page, synthesized by this model | | `metrics.jsonl` | 11.0 MB | Full training log of the v1 run | | `metrics-finetune-v2.jsonl` | 1.1 MB | Training log of the v2 fine-tune run | SHA256: - `tiny-voca-ja.pt`: `bace068fa0c0a52974df6abe33b650f7b1eeed97ff714f3bab559c14d9b96476` - `onnx/model.onnx`: `105ac483371607ff25b9ac694d40b1f6d8d979d838e5848ff4bd366ee14bb0c9` The v1 ONNX export was verified against the PyTorch model on a Japanese sentence for both voices: identical durations, and a waveform difference of at most 0.16% of the peak amplitude (the noise signal is drawn by each runtime, as in the English model). For v2, the web-app ONNX export of the same checkpoint (same weights, a different graph wrapper) was verified against PyTorch synthesis with correlation 1.000000 and a maximum waveform difference of 0.0005. ## Samples Synthesized on a CPU-only Linux machine (no GPU). CER is the character error rate of a Whisper small (multilingual) transcription against the input text, computed in a kana-normalized space so that kanji spelling variants are not counted as errors. See **Evaluation** for the caveats — this is four sentences, not a benchmark. | # | Voice | Text | CER | |---|---|---|---:| | 1 | F2 | こんにちは、これは日本語の音声合成のテストです。 | 0.0% | | 2 | F2 | はじめまして。私は日本語で話す、小さな音声合成モデルです。 | 0.0% | | 3 | M2 | 今日は十一月十九日、木曜日です。東京の天気は、晴れのち曇りでしょう。 | 0.0% | | 4 | F2 | 人工知能が、日本語の文章を読み上げます。声の大きさも、速さも、自由に変えられます。 | 0.0% | Sample 3 was scored 29.2% in the original spot check; that figure later turned out to be mostly a scoring artifact, and the same audio scores 0.0% once numeral notation is normalized on both sides — see the correction in **Evaluation**. ## Usage **v2 checkpoint note.** The current checkpoint (v2, step 114,000) was fine-tuned for the pyopenjtalk-plus front end (front-end identity `oj-1`), so the stock CLI below — which targets the v1 eSpeak front end — will refuse it as a front-end mismatch. Use the OJ adapter in the repository (`frontend-swap/oj_frontend.py`), or the web app [tiny-voca-ja-web](https://github.com/gachimoto-code/tiny-voca-ja-web), whose phonemizer is matched to v2. The v1 checkpoint in the revision history works with the CLI as written. The Japanese front end uses eSpeak NG with the `ja` voice, so the checkpoint only speaks Japanese text. You need the `espeak-ng` system package and the code from the Japanese recipe repository. ```bash sudo apt install espeak-ng # or your platform's equivalent pip install git+https://github.com/gachimoto-code/tiny-voca-ja hf download gachimoto/tiny-voca-ja --local-dir tiny-voca-ja tiny-voca-speak \ --checkpoint tiny-voca-ja/tiny-voca-ja.pt \ --voice F2 \ --text "こんにちは、これは日本語の音声合成のテストです。" \ --output hello.wav ``` (`python -m tiny_voca.infer` with the same arguments works too.) | Option | Default | Meaning | |---|---|---| | `--text-file` | | Read the text from a file instead of `--text`. | | `--voice` | `F2` | `F2` or `M2` | | `--speed` | 1.0 | Speaking rate | | `--pitch-shift` | 0 | Added to log F0. 0.058 is about one semitone. | | `--pitch-range` | 1.0 | Scales pitch movement around the utterance mean. | Text of any length works. The command reads it one sentence at a time and joins the audio. The checkpoint records the front end it was trained with; inference refuses to run with a mismatched front end unless `--allow-frontend-mismatch` is given. Synthesis measured on a small shared CPU-only VM: 2.8–6.3 seconds per sentence including model load, for 4.4–8.1 seconds of audio — faster than real time, but this VM is far from a benchmark machine. ### ONNX The graph takes phoneme ids and stress values and returns the waveform. Text is converted to ids outside the graph with the Japanese front end (eSpeak NG `ja` + pykakasi); the ids are the positions in `vocab` in `config.json`. Inputs and outputs are the same as the English model: inputs `tokens`, `stress`, `voice` (0 = F2, 1 = M2), `speed`, `pitch_shift`, `pitch_range`; outputs `audio` (24 kHz float32) and `durations`. The model reads one utterance per call, up to 512 tokens and 32 seconds. The audio can peak a little above 1.0, so scale it down before saving 16-bit samples. ## Model Text is converted to phonemes with a stress value for each. A transformer encoder (4 blocks) reads the phonemes, a duration predictor gives each one a length in frames, and two frame-level transformers (2 and 5 blocks) predict pitch, voicing and energy and then the parameters of the waveform generator. All blocks use 192 channels, 4 heads and rotary position embeddings. The waveform is produced by a source-filter synthesizer instead of a neural vocoder. A band-limited pulse train at the predicted pitch and a noise signal are each shaped by a time-varying filter, whose cepstrum the network predicts once per frame (256 samples, 10.7 ms). This part has 25,862 parameters. The Japanese model uses the same components as the English one; only the phoneme embedding grows with the 84-symbol inventory. ## Training | | | |---|---| | Data | [gachimoto/tiny-voca-ja](https://huggingface.co/datasets/gachimoto/tiny-voca-ja): 16,321 clips, 16.6 hours, two voices; 11,561 clips (11.5 hours) passed annotation and were used for training (10,884 train / 332 validation / 345 test) | | Steps | 104,000 | | Hardware | One RTX 4090 (rented, RunPod), about 5.3 hours | | Final loss | 10.717 (base loss 6.494) at step 104,000 | | Losses | Multi-resolution spectral losses; adversarial loss with multi-period and multi-resolution discriminators after step 8,000 (gan-ratio 0.7) | The training audio is synthetic. Both voices were created from text descriptions with Qwen3-TTS VoiceDesign, and the recordings were generated with Qwen3-TTS 1.7B Base. No recording of a real speaker is involved. Phoneme durations come from forced alignment with `prj-beatrice/japanese-hubert-base-phoneme-ctc-v2`, with labels from pyopenjtalk-plus. This differs from the English recipe on purpose: the eSpeak-based aligner used there (`facebook/wav2vec2-lv-60-espeak-cv-ft`) accepted 0 of 150 Japanese smoke-test clips — it has not learned Japanese acoustics — so a Japanese phoneme CTC model was used instead. 11,561 of the 16,321 clips (70.8%) passed the alignment checks. ### Fine-tune v2 (2026-11-20) The v1 checkpoint was fine-tuned for +10,000 steps (114,000 total) on the same synthetic corpus, re-annotated end to end: pyopenjtalk-plus labels with forced alignment by the beatrice phoneme recognizer, mapped to the 84-symbol inventory. 15,558 of the 16,321 clips passed the checks (14,652 train / 453 validation / 453 test). The front-end identity of the checkpoint therefore changed from eSpeak (v3) to `oj-1` (pyopenjtalk-plus, `g2p_prosody` mode). One honest caveat: because of a learning-rate schedule quirk (the decay term used the absolute step), the effective learning rate was about 2e-6 — roughly 1/40 of the intended 1e-4. The improvement below was obtained anyway, at about $2 of rented GPU time. Samples from the v2 evaluation set (the 16-sentence formal evaluation, matched front end): - 「明日の午後、駅前の本屋で友人と待ち合わせをしています。」 - 「この電車は、博多行きの特急ですか。それとも普通列車ですか。」 — v1 misread 特急 here; v2 reads it correctly. - 「予約は2027年2月25日の午前10時25分発の便です。」 ## Evaluation Character error rate of synthesized speech, compared in a kana-normalized space so that kanji spelling variants are not counted as errors. Two checks have been run, both synthesized locally on CPU: a 4-sentence sanity check transcribed with Whisper small (multilingual), and a formal evaluation of 16 unseen sentences transcribed with Whisper large-v3: | Sentences | Clips | CER | |---|---:|---:| | New sentences, not in the dataset | 4 | 7.3% mean (0.0 / 0.0 / 29.2 / 0.0) with the original kana-only scoring; 0.0% mean after numeral normalization | | Formal evaluation, 16 unseen sentences (Whisper large-v3) | 16 | 6.6% mean raw, 1.6% after numeral/unit normalization | | Formal evaluation, 16 unseen sentences, v2 fine-tune with the matched pyopenjtalk-plus front end (Whisper large-v3) | 16 | 6.0% mean raw, 1.0% after numeral/unit normalization; UTMOS 3.73 (v1 with the same front end: 1.6% normalized, UTMOS 3.67) | The 4-sentence row is a sanity check, not a benchmark. The formal evaluation has since been run (2026-11-19): 16 unseen sentences covering dates in both numeral styles, times, money, counters, place and personal names, a phone number, decimals, homophones and one long sentence, transcribed with Whisper large-v3. The stock front end scored 6.6% mean CER raw and 1.6% after normalizing numeral and unit notation on both sides; 13 of the 16 sentences scored 0.0% normalized. No listening test has been run. **Correction (2026-11-19).** Sample 3's 29.2% was mostly a measurement artifact: the ASR writes dates as digits ("11月19日") while the reference is read as kanji numerals, and the kana scorer drops digits, so matching sounds were counted as errors on one side only. Normalized, that sentence scores 0.0% — the audio was correct. The genuine reading errors were in Arabic-numeral date sentences (「今日は」 read as the greeting 「こんにちは」, a wrong weekday); an experiment in the GitHub repository (experiments/frontend-swap) shows they come from the front end, not the model: with pyopenjtalk-plus readings the same checkpoint scores 0.0% on that sentence, and 1.6% mean normalized CER over the 16-sentence set. ## Limitations - Japanese only, two fixed voices, no voice cloning. - **Numbers and dates depend on the front end.** The stock front end misreads some Arabic-numeral date sentences (「今日は」 read as the greeting 「こんにちは」, weekday mix-ups). An earlier version of this card also described the kanji-numeral date sample as a reading failure (CER 29.2%); that was a scoring artifact, corrected in **Evaluation** above. Writing numbers out in kana before synthesis avoids most of the genuine cases. - Pitch accent is not modeled explicitly; the model only sees what the eSpeak front end provides, so accent can sound flat or foreign. - The voice is clear but can sound slightly synthetic. - The same text is always read the same way. There is no sampling of prosody. - Foreign names and unusual kanji readings depend on the front end and are often misread. - No streaming. - The training data is itself synthetic, so the model cannot be more natural than the model that generated it. ## Cost About $20 of rented GPU time in total (estimated from pod hours × the $0.89/h rate; not reconciled against the RunPod billing screen). Roughly: $9.18 for dataset generation, $4.69 for the final training run, the rest for voice design, environment setup and the failed annotation attempts. The English original cost $9.56; the Japanese version cost about twice that, mainly because of the aligner replacement and the higher per-hour rate of the GPU that was actually available. ## License The weights and code are released under Apache-2.0. tiny-voca-ja is a derivative work of [tiny-voca](https://huggingface.co/n4ze3m/tiny-voca) by Muhammed Nazeem, used under Apache-2.0. The architecture, training recipe and code base are his; the Japanese front end, corpus, annotation pipeline and training run are this project's. If you use this model, please credit both. ## Citation ```bibtex @software{fujimoto2026tinyvocaja, author = {Fujimoto, Satoshi}, title = {tiny-voca-ja: a 4.5M-parameter two-voice Japanese text-to-speech model}, year = {2026}, url = {https://huggingface.co/gachimoto/tiny-voca-ja} } ``` Original model: ```bibtex @software{nazeem2026tinyvoca, author = {Nazeem, Muhammed}, title = {tiny-voca: a 4.5M-parameter two-voice English text-to-speech model}, year = {2026}, url = {https://huggingface.co/n4ze3m/tiny-voca} } ``` Author: gachimoto (Satoshi Fujimoto). ## Acknowledgements The design builds on FastSpeech 2 (explicit duration and prosody prediction), DDSP and the neural homomorphic vocoder (source-filter synthesis with predicted filters), and HiFi-GAN and UnivNet (discriminators). No code or weights from these projects are used. The Japanese alignment uses [prj-beatrice/japanese-hubert-base-phoneme-ctc](https://huggingface.co/prj-beatrice/japanese-hubert-base-phoneme-ctc) (Apache-2.0) and pyopenjtalk-plus.