kokoro

Kokoro-FastAPI

remsky/Kokoro-FastAPI
- remsky/Kokoro-FastAPI#214
- Cannot use Custom Phonemes in v0.2.4 remsky/Kokoro-FastAPI#348

bash

# CPU
# http://localhost:8880/docs
# http://localhost:8880/web
# http://localhost:8880/v1 OpenAI 兼容接口
# /api/src/core/openai_mappings.json 配置了 voice 映射关系
docker run -p 8880:8880 ghcr.io/remsky/kokoro-fastapi-cpu:latest
# NVIDIA GPU
# docker run --gpus all -p 8880:8880 ghcr.io/remsky/kokoro-fastapi-gpu:latest

model: tts-1 | tts-1-hd | kokoro
download_format
return_download_link
response_format: mp3 | opus | aac | flac | wav | pcm
- mp3
- opus
- aac
- flac
- wav
- pcm
voice: 基础或组合音色名（支持加减权重语法）
speed: 0.25–4.0
stream
lang_code: a | b | z | en-us | en-gb
volume_multiplier
download_format
normalization_options
- normalize: 开启整体文本规范化（大小写/标点/常见缩写等统一处理）
- unit_normalization: 单位转写（如 10KB → “10 kilobytes”）
- url_normalization: URL 可读化（符号转词，如点/斜杠/等号）
- email_normalization: 邮箱可读化（user at domain dot com）
- optional_pluralization_normalization: 将 “(s)” 规范为 “s”
- phone_normalization: 电话号码转读法
- replace_remaining_symbols: 将残留符号替换为对应词语（如 “+”→“plus”）

text

[pause:0.5s]

bash

brew install uv ffmpeg espeak-ng

./start-cpu.sh

uv run --no-sync uvicorn api.src.main:app --host 0.0.0.0 --port 8880

Voice

code	for	cn
lang	语言
a	en-us, American English， 🇺🇸	美式英语
b	en-gb, British English, 🇬🇧	英式英语
z	zh-cn, Mandarin Chinese, 🇨🇳	中文
e	es, Spanish, 🇪🇸	西班牙语
f	fr-fr, French, 🇫🇷	法语
h	hi, Hindi, 🇮🇳	印地语
i	it, Italian, 🇮🇹	意大利语
p	pt-br, Brazilian Portuguese, 🇧🇷	巴西葡萄牙语
j	ja, Japanese, 🇯🇵	日语
gender	性别
f	Female, 🚺	女
m	Male, 🚹	男

Name	Traits	Target Quality	Overall Grade	CC BY / Note
American English
af_heart	🚺❤️		A
af_alloy	🚺	B	C
af_aoede	🚺	B	C+
af_bella	🚺🔥	A	A-
af_jessica	🚺	C	D
af_kore	🚺	B	C+
af_nicole	🚺🎧	B	B-
af_nova	🚺	B	C
af_river	🚺	C	D
af_sarah	🚺	B	C+
af_sky	🚺	B C-
am_adam	🚹	D	F+
am_echo	🚹	C	D
am_eric	🚹	C	D
am_fenrir	🚹	B	C+
am_liam	🚹	C	D
am_michael	🚹	B	C+
am_onyx	🚹	C	D
am_puck	🚹	B	C+
am_santa	🚹	C	D-
British English
bf_alice	🚺	C	D
bf_emma	🚺	B	B-
bf_isabella	🚺	B	C
bf_lily	🚺	C	D
bm_daniel	🚹	C	D
bm_fable	🚹	B	C
bm_george	🚹	B	C
bm_lewis	🚹	C	D+
Japanese
jf_alpha	🚺	B	C+
jf_gongitsune	🚺	B	C	gongitsune
jf_nezumi	🚺	B	C-	nezuminoyomeiri
jf_tebukuro	🚺	B	C	tebukurowokaini
jm_kumo	🚹	B	C-	kumonoito
Mandarin Chinese
zf_xiaobei	🚺	C	D
zf_xiaoni	🚺	C	D
zf_xiaoxiao	🚺	C	D
zf_xiaoyi	🚺	C	D
zm_yunjian	🚹	C	D
zm_yunxi	🚹	C	D
zm_yunxia	🚹	C	D
zm_yunyang	🚹	C	D
Spanish
ef_dora	🚺
em_alex	🚹
em_santa	🚹
French
ff_siwis	🚺	B	B-	SIWIS
Hindi
hf_alpha	🚺	B	C
hf_beta	🚺	B	C
hm_omega	🚹	B	C
hm_psi	🚹	B	C
Italian
if_sara	🚺	B	C
im_nicola	🚹	B	C
Brazilian Portuguese
pf_dora	🚺
pm_alex	🚹
pm_santa	🚹

Target Quality
- 参考音频的音质有多高？评分会受音频质量、杂音、压缩和采样率影响。
- 文本标签与音频的匹配度如何？若存在文本与音频不同步（如幻听），评分会降低。

json

{
  "a":"af_heart",
  "b":"bf_alice",
  "z":"zf_xiaobei",
  "e":"ef_dora",
  "f":"ff_siwis",
  "h":"hf_alpha",
  "i":"if_sara",
  "p":"pf_dora",
  "j":"jf_alpha"
}

Kokoro-FastAPI

Voice

关联信息

参考资料