> ## Documentation Index > Fetch the complete documentation index at: https://docs.creatorline.io/llms.txt > Use this file to discover all available pages before exploring further. # List voices > The values a `voice` parameter accepts (`text-to-speech`, `dialogue`, `change-voice`). These cannot live in `GET /v1/models`: the catalog is a live list, not a fixed enum, which is why those parameters are marked `control: "voice"` and point here. `scope=workspace` (default) is your own and cloned voices; `scope=library` searches the public shared library. A creator's own cloned voice is on their account (`voice_id`) and is used automatically when a run passes `account_id` — call this only when you want a different one. ## OpenAPI ````yaml /openapi.json get /v1/voices openapi: 3.1.0 info: title: Creatorline API version: 1.0.0 description: >- Generate AI influencer photos and videos, and publish them to your creators' social accounts — from your own backend, your scripts, or a coding agent. Every request authenticates with an organization-scoped API key and is charged against that organization's credits, at the same prices the studio shows. servers: - url: https://api.creatorline.io description: Production - url: http://localhost:3000/api description: Local development (the same routes, under the app's own /api prefix) security: - bearerAuth: [] - apiKeyHeader: [] tags: - name: Account description: Who the key belongs to, and what it can spend. - name: Catalog description: The live tool and model catalog. Read it, do not hardcode it. - name: Creators description: The AI creators a generation or post belongs to. - name: Generations description: Start, price and poll image and video runs. - name: Assets description: The media library, and uploading your own files. - name: Posts description: Turn media into a post and publish it to social platforms. - name: Credits description: Balance and the consumption ledger. paths: /v1/voices: get: tags: - Catalog summary: List voices description: >- The values a `voice` parameter accepts (`text-to-speech`, `dialogue`, `change-voice`). These cannot live in `GET /v1/models`: the catalog is a live list, not a fixed enum, which is why those parameters are marked `control: "voice"` and point here. `scope=workspace` (default) is your own and cloned voices; `scope=library` searches the public shared library. A creator's own cloned voice is on their account (`voice_id`) and is used automatically when a run passes `account_id` — call this only when you want a different one. operationId: listVoices parameters: - name: scope in: query schema: type: string enum: - workspace - library default: workspace - name: search in: query schema: type: string - name: gender in: query description: Library scope only. schema: type: string - name: language in: query description: Library scope only, e.g. `en`, `tr`. schema: type: string - name: limit in: query description: How many rows to return (1-100). schema: type: integer default: 20 minimum: 1 maximum: 100 responses: '200': description: Matching voices. headers: x-request-id: description: >- Correlation id for this request. Quote it in any support question. schema: type: string x-ratelimit-limit: description: Requests allowed per minute. schema: type: integer x-ratelimit-remaining: description: Requests left in the current window. schema: type: integer x-ratelimit-reset: description: Unix seconds when the window resets. schema: type: integer content: application/json: schema: type: object properties: object: type: string enum: - list data: type: array items: $ref: '#/components/schemas/Voice' has_more: type: boolean required: - object - data - has_more example: object: list data: - object: voice id: 9BWtsMINqrJLrRacOk9x name: Aria category: premade description: Warm, conversational female narrator has_more: false '400': description: Invalid request. `param` names the offending field. content: application/json: schema: $ref: '#/components/schemas/Error' example: error: type: invalid_request_error code: invalid_parameter message: '`scope` must be "workspace" or "library".' param: scope request_id: req_8fQ2mRxK1pLd '401': description: Missing, malformed, revoked or expired key. content: application/json: schema: $ref: '#/components/schemas/Error' example: error: type: authentication_error code: invalid_api_key message: Missing or invalid API key. request_id: req_8fQ2mRxK1pLd components: schemas: Voice: type: object properties: object: type: string enum: - voice id: type: string description: Pass this as a `voice` parameter's value. name: type: string category: type: string description: type: string labels: type: object additionalProperties: type: string preview_url: type: string format: uri required: - object - id - name Error: type: object description: >- Every failure has this shape. `param` names the offending field when there is one. properties: error: type: object properties: type: type: string enum: - invalid_request_error - authentication_error - permission_error - not_found_error - rate_limit_error - insufficient_credits_error - api_error code: type: string message: type: string param: type: string required: - type - code - message request_id: type: string required_credits: type: number description: 402 only. credit_balance: type: number description: 402 only. required: - error - request_id securitySchemes: bearerAuth: type: http scheme: bearer description: >- Your organization's API key, from Settings → API. `Authorization: Bearer crl_sk_live_…` apiKeyHeader: type: apiKey in: header name: X-API-Key description: Alternative to the Authorization header, for tooling that prefers it. ```` ## Related topics - [MCP server](/mcp-server.md) - [List AI creators](/api-reference/creators/list-ai-creators.md) - [List tools and models](/api-reference/catalog/list-tools-and-models.md) - [CLI](/cli.md) - [Creatorline API](/index.md)