# Albastov API

> Developer documentation for the Albastov API at https://api.albastov.com/v1, for albastov.com accounts and their keys: chat completions, text to speech, voices and voice cloning, speech to text, live dictation and events. Every link below is the page as plain markdown; the rendered pages are at https://albastov.com/docs.

Send the key as `Authorization: Bearer <key>`. The same pages as JSON: `GET https://api.albastov.com/v1/docs` (index) and `GET https://api.albastov.com/v1/docs/{section}/{page}`.

## Get started

- [Overview](https://api.albastov.com/v1/docs/get-started/introduction.md): Language models, speech, voices and events on your albastov.com account, behind one key.
- [Quick start](https://api.albastov.com/v1/docs/get-started/quick-start.md): Get a key, send a chat completion and read the reply.

## Language models

- [Language models](https://api.albastov.com/v1/docs/language-models/overview.md): OpenAI-compatible chat completions on open-weight Qwen and DeepSeek models.
- [Chat completions](https://api.albastov.com/v1/docs/language-models/chat-completions.md): Messages, model choice, conversation history, OpenAI SDKs, prompt caching, model loading, retries and limits on POST /v1/chat/completions.
- [Streaming](https://api.albastov.com/v1/docs/language-models/streaming.md): Chat completions as server-sent events, token by token.
- [Tools and structured output](https://api.albastov.com/v1/docs/language-models/tools-and-structured-output.md): Function calling with tools, and JSON output that matches a schema.
- [Thinking](https://api.albastov.com/v1/docs/language-models/thinking.md): Reasoning before the answer, on by default, off with chat_template_kwargs.enable_thinking.
- [Chat models](https://api.albastov.com/v1/docs/language-models/models.md): Open-weight Qwen and DeepSeek chat models on one OpenAI-compatible route.
- [Qwen3.8 27B](https://api.albastov.com/v1/docs/language-models/qwen3-8-27b.md): The default chat model, for general chat, tools and JSON output with 150,000 tokens of context.
- [Qwen3.8 27B Fast](https://api.albastov.com/v1/docs/language-models/qwen3-8-27b-fast.md): Qwen3.8 27B tuned for faster answers to a few requests at once.
- [Qwen3.8 27B Uncensored](https://api.albastov.com/v1/docs/language-models/qwen3-8-27b-uncensored.md): Qwen3.8 27B with refusals removed and shorter reasoning, 150,000 tokens of context.
- [Qwen3.8 Flash-Next Abliterated](https://api.albastov.com/v1/docs/language-models/qwen3-8-flash-next-abliterated.md): Qwen3.8 Flash-Next, a mixture-of-experts model with refusals removed, one request at a time.
- [DeepSeek V4.1 Flash](https://api.albastov.com/v1/docs/language-models/deepseek-v4-1-flash.md): DeepSeek V4.1 Flash, a large mixture-of-experts model for short prompts, one request at a time.

## Audio

- [Audio](https://api.albastov.com/v1/docs/audio/overview.md): Text to speech, saved and cloned voices, and speech to text, on OpenAI's audio routes.
- [Text to speech](https://api.albastov.com/v1/docs/audio/text-to-speech.md): Speech from text, in a built-in voice or a saved voice.
- [Voices](https://api.albastov.com/v1/docs/audio/voices.md): Clone, design, list, share, copy and delete saved voices, and speak any text in a saved voice.
- [Voice cloning](https://api.albastov.com/v1/docs/audio/voice-cloning.md): Record a clip that clones well, note the speaker's consent, check a saved voice and pick a cloning model.
- [Speech to text](https://api.albastov.com/v1/docs/audio/speech-to-text.md): Transcripts of audio files, with word and segment timestamps, on OpenAI's transcription route.
- [Live dictation](https://api.albastov.com/v1/docs/audio/live-dictation.md): Speech to text and streamed chat corrections over one WebSocket per session, opened with a signed ticket.
- [Audio models](https://api.albastov.com/v1/docs/audio/models.md): Text to speech, voice cloning and speech to text, on the same routes with the same key.
- [OmniVoice](https://api.albastov.com/v1/docs/audio/omnivoice.md): Clone a voice, or design one from a description.
- [Kokoro](https://api.albastov.com/v1/docs/audio/kokoro.md): Fast, clear narration in 54 ready-made voices.
- [Parakeet](https://api.albastov.com/v1/docs/audio/parakeet.md): Transcripts with punctuation and word timestamps.
- [Qwen3-TTS](https://api.albastov.com/v1/docs/audio/qwen3-tts.md): Faithful cloning from 10 s of audio.
- [Chatterbox](https://api.albastov.com/v1/docs/audio/chatterbox.md): Expressive cloned speech with natural pacing.
- [Fish Audio S2 Pro](https://api.albastov.com/v1/docs/audio/fish-s2pro.md): Studio-quality cloned speech.
- [Higgs Audio v3](https://api.albastov.com/v1/docs/audio/higgs3.md): Conversational cloned speech in 100+ languages.
- [CosyVoice 3](https://api.albastov.com/v1/docs/audio/cosyvoice3.md): Quick cloned speech for short lines.
- [IndexTTS 2.5](https://api.albastov.com/v1/docs/audio/indextts2-5.md): Cloned speech in English and Chinese.
- [BreezeTTS 2](https://api.albastov.com/v1/docs/audio/breeze2.md): Cloned speech with a described delivery.
- [VoxCPM 2](https://api.albastov.com/v1/docs/audio/voxcpm2.md): Cloned speech from a short clip, in 30 languages.
- [FireRedTTS 3](https://api.albastov.com/v1/docs/audio/fireredtts3.md): Multilingual cloned speech in 24 languages.
- [MioTTS](https://api.albastov.com/v1/docs/audio/miotts.md): Light, quick cloned speech.
- [MOSS-TTS Local](https://api.albastov.com/v1/docs/audio/moss-local.md): Careful cloning for batch narration.

## Image

- [Image](https://api.albastov.com/v1/docs/image/overview.md): Images from a text prompt or from another image. Planned; no routes yet.
- [Image generation](https://api.albastov.com/v1/docs/image/image-generation.md): Images from a text prompt or from another image.

## Events

- [Events](https://api.albastov.com/v1/docs/events/overview.md): One-line notices from your apps, stored per source and streamed to readers.
- [Publishing](https://api.albastov.com/v1/docs/events/publishing.md): Add a source, store its publish key, publish events from an app, and set each event's fields and lifetime.
- [Webhooks](https://api.albastov.com/v1/docs/events/webhooks.md): Turn another app's webhooks into events with a mapping stored as data.
- [Receiving](https://api.albastov.com/v1/docs/events/receiving.md): Read keys, listing, the live stream, dismissal, and the ambient/1 client contract.

## API reference

- [API reference](https://api.albastov.com/v1/docs/api-reference/overview.md): Every route of the Albastov API, with its parameters, responses and errors.
- [Authentication](https://api.albastov.com/v1/docs/api-reference/authentication.md): API keys, their scopes and the Authorization header.
- [Errors](https://api.albastov.com/v1/docs/api-reference/errors.md): Error shapes, status codes, key errors and retry rules.
- [Rate limits](https://api.albastov.com/v1/docs/api-reference/rate-limits.md): Call, token, size and wait limits, with the error each returns.
- [Chat completions](https://api.albastov.com/v1/docs/api-reference/chat-completions.md): POST /v1/chat/completions parameters, headers, response and errors.
- [List models](https://api.albastov.com/v1/docs/api-reference/models-list.md): GET /v1/models response fields and errors.
- [Speech](https://api.albastov.com/v1/docs/api-reference/speech.md): POST /v1/audio/speech returns an audio file of the text in a built-in or saved voice.
- [Transcriptions](https://api.albastov.com/v1/docs/api-reference/transcriptions.md): POST /v1/audio/transcriptions returns the transcript of an audio file, with optional timestamps.
- [Voices](https://api.albastov.com/v1/docs/api-reference/voices.md): List, create, design, read, change, copy and delete saved voices, and fetch their clips.
- [Media jobs](https://api.albastov.com/v1/docs/api-reference/media-jobs.md): Speech and transcription jobs, the wait for a result, queue timeouts, and the model list with parameters.
- [Uploads](https://api.albastov.com/v1/docs/api-reference/uploads.md): POST /v1/media/uploads stores an audio or image file on the account and returns its id up_….
- [Samples](https://api.albastov.com/v1/docs/api-reference/samples.md): GET /v1/media/samples lists one sample clip per speech and transcription model; no key needed.
- [Dictation](https://api.albastov.com/v1/docs/api-reference/dictation.md): Open a live dictation session, renew its ticket, open its WebSocket and read the ticket signing keys.
- [Events](https://api.albastov.com/v1/docs/api-reference/events.md): Publish events, receive webhooks, and list, stream and dismiss events.
- [Docs](https://api.albastov.com/v1/docs/api-reference/docs.md): The documentation as JSON, as markdown and as an llms.txt index, and its images, without a key.
- [Status](https://api.albastov.com/v1/docs/api-reference/status.md): GET /v1/status, the current state of the API and of each product, with 90 days of daily states and uptime.

## Changelog

- [Changelog](https://api.albastov.com/v1/docs/changelog/changelog.md): Every change to the Albastov API, newest first.