List Catalog Providers

{
  "data": [
    {
      "provider": "google-cloud-tts",
      "display_name": "Google Cloud Text-to-Speech",
      "kind": "tts",
      "model_count": 12,
      "links": {
        "models": {
          "href": "/api/v1/providers/google-cloud-tts/models",
          "method": "GET"
        }
      }
    },
    {
      "provider": "aws-polly",
      "display_name": "Amazon Polly",
      "kind": "tts",
      "model_count": 8,
      "links": {
        "models": {
          "href": "/api/v1/providers/aws-polly/models",
          "method": "GET"
        }
      }
    },
    {
      "provider": "microsoft-azure-tts",
      "display_name": "Microsoft Azure Text-to-Speech",
      "kind": "tts",
      "model_count": 10,
      "links": {
        "models": {
          "href": "/api/v1/providers/microsoft-azure-tts/models",
          "method": "GET"
        }
      }
    }
  ],
  "meta": {
    "request_id": "a1b2c3d4-e5f6-7890-abcd-1234567890ef",
    "timestamp": "2024-01-15T09:30:00Z"
  },
  "pagination": {
    "limit": 3,
    "next": "/api/v1/providers?page=2&limit=3",
    "prev": null
  }
}

List all available speech synthesis providers in the catalog.

Returns the full set of processing providers — each with its display name, number of available models, and a HATEOAS models link to GET /providers/{provider}/models. The response contains only customer-facing metadata; cost, credentials, and base URLs are never included.

This endpoint is the starting point for building a provider/model/voice selection flow. The typical traversal is: list providers → follow models link → follow voices link for the chosen model. Requires X-Workspace-Id and the catalog:read scope.

List all available speech synthesis providers in the catalog. Returns the full set of processing providers — each with its display name, number of available models, and a HATEOAS `models` link to `GET /providers/{provider}/models`. The response contains only customer-facing metadata; cost, credentials, and base URLs are never included. This endpoint is the starting point for building a provider/model/voice selection flow. The typical traversal is: list providers → follow `models` link → follow `voices` link for the chosen model. Requires `X-Workspace-Id` and the `catalog:read` scope.

Authentication

AuthorizationBearer

Clerk JWT token

AuthorizationBearer

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

Response

Successful Response

datalist of objects

metaobject

paginationobject

Errors

422

Unprocessable Entity Error

$	curl https://api.onepin.ai/api/v1/providers \
>	-H "Authorization: Bearer <token>" \
>	-H "Content-Type: application/json"

Authentication

Headers

Response

Errors