# Changelog

Các thay đổi của API công khai.

API đánh phiên bản theo đường dẫn (`/v1`). Trong một phiên bản chỉ **thêm** field, endpoint và giá trị enum; thay đổi phá vỡ tương thích sẽ ra `/v2`. Hãy viết code bỏ qua field lạ.

## 2026-11-18: Phiên bản đầu tiên

Ra mắt API `v1` với model `sota-voice-v1`:

- `POST /v1/audio/speech`: trọn file (`mp3`, `wav`, `opus`, `aac`, `flac`, `pcm`), stream PCM và SSE.
- WebSocket `GET /v1/audio/speech/stream` cho voice agent realtime, token trình duyệt qua `POST /v1/tokens`.
- Job bất đồng bộ `/v1/audio/speech/jobs` đến 100.000 ký tự, có `Idempotency-Key` và webhook ký bằng `Sota-Signature`.
- Nhân bản giọng có đồng ý: `/v1/audio/voices`.
- `GET /v1/models`, `GET /v1/credits`.

