Get Catalog Provider

GET

/api/v1/providers/:provider

Get a single speech synthesis provider by its canonical identifier.

Returns the same shape as an item in GET /providers — display name, model count, and a HATEOAS models link — but scoped to a single provider. Returns 404 if the provider identifier is not recognized. The canonical identifier is the lowercase slug returned in the provider field of the list response.

Get a single speech synthesis provider by its canonical identifier. Returns the same shape as an item in `GET /providers` — display name, model count, and a HATEOAS `models` link — but scoped to a single provider. Returns 404 if the provider identifier is not recognized. The canonical identifier is the lowercase slug returned in the `provider` field of the list response.

Authentication

AuthorizationBearer

Clerk JWT token

AuthorizationBearer

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

Path parameters

providerstringRequired

Response

Successful Response

dataobject

Catalog provider entry — lean, customer-safe.

Sourced from the in-memory ProviderRegistry (TTS / processing kind). Cost, credentials, base_url, and enabled flags are excluded by construction.

metaobject

Errors

404

Not Found Error

422

Unprocessable Entity Error

1	{
2	"data": {
3	"provider": "acme-tts",
4	"display_name": "Acme Text-to-Speech",
5	"kind": "tts",
6	"model_count": 12,
7	"links": {
8	"models": {
9	"href": "https://api.onepin.ai/api/v1/providers/acme-tts/models",
10	"method": "GET"
11	}
12	}
13	},
14	"meta": {
15	"request_id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
16	"timestamp": "2024-01-15T09:30:00Z"
17	}
18	}

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

Authentication

Path parameters

Headers

Response

Errors