API Overview
The Mossland API uses /v1 audio endpoints. You call the endpoint that matches the capability you need, select a model with model, and receive results via a synchronous response, an asynchronous task, or an explicit status query.
Core concepts
- Endpoint – The interface entry point you request, for example
POST /v1/audio/speech. - model – Specifies the model to invoke, for example
moss-tts;/v1uses a singlemodelfield to name the model. - delivery_method –
audioreturns the audio directly;urlreturns JSON with a result URL. - response_format – The audio encoding format, such as
mp3/wav; defaults tomp3. - async / webhook_url – Pass
async=trueto create an asynchronous task; once it reaches a terminal state, the result is delivered towebhook_url. - task_id – The server returns a
task_idfor asynchronous tasks, used to query status and results.
Endpoint catalog
| Endpoint | Description | Sync | Async |
|---|---|---|---|
| GET /v1/models | List available models | ✓ | - |
| POST /v1/files | Upload a file and obtain a file_id | ✓ | - |
| GET /v1/files | List files | ✓ | - |
| GET /v1/files/{file_id} | Get file details | ✓ | - |
| DELETE /v1/files/{file_id} | Delete a file | ✓ | - |
| POST /v1/audio/speech | Single-speaker text-to-speech | ✓ | ✓ |
| POST /v1/audio/speech/speakers | Multi-speaker dialogue speech generation | ✓ | ✓ |
| POST /v1/audio/voice/generations | Voice / speech generation | ✓ | ✓ |
| GET /v1/audio/voices | List voices | ✓ | - |
| POST /v1/audio/voices | Create / clone a voice | ✓ | - |
| POST /v1/audio/transcriptions | Audio transcription (including multi-speaker) | ✓ | ✓ |
| GET /v1/audio/tasks/{task_id} | Query a general audio task | ✓ | - |