> ## Documentation Index > Fetch the complete documentation index at: https://docs.vmeg.ai/llms.txt > Use this file to discover all available pages before exploring further. # List system voices > List read-only preset voices for **Synthesize speech** requests. Pick a `voiceId` from the response. See [Voices](/guides/assets/voices). ## OpenAPI ````yaml /api-reference/openapi.json post /openapi/v1/assets/voice/basic/list openapi: 3.1.0 info: title: VMEG Open API description: >- Integrate VMEG into your product: translate and dub video or audio, synthesize speech, clone voices, translate plain text, and manage API-side files. All responses use `{ code, message, data }`; `code === 200` means success. version: 1.0.0 servers: - url: https://api.vmeg.ai description: Production security: - apiKeyAuth: [] tags: - name: Media translation x-group: Video & audio translate and dub description: >- Localize uploaded video or audio end-to-end: transcribe speech, translate the script, generate AI dubbing (cloned or preset voices), and return new dubbed media. Optional subtitles and lip sync. **Async only** — dubbed files arrive via [Webhook](/guides/webhooks). This is not plain text translation; see [Media translation](/guides/products/media-translation). - name: TTS x-group: Text to speech (TTS) description: >- Turn text into natural speech with preset or cloned voices. **Sync** returns audio URLs in the HTTP response; **async** delivers results via [Webhook](/guides/webhooks). See [Text to speech](/guides/products/text-to-speech). - name: Voice clone x-group: Voice cloning description: >- Create a reusable voice from a short reference recording. Returns a `voiceId` you can pass to TTS or translate-and-dub jobs. See [Voice clone](/guides/products/voice-clone). - name: Text translation x-group: Text translation (text only) description: >- Translate plain text segments — no audio or video processing. For spoken content in media files, use **Video & audio translate and dub** instead. See [Text translation](/guides/products/text-translation). - name: Task management x-group: Task status and history description: >- List, inspect, or delete jobs created through any product API. Poll `GET .../tasks/detail` when you cannot rely on webhooks. Scoped to your **API Key**. See [Products overview](/guides/products/overview). - name: Assets - Materials x-group: Upload files (materials) description: >- Upload and manage video/audio files used as input for translate-and-dub jobs. Flow: finish the full upload (presigned or multipart → register) → pass the registered `materialId` to create-async. See [Material upload](/guides/assets/material-upload). - name: Assets - Voices x-group: Voices (presets and clones) description: >- List preset voices for TTS, or manage voices you cloned. Cloned voices are created via **Voice cloning**. See [Voices](/guides/assets/voices). paths: /openapi/v1/assets/voice/basic/list: post: tags: - Assets - Voices summary: List system voices description: >- List read-only preset voices for **Synthesize speech** requests. Pick a `voiceId` from the response. See [Voices](/guides/assets/voices). operationId: voiceBasicList requestBody: content: application/json: schema: $ref: '#/components/schemas/OpenApiBasicVoiceListRequest' responses: '200': description: Success content: application/json: schema: $ref: '#/components/schemas/OpenApiBasicVoiceListResponse' components: schemas: OpenApiBasicVoiceListRequest: type: object properties: voiceId: type: string description: Filter by preset `voiceId`. See [Voices](/guides/assets/voices) searchName: type: string description: Search by display or local name locale: type: string example: en-US description: >- Filter by locale (BCP-47). See [Supported languages](/guides/supported-languages) age: type: string description: young / adult / senior gender: type: string description: Filter by gender quality: type: string description: any / high category: type: string description: Filter by voice category emotionPrompt: type: string description: exclude / include topIds: type: array items: type: string description: >- Pin these preset `voiceId` values to the top. See [Voices](/guides/assets/voices) currentPage: type: integer default: 1 description: Page number (1-based) pageSize: type: integer default: 10 description: Page size orderBy: type: string description: voiceId / score / create_time / update_time / is_preferred order: type: string default: desc description: 'Sort direction: `asc` or `desc`' OpenApiBasicVoiceListResponse: allOf: - $ref: '#/components/schemas/OpenApiResponseBase' - type: object properties: data: $ref: '#/components/schemas/OpenApiBasicVoiceListData' OpenApiResponseBase: type: object properties: code: type: integer example: 200 description: Business code; 200 means success message: type: string example: '' description: Human-readable detail when `code` is not success required: - code OpenApiBasicVoiceListData: type: object properties: records: type: array items: $ref: '#/components/schemas/OpenApiBasicVoiceDto' description: Voices on this page total: type: integer format: int64 description: Total voices matching filters OpenApiBasicVoiceDto: type: object properties: voiceId: type: string description: System preset voice ID. See [Voices](/guides/assets/voices) localName: type: string description: Localized voice name displayName: type: string description: Display name in the voice picker locale: type: string example: en-US description: Primary locale (BCP-47) for this preset localeName: type: string description: Human-readable locale label provider: type: string description: >- Preset tier code (`S1`–`S7`). See [Supported clone methods](/guides/supported-clone-methods). gender: type: string description: Gender label (e.g. male, female) style: type: string description: Speaking style tag rolePlay: type: string description: Role-play or character tag description: type: string description: Marketing or catalog description personalities: type: string description: Comma-separated personality tags personalityList: type: array items: type: string description: Personality tags as a list scenarios: type: string description: Recommended use-case tags scenarioList: type: array items: type: string description: Use-case tags as a list isHd: type: integer description: '`1` if this is an HD voice' isPreferred: type: integer description: '`1` if marked preferred in the catalog' score: type: number description: Ranking score in list results cover: type: string description: Cover image URL (HTTPS). Use the URL as returned. audio: type: string description: Sample preview audio URL (HTTPS). Use the URL as returned. createTime: type: string description: Record creation time updateTime: type: string description: Record last update time securitySchemes: apiKeyAuth: type: http scheme: bearer description: >- Send your API Key in the **`Authorization`** header (`Bearer `). See [Authentication](/guides/authentication). ````