Get Catalog Provider Model

{
  "data": {
    "model": "neural-tts-v3",
    "display_name": "Neural TTS Model v3",
    "voice_count": 12,
    "content_type": "audio/wav",
    "config_schema": {
      "bit_depth": 16,
      "channels": 1,
      "language": "en-US",
      "sample_rate": 24000
    },
    "controls": {
      "pitch": {
        "default": 0,
        "description": "Adjusts the pitch of the voice",
        "max": 5,
        "min": -5,
        "type": "range"
      },
      "speed": {
        "default": 1,
        "description": "Controls the speaking speed",
        "max": 2,
        "min": 0.5,
        "type": "range"
      },
      "volume": {
        "default": 75,
        "description": "Sets the output volume percentage",
        "max": 100,
        "min": 0,
        "type": "range"
      }
    },
    "links": {
      "voices": {
        "href": "https://api.onepin.ai/api/v1/providers/neural/models/neural-tts-v3/voices",
        "method": "GET"
      }
    }
  },
  "meta": {
    "request_id": "a1b2c3d4-e5f6-7890-abcd-1234567890ef",
    "timestamp": "2024-01-15T09:30:00Z"
  }
}

Get a single model for a given provider.

Returns the same shape as an item in GET /providers/{provider}/models, including controls (canonical parameter map), config_schema (for back-compat), live voice_count, and a HATEOAS voices link. Returns 404 if the provider or model identifier 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

Response

Successful Response

dataobject

Catalog model entry — lean, customer-safe.

config_schema is the per-model NATIVE TTS config JSON-schema. POD-670: config_schema is now DEPRECATED as the FE slider source — read controls instead (the provider-agnostic canonical supported-set). config_schema is kept populated for back-compat until the FE migrates (POD-718). voice_count is the number of active platform voices catalogued under this (provider, model).

metaobject

Errors

404

Not Found Error

422

Unprocessable Entity Error

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

Authentication

Path parameters

Headers

Response

Errors