List Catalog Provider Model Voices

{
  "data": [
    {
      "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "provider_voice_id": "voice_12345",
      "name": "Emma",
      "gender": "female",
      "age": "young",
      "accent": "british",
      "supported_languages": [
        "en-GB",
        "en-US"
      ],
      "preview_url": "https://cdn.onepin.ai/previews/voice_12345_sample.mp3?signature=abc123&expires=1712345678",
      "emotion_options": [
        "happy",
        "sad",
        "neutral"
      ]
    },
    {
      "id": "7b9c9f1a-2d4e-4f3a-9a1b-8d2e4f7c9a12",
      "provider_voice_id": "voice_67890",
      "name": "Liam",
      "gender": "male",
      "age": "middle_aged",
      "accent": "american",
      "supported_languages": [
        "en-US"
      ],
      "preview_url": "https://cdn.onepin.ai/previews/voice_67890_sample.mp3?signature=def456&expires=1712345678",
      "emotion_options": [
        "angry",
        "calm"
      ]
    }
  ],
  "meta": {
    "request_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "timestamp": "2024-01-15T09:30:00Z"
  },
  "pagination": {
    "limit": 2,
    "total": 10,
    "next": "https://api.onepin.ai/api/v1/providers/acme/models/tts-advanced/voices?offset=2&limit=2",
    "prev": null
  }
}

List platform voices available for a specific provider and model.

Returns a paginated list of voices from the platform catalog (system workspace) that declare support for the given model. A voice can appear under multiple models when its supported_models list includes more than one entry; voices with no supported models are excluded from all model listings.

Each voice includes gender, age, accent, supported locales, and a short-lived presigned preview_url for the audio sample — do not cache these URLs across sessions. The response pagination.total field reflects the total match count for the provider/model pair.

For the workspace voice picker (which merges platform and workspace-scoped voices and supports favorite/similarity filtering), use GET /voices with ?provider= and ?model= query parameters instead.

Returns 404 if the provider or model is not recognized.

List platform voices available for a specific provider and model. Returns a paginated list of voices from the platform catalog (system workspace) that declare support for the given `model`. A voice can appear under multiple models when its `supported_models` list includes more than one entry; voices with no supported models are excluded from all model listings. Each voice includes gender, age, accent, supported locales, and a short-lived presigned `preview_url` for the audio sample — do not cache these URLs across sessions. The response `pagination.total` field reflects the total match count for the provider/model pair. For the workspace voice picker (which merges platform and workspace-scoped voices and supports favorite/similarity filtering), use `GET /voices` with `?provider=` and `?model=` query parameters instead. Returns 404 if the provider or model is not recognized.

Authentication

AuthorizationBearer

Clerk JWT token

AuthorizationBearer

Onepin live API key (op_live_...). Test and public keys are reserved in Phase 1.

Path parameters

providerstringRequired

modelstringRequired

Query parameters

offsetintegerOptional>=0Defaults to 0

Zero-based pagination offset.

limitintegerOptional1-100Defaults to 20

Page size (max 100).

Response

Successful Response

datalist of objects

metaobject

paginationobject

PaginationMeta variant for endpoints that compute an unpaginated total.

Errors

404

Not Found Error

422

Unprocessable Entity Error