> For the complete documentation index, see [llms.txt](https://nsclouds.gitbook.io/aillm.nscloud.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://nsclouds.gitbook.io/aillm.nscloud.ai/audio-transcriptions/zai.md).

# Z.AI

### 1. Overview

Z.AI exposes audio transcription capabilities in this environment.

{% hint style="success" %}
This endpoint provides an OpenAI-compatible Audio Transcriptions path. Actual capabilities may vary by vendor and model.
{% endhint %}

**Supported models：**

* `glm-asr-2512`

### 2. API Details

## Audio Transcription

> Provides an OpenAI-compatible Audio Transcriptions endpoint. Supported capabilities may vary by model.

```json
{"openapi":"3.1.0","info":{"title":"NSCloud AI API Documentation","version":"1.11.0"},"tags":[{"name":"audio_transcriptions_zai","description":"Z.AI's audio transcriptions API"}],"servers":[{"url":"https://aillm.nscloud.ai","description":"Global Server"}],"security":[{"APIKeyHeader":[]}],"components":{"securitySchemes":{"APIKeyHeader":{"type":"http","scheme":"bearer","description":"Authenticate using Bearer token format: 'Bearer YOUR_SECRET_TOKEN'"}},"schemas":{"CreateTranscriptionRequest":{"type":"object","description":"Audio transcription request body.","properties":{"model":{"type":"string","description":"Model ID to invoke."},"file":{"type":"string","format":"binary","description":"Audio file to transcribe."},"language":{"type":"string","description":"Optional language code for the audio."},"prompt":{"type":"string","description":"Optional prompt to bias style, formatting, or terminology."},"response_format":{"type":"string","description":"Response format for the transcription result.","enum":["json","text","srt","verbose_json","vtt"],"default":"json"},"temperature":{"type":"number","description":"Sampling temperature.","default":0},"timestamp_granularities":{"type":"array","description":"Timestamp granularities to include when response_format is verbose_json.","items":{"type":"string","enum":["word","segment"]}}},"required":["model","file"]},"TranscriptionResponse":{"type":"object","description":"JSON transcription response.","properties":{"text":{"type":"string","description":"Transcribed text content."}}},"ErrorResponse":{"type":"object","description":"Error response payload.","properties":{"error":{"$ref":"#/components/schemas/ErrorDetail"}}},"ErrorDetail":{"type":"object","description":"Error detail object.","properties":{"message":{"type":"string","description":"Human-readable error message."},"type":{"type":"string","description":"Error type."},"param":{"description":"Parameter associated with the error, if any.","type":["string","null"]},"code":{"description":"Machine-readable error code, if any.","type":["string","null"]}}}},"responses":{"ErrorResponse":{"description":"Error response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}},"paths":{"/v1/audio/transcriptions":{"post":{"tags":["audio_transcriptions_zai"],"summary":"Audio Transcription","description":"Provides an OpenAI-compatible Audio Transcriptions endpoint. Supported capabilities may vary by model.","operationId":"createTranscription_zai","requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/CreateTranscriptionRequest"}}}},"responses":{"200":{"description":"Success Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TranscriptionResponse"}},"application/x-srt":{"schema":{"type":"string","description":"Transcription in SRT subtitle format."}},"text/plain":{"schema":{"type":"string","description":"Transcription in plain text format."}}}},"400":{"$ref":"#/components/responses/ErrorResponse"},"401":{"$ref":"#/components/responses/ErrorResponse"},"429":{"$ref":"#/components/responses/ErrorResponse"}}}}}}
```