Files
qwentts.cpp/src/tts-server.h
T

320 lines
12 KiB
C++

#pragma once
// tts-server.h: shared OpenAI-compatible TTS HTTP core for the *.cpp ports.
//
// One synthesis context lives GPU resident for the process lifetime. The
// project tool fills a tts_backend adapter that wires its own ABI
// (qt_synthesize / ov_synthesize) into the generic sink, then calls
// tts_server_run. The HTTP layer, tuning, OAI parsing and audio framing
// are identical across projects ; only the adapter differs.
//
// Endpoints:
// POST /v1/audio/speech OAI text-to-speech
// GET /v1/models single loaded model
// GET /v1/voices named speakers (empty when the model has none)
// GET /health liveness probe
//
// Audio out: response_format "pcm" streams s16le 24 kHz mono chunked as it
// is generated (real time), "wav" returns a one-shot RIFF file. pcm is the
// default so streaming is on unless the client asks for a file.
#include "../vendor/cpp-httplib/httplib.h"
#include "audio-io.h"
#include "yyjson.h"
#include <cmath>
#include <csignal>
#include <cstdint>
#include <cstdio>
#include <functional>
#include <mutex>
#include <string>
#include <vector>
// One synthesis request parsed from the OAI JSON body.
struct tts_request {
std::string input; // text to speak
std::string voice; // OAI voice, mapped to a speaker by the adapter
std::string instructions; // OAI instructions, mapped to the ABI instruct field
std::string format; // "pcm" (stream) or "wav" (one-shot)
float speed; // OAI speed, parsed then ignored (no time stretch in the ABI)
};
// The adapter pushes mono f32 24 kHz audio here. Returns false to abort the
// synthesis (client gone or cancellation), which propagates into the ABI
// on_chunk and stops generation.
using tts_sink = std::function<bool(const float * samples, int n_samples)>;
// Adapter implemented by each project tool.
struct tts_backend {
std::string model_id; // reported by GET /v1/models
std::vector<std::string> voices; // reported by GET /v1/voices, may be empty
// Run synthesis. When the request streams, the adapter routes the ABI
// on_chunk to sink ; otherwise it pushes the whole buffer once. Returns
// the ABI status (0 on success), and fills err with the ABI message on
// failure. The shared layer maps the status to an HTTP code.
std::function<int(const tts_request & req, const tts_sink & sink, std::string & err)> synthesize;
};
struct server_config {
std::string host = "127.0.0.1";
int port = 8080;
};
// Single GPU context : synthesis is serialised FIFO across connections.
static std::mutex g_synth_mutex;
static httplib::Server * g_svr = nullptr;
static void tts_on_signal(int) {
if (g_svr) {
g_svr->stop();
}
}
// Clamp to [-1, 1] and scale to s16. lrintf rounds to nearest, ties to even.
static inline int16_t tts_f32_to_s16(float x) {
float v = x < -1.0f ? -1.0f : (x > 1.0f ? 1.0f : x);
return (int16_t) lrintf(v * 32767.0f);
}
// Append a mono f32 block as s16le bytes onto out.
static void tts_append_s16le(std::string & out, const float * samples, int n_samples) {
size_t base = out.size();
out.resize(base + (size_t) n_samples * 2);
char * p = &out[base];
for (int i = 0; i < n_samples; i++) {
int16_t s = tts_f32_to_s16(samples[i]);
*p++ = (char) ((uint16_t) s & 0xff);
*p++ = (char) (((uint16_t) s >> 8) & 0xff);
}
}
// Write a JSON error body in the OAI error envelope and set the status.
static void tts_json_error(httplib::Response & res, int status, const char * type, const char * message) {
yyjson_mut_doc * doc = yyjson_mut_doc_new(NULL);
yyjson_mut_val * root = yyjson_mut_obj(doc);
yyjson_mut_doc_set_root(doc, root);
yyjson_mut_val * err = yyjson_mut_obj(doc);
yyjson_mut_obj_add_str(doc, err, "message", message);
yyjson_mut_obj_add_str(doc, err, "type", type);
yyjson_mut_obj_add_val(doc, root, "error", err);
char * json = yyjson_mut_write(doc, 0, NULL);
res.status = status;
res.set_content(json ? json : "{}", "application/json");
if (json) {
free(json);
}
yyjson_mut_doc_free(doc);
}
// Parse the OAI body into req. Returns false and fills err on bad input.
static bool tts_parse_request(const std::string & body, tts_request & req, std::string & err) {
yyjson_doc * doc = yyjson_read(body.c_str(), body.size(), 0);
if (!doc) {
err = "request body is not valid JSON";
return false;
}
yyjson_val * root = yyjson_doc_get_root(doc);
if (!yyjson_is_obj(root)) {
err = "request body must be a JSON object";
yyjson_doc_free(doc);
return false;
}
yyjson_val * input = yyjson_obj_get(root, "input");
if (!yyjson_is_str(input) || yyjson_get_len(input) == 0) {
err = "'input' must be a non-empty string";
yyjson_doc_free(doc);
return false;
}
req.input = yyjson_get_str(input);
yyjson_val * voice = yyjson_obj_get(root, "voice");
req.voice = yyjson_is_str(voice) ? yyjson_get_str(voice) : "";
yyjson_val * instructions = yyjson_obj_get(root, "instructions");
req.instructions = yyjson_is_str(instructions) ? yyjson_get_str(instructions) : "";
yyjson_val * fmt = yyjson_obj_get(root, "response_format");
req.format = yyjson_is_str(fmt) ? yyjson_get_str(fmt) : "pcm";
yyjson_val * speed = yyjson_obj_get(root, "speed");
req.speed = yyjson_is_num(speed) ? (float) yyjson_get_num(speed) : 1.0f;
yyjson_doc_free(doc);
if (req.format != "pcm" && req.format != "wav") {
err = "response_format must be 'pcm' or 'wav'";
return false;
}
return true;
}
// Map an ABI status to an HTTP code. The two ABIs share numeric values:
// -1 invalid params, -2 mode/instruct invalid -> client error ; the rest
// are server side failures.
static int tts_status_to_http(int rc) {
if (rc == 0) {
return 200;
}
if (rc == -1 || rc == -2) {
return 400;
}
return 502;
}
static void tts_handle_speech(const tts_backend & be, const httplib::Request & http_req, httplib::Response & res) {
tts_request req;
std::string err;
if (!tts_parse_request(http_req.body, req, err)) {
tts_json_error(res, 400, "invalid_request_error", err.c_str());
return;
}
if (req.format == "wav") {
// One-shot : collect the whole utterance, then emit a RIFF file.
std::vector<float> buf;
tts_sink sink = [&buf](const float * s, int n) {
buf.insert(buf.end(), s, s + n);
return true;
};
std::string synth_err;
int rc;
{
std::lock_guard<std::mutex> lock(g_synth_mutex);
rc = be.synthesize(req, sink, synth_err);
}
if (rc != 0) {
tts_json_error(res, tts_status_to_http(rc), "server_error",
synth_err.empty() ? "synthesis failed" : synth_err.c_str());
return;
}
std::string wav = audio_encode_wav(buf.data(), (int) buf.size(), 24000, WAV_S16);
res.set_content(std::move(wav), "audio/wav");
return;
}
// Streaming : run synthesis inside the chunked provider on the connection
// thread, pushing s16le frames as the codec produces them. A failed
// sink.write means the client disconnected, which aborts generation and
// frees the GPU instead of finishing a stream nobody reads.
res.set_header("Cache-Control", "no-cache");
res.set_header("X-Accel-Buffering", "no");
res.set_chunked_content_provider("audio/pcm", [&be, req](size_t, httplib::DataSink & sink) mutable -> bool {
tts_sink push = [&sink](const float * s, int n) {
std::string bytes;
tts_append_s16le(bytes, s, n);
return sink.write(bytes.data(), bytes.size());
};
std::string synth_err;
{
std::lock_guard<std::mutex> lock(g_synth_mutex);
be.synthesize(req, push, synth_err);
}
sink.done();
return true;
});
}
static void tts_handle_models(const tts_backend & be, const httplib::Request &, httplib::Response & res) {
yyjson_mut_doc * doc = yyjson_mut_doc_new(NULL);
yyjson_mut_val * root = yyjson_mut_obj(doc);
yyjson_mut_doc_set_root(doc, root);
yyjson_mut_obj_add_str(doc, root, "object", "list");
yyjson_mut_val * data = yyjson_mut_arr(doc);
yyjson_mut_val * one = yyjson_mut_obj(doc);
yyjson_mut_obj_add_str(doc, one, "id", be.model_id.c_str());
yyjson_mut_obj_add_str(doc, one, "object", "model");
yyjson_mut_obj_add_str(doc, one, "owned_by", "local");
yyjson_mut_arr_add_val(data, one);
yyjson_mut_obj_add_val(doc, root, "data", data);
char * json = yyjson_mut_write(doc, 0, NULL);
res.set_content(json ? json : "{}", "application/json");
if (json) {
free(json);
}
yyjson_mut_doc_free(doc);
}
static void tts_handle_voices(const tts_backend & be, const httplib::Request &, httplib::Response & res) {
yyjson_mut_doc * doc = yyjson_mut_doc_new(NULL);
yyjson_mut_val * root = yyjson_mut_obj(doc);
yyjson_mut_doc_set_root(doc, root);
yyjson_mut_val * arr = yyjson_mut_arr(doc);
for (const std::string & v : be.voices) {
yyjson_mut_val * one = yyjson_mut_obj(doc);
yyjson_mut_obj_add_str(doc, one, "name", v.c_str());
yyjson_mut_arr_add_val(arr, one);
}
yyjson_mut_obj_add_val(doc, root, "voices", arr);
char * json = yyjson_mut_write(doc, 0, NULL);
res.set_content(json ? json : "{}", "application/json");
if (json) {
free(json);
}
yyjson_mut_doc_free(doc);
}
static void tts_handle_health(const httplib::Request &, httplib::Response & res) {
res.set_content("{\"status\":\"ok\"}", "application/json");
}
static int tts_server_run(const tts_backend & be, const server_config & cfg) {
httplib::Server svr;
g_svr = &svr;
// per-operation socket idle timeouts. read is small (text in), write is
// generous to cover a long streamed utterance without tripping on a slow
// client.
svr.set_read_timeout(60);
svr.set_write_timeout(120);
// reject oversized bodies. text plus an optional reference clip stays
// well under this.
svr.set_payload_max_length(32 * 1024 * 1024);
// Nagle coalescing holds small packets back for tens of ms ; streamed
// PCM chunks must leave the socket the moment they are written.
svr.set_tcp_nodelay(true);
// SO_REUSEADDR lets us rebind a port still in TIME_WAIT after a restart.
// SO_REUSEPORT is deliberately not set : a second instance on the same
// port then fails with EADDRINUSE instead of silently sharing the socket
// and splitting traffic between two daemons.
svr.set_socket_options([](socket_t sock) {
int one = 1;
#ifdef _WIN32
setsockopt(sock, SOL_SOCKET, SO_REUSEADDR, (const char *) &one, sizeof(one));
#else
setsockopt(sock, SOL_SOCKET, SO_REUSEADDR, &one, sizeof(one));
#endif
});
// permissive CORS so a browser client can call the API directly.
svr.set_default_headers({
{ "Access-Control-Allow-Origin", "*" }
});
svr.Options("/.*", [](const httplib::Request &, httplib::Response & res) {
res.set_header("Access-Control-Allow-Methods", "GET, POST, OPTIONS");
res.set_header("Access-Control-Allow-Headers", "Content-Type");
});
svr.Post("/v1/audio/speech",
[&be](const httplib::Request & req, httplib::Response & res) { tts_handle_speech(be, req, res); });
svr.Get("/v1/models",
[&be](const httplib::Request & req, httplib::Response & res) { tts_handle_models(be, req, res); });
svr.Get("/v1/voices",
[&be](const httplib::Request & req, httplib::Response & res) { tts_handle_voices(be, req, res); });
svr.Get("/health", tts_handle_health);
signal(SIGINT, tts_on_signal);
signal(SIGTERM, tts_on_signal);
fprintf(stderr, "[Server] model %s\n", be.model_id.c_str());
fprintf(stderr, "[Server] listening on %s:%d\n", cfg.host.c_str(), cfg.port);
if (!svr.listen(cfg.host.c_str(), cfg.port)) {
fprintf(stderr, "[Server] FATAL: cannot bind %s:%d\n", cfg.host.c_str(), cfg.port);
return 1;
}
return 0;
}