List Catalog Provider Models

{
  "data": [
    {
      "model": "tts-pro-001",
      "display_name": "Pro Voice Model",
      "voice_count": 24,
      "content_type": "audio/wav",
      "config_schema": {
        "properties": {
          "speed": {
            "default": 1,
            "maximum": 2,
            "minimum": 0.5,
            "type": "number"
          },
          "stability": {
            "default": 0.75,
            "maximum": 1,
            "minimum": 0,
            "type": "number"
          }
        },
        "required": [
          "speed"
        ],
        "type": "object"
      },
      "controls": {
        "speed": {
          "default": 1,
          "description": "Adjusts the speaking speed of the voice",
          "max": 2,
          "min": 0.5
        },
        "stability": {
          "default": 0.75,
          "description": "Controls the voice stability and consistency",
          "max": 1,
          "min": 0
        }
      },
      "links": {
        "voices": {
          "href": "/api/v1/providers/tts-pro/voices?model=tts-pro-001",
          "method": "GET"
        }
      }
    },
    {
      "model": "basic-tts-2023",
      "display_name": "Basic TTS Model",
      "voice_count": 12,
      "content_type": "audio/mp3",
      "config_schema": {
        "properties": {
          "pitch": {
            "default": 0,
            "maximum": 10,
            "minimum": -10,
            "type": "number"
          }
        },
        "type": "object"
      },
      "controls": {
        "pitch": {
          "default": 0,
          "description": "Adjusts the pitch of the voice",
          "max": 10,
          "min": -10
        }
      },
      "links": {
        "voices": {
          "href": "/api/v1/providers/tts-pro/voices?model=basic-tts-2023",
          "method": "GET"
        }
      }
    }
  ],
  "meta": {
    "request_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "timestamp": "2024-01-15T09:30:00Z"
  },
  "pagination": {
    "limit": 20,
    "next": "/api/v1/providers/tts-pro/models?page=2",
    "prev": null
  }
}

List all models available for a given provider.

Returns each model’s display name, content type, live voice_count (the number of platform voices catalogued under that model), and a controls map describing the canonical provider-agnostic parameters supported by the model (e.g. speed, stability). Also includes config_schema for back-compat — new integrations should prefer controls as the authoritative parameter description. Each item includes a HATEOAS voices link to the paginated voice list for that model. Returns 404 if the provider is not recognized.

List all models available for a given provider. Returns each model's display name, content type, live `voice_count` (the number of platform voices catalogued under that model), and a `controls` map describing the canonical provider-agnostic parameters supported by the model (e.g. speed, stability). Also includes `config_schema` for back-compat — new integrations should prefer `controls` as the authoritative parameter description. Each item includes a HATEOAS `voices` link to the paginated voice list for that model. Returns 404 if the provider 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

Response

Successful Response

datalist of objects

metaobject

paginationobject

Errors

404

Not Found Error

422

Unprocessable Entity Error

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

Authentication

Path parameters

Headers

Response

Errors