docs(server): drop phantom --talker-model + --code2wav-model rows#85
Merged
Conversation
Epoch #81 task 5 (docs review). Both rows in the server-specific params table reference qwen3-omni TTS support that does not exist: * Neither --talker-model nor --code2wav-model is registered in common/arg.cpp; no C++ source mentions the strings "talker" or "code2wav" (only model-conversion code in conversion/qwen3.py references them as tensor name prefixes, which is unrelated). * The /v1/audio/speech endpoint the help text promises is also absent — only /v1/audio/transcriptions is wired up via routes.post_transcriptions_oai in server.cpp:198. The /v1/audio/speech string appears only in the webui's TTS *client* code (it calls out to a separate OpenAI-compatible TTS server, not back to llama-server). The vocoder-related flags that DO exist (--model-vocoder, --tts-use-guide-tokens) are still documented elsewhere and unchanged.
This was referenced Jun 5, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Epoch #81 task 5 (docs review on `tools/server/README.md`). The server-specific params table at lines 178-179 documented two flags that don't exist on this fork:
The webui does reference `/v1/audio/speech` — but only in its TTS client code (calling out to an external OpenAI-compatible TTS server), not as something llama-server itself serves.
The real vocoder-related flags (`--model-vocoder`, `--tts-use-guide-tokens`) are still documented elsewhere and unchanged.
Test plan
Audit scope
Spot-checked 6 documented defaults (`--ctx-checkpoints`, `--models-max`, `--cache-ram`, `--slot-prompt-similarity`, `--reasoning`, `--models-autoload`) — all match `common/common.h` values. So no broader sweep needed.
🤖 Generated with Claude Code