Microsoft Azure Speech Services API v3.1 — Custom Speech Models:

naftiko: 1.0.0-alpha2
info:
  label: 'Microsoft Azure Speech Services API v3.1 — Custom Speech Models:'
  description: 'Microsoft Azure Speech Services API v3.1 — Custom Speech Models:. 13 operations. Lead operation: Microsoft
    Azure Gets The List Of Custom Models For The Authenticated Subscription. Self-contained Naftiko capability covering one
    Microsoft Azure business surface.'
  tags:
  - Microsoft Azure
  - 'Custom Speech Models:'
  created: '2026-05-19'
  modified: '2026-05-19'
binds:
- namespace: env
  keys:
    MICROSOFT_AZURE_API_KEY: MICROSOFT_AZURE_API_KEY
capability:
  consumes:
  - type: http
    namespace: speech-services-api-v31-custom-speech-models
    baseUri: ''
    description: 'Microsoft Azure Speech Services API v3.1 — Custom Speech Models: business capability. Self-contained, no
      shared references.'
    resources:
    - name: models
      path: /models
      operations:
      - name: microsoftazuremodelslistcustommodels
        method: GET
        description: Microsoft Azure Gets The List Of Custom Models For The Authenticated Subscription
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: filter
          in: query
          type: string
          description: "A filtering expression for selecting a subset of the available models.\r"
      - name: microsoftazuremodelscreate
        method: POST
        description: Microsoft Azure Creates A New Model
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: model
          in: body
          type: string
          description: The details of the new model.
          required: true
    - name: models-base
      path: /models/base
      operations:
      - name: microsoftazuremodelslistbasemodels
        method: GET
        description: Microsoft Azure Gets The List Of Base Models For The Authenticated Subscription
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: filter
          in: query
          type: string
          description: "A filtering expression for selecting a subset of the available base models.\r"
    - name: models-base-id
      path: /models/base/{id}
      operations:
      - name: microsoftazuremodelsgetbasemodel
        method: GET
        description: Microsoft Azure Gets The Base Model Identified By The Given Id
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          description: The identifier of the base model.
          required: true
    - name: models-base-id-manifest
      path: /models/base/{id}/manifest
      operations:
      - name: microsoftazuremodelsgetbasemodelmanifest
        method: GET
        description: Microsoft Azure Returns An Manifest For This Base Model Which Can Be Used In An On Premise Container
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          description: The ID of the model to generate a manifest for.
          required: true
    - name: models-locales
      path: /models/locales
      operations:
      - name: microsoftazuremodelslistsupportedlocales
        method: GET
        description: Microsoft Azure Gets A List Of Supported Locales For Model Adaptation
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: models-id
      path: /models/{id}
      operations:
      - name: microsoftazuremodelsgetcustommodel
        method: GET
        description: Microsoft Azure Gets The Model Identified By The Given Id
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          description: The identifier of the model.
          required: true
      - name: microsoftazuremodelsupdate
        method: PATCH
        description: Microsoft Azure Updates The Metadata Of The Model Identified By The Given Id
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          description: The identifier of the model.
          required: true
        - name: modelUpdate
          in: body
          type: string
          description: The updated values for the model.
          required: true
      - name: microsoftazuremodelsdelete
        method: DELETE
        description: Microsoft Azure Deletes The Model Identified By The Given Id
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          description: The identifier of the model.
          required: true
    - name: models-id-files
      path: /models/{id}/files
      operations:
      - name: microsoftazuremodelslistfiles
        method: GET
        description: Microsoft Azure Gets The Files Of The Model Identified By The Given Id
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          description: The identifier of the model.
          required: true
        - name: filter
          in: query
          type: string
          description: "A filtering expression for selecting a subset of the available files.\r"
    - name: models-id-files-fileId
      path: /models/{id}/files/{fileId}
      operations:
      - name: microsoftazuremodelsgetfile
        method: GET
        description: Microsoft Azure Gets One Specific File Identified With Fileid From A Model Identified With Id
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          description: The identifier of the model.
          required: true
        - name: fileId
          in: path
          type: string
          description: The identifier of the file.
          required: true
    - name: models-id-manifest
      path: /models/{id}/manifest
      operations:
      - name: microsoftazuremodelsgetcustommodelmanifest
        method: GET
        description: Microsoft Azure Returns An Manifest For This Model Which Can Be Used In An On Premise Container
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          description: The ID of the model to generate a manifest for.
          required: true
    - name: models-id}:copyto
      path: /models/{id}:copyto
      operations:
      - name: microsoftazuremodelscopyto
        method: POST
        description: Microsoft Azure Copies A Model From One Subscription To Another
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: id
          in: path
          type: string
          description: The identifier of the model that will be copied.
          required: true
        - name: modelCopy
          in: body
          type: string
          description: The body contains the subscription key of the target subscription.
          required: true
  exposes:
  - type: rest
    namespace: speech-services-api-v31-custom-speech-models-rest
    port: 8080
    description: REST adapter for Microsoft Azure Speech Services API v3.1 — Custom Speech Models:. One Spectral-compliant
      resource per consumed operation, prefixed with /v1.
    resources:
    - path: /v1/models
      name: models
      description: REST surface for models.
      operations:
      - method: GET
        name: microsoftazuremodelslistcustommodels
        description: Microsoft Azure Gets The List Of Custom Models For The Authenticated Subscription
        call: speech-services-api-v31-custom-speech-models.microsoftazuremodelslistcustommodels
        with:
          filter: rest.filter
        outputParameters:
        - type: object
          mapping: $.
      - method: POST
        name: microsoftazuremodelscreate
        description: Microsoft Azure Creates A New Model
        call: speech-services-api-v31-custom-speech-models.microsoftazuremodelscreate
        with:
          model: rest.model
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/models/base
      name: models-base
      description: REST surface for models-base.
      operations:
      - method: GET
        name: microsoftazuremodelslistbasemodels
        description: Microsoft Azure Gets The List Of Base Models For The Authenticated Subscription
        call: speech-services-api-v31-custom-speech-models.microsoftazuremodelslistbasemodels
        with:
          filter: rest.filter
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/models/base/{id}
      name: models-base-id
      description: REST surface for models-base-id.
      operations:
      - method: GET
        name: microsoftazuremodelsgetbasemodel
        description: Microsoft Azure Gets The Base Model Identified By The Given Id
        call: speech-services-api-v31-custom-speech-models.microsoftazuremodelsgetbasemodel
        with:
          id: rest.id
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/models/base/{id}/manifest
      name: models-base-id-manifest
      description: REST surface for models-base-id-manifest.
      operations:
      - method: GET
        name: microsoftazuremodelsgetbasemodelmanifest
        description: Microsoft Azure Returns An Manifest For This Base Model Which Can Be Used In An On Premise Container
        call: speech-services-api-v31-custom-speech-models.microsoftazuremodelsgetbasemodelmanifest
        with:
          id: rest.id
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/models/locales
      name: models-locales
      description: REST surface for models-locales.
      operations:
      - method: GET
        name: microsoftazuremodelslistsupportedlocales
        description: Microsoft Azure Gets A List Of Supported Locales For Model Adaptation
        call: speech-services-api-v31-custom-speech-models.microsoftazuremodelslistsupportedlocales
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/models/{id}
      name: models-id
      description: REST surface for models-id.
      operations:
      - method: GET
        name: microsoftazuremodelsgetcustommodel
        description: Microsoft Azure Gets The Model Identified By The Given Id
        call: speech-services-api-v31-custom-speech-models.microsoftazuremodelsgetcustommodel
        with:
          id: rest.id
        outputParameters:
        - type: object
          mapping: $.
      - method: PATCH
        name: microsoftazuremodelsupdate
        description: Microsoft Azure Updates The Metadata Of The Model Identified By The Given Id
        call: speech-services-api-v31-custom-speech-models.microsoftazuremodelsupdate
        with:
          id: rest.id
          modelUpdate: rest.modelUpdate
        outputParameters:
        - type: object
          mapping: $.
      - method: DELETE
        name: microsoftazuremodelsdelete
        description: Microsoft Azure Deletes The Model Identified By The Given Id
        call: speech-services-api-v31-custom-speech-models.microsoftazuremodelsdelete
        with:
          id: rest.id
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/models/{id}/files
      name: models-id-files
      description: REST surface for models-id-files.
      operations:
      - method: GET
        name: microsoftazuremodelslistfiles
        description: Microsoft Azure Gets The Files Of The Model Identified By The Given Id
        call: speech-services-api-v31-custom-speech-models.microsoftazuremodelslistfiles
        with:
          id: rest.id
          filter: rest.filter
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/models/{id}/files/{fileid}
      name: models-id-files-fileid
      description: REST surface for models-id-files-fileId.
      operations:
      - method: GET
        name: microsoftazuremodelsgetfile
        description: Microsoft Azure Gets One Specific File Identified With Fileid From A Model Identified With Id
        call: speech-services-api-v31-custom-speech-models.microsoftazuremodelsgetfile
        with:
          id: rest.id
          fileId: rest.fileId
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/models/{id}/manifest
      name: models-id-manifest
      description: REST surface for models-id-manifest.
      operations:
      - method: GET
        name: microsoftazuremodelsgetcustommodelmanifest
        description: Microsoft Azure Returns An Manifest For This Model Which Can Be Used In An On Premise Container
        call: speech-services-api-v31-custom-speech-models.microsoftazuremodelsgetcustommodelmanifest
        with:
          id: rest.id
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/models/id-copyto
      name: models-id-copyto
      description: REST surface for models-id}:copyto.
      operations:
      - method: POST
        name: microsoftazuremodelscopyto
        description: Microsoft Azure Copies A Model From One Subscription To Another
        call: speech-services-api-v31-custom-speech-models.microsoftazuremodelscopyto
        with:
          id: rest.id
          modelCopy: rest.modelCopy
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: speech-services-api-v31-custom-speech-models-mcp
    port: 9090
    transport: http
    description: MCP adapter for Microsoft Azure Speech Services API v3.1 — Custom Speech Models:. One tool per consumed operation,
      routed inline through this capability's consumes block.
    tools:
    - name: microsoft-azure-gets-list-custom
      description: Microsoft Azure Gets The List Of Custom Models For The Authenticated Subscription
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: speech-services-api-v31-custom-speech-models.microsoftazuremodelslistcustommodels
      with:
        filter: tools.filter
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-azure-creates-new-model
      description: Microsoft Azure Creates A New Model
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: speech-services-api-v31-custom-speech-models.microsoftazuremodelscreate
      with:
        model: tools.model
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-azure-gets-list-base
      description: Microsoft Azure Gets The List Of Base Models For The Authenticated Subscription
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: speech-services-api-v31-custom-speech-models.microsoftazuremodelslistbasemodels
      with:
        filter: tools.filter
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-azure-gets-base-model
      description: Microsoft Azure Gets The Base Model Identified By The Given Id
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: speech-services-api-v31-custom-speech-models.microsoftazuremodelsgetbasemodel
      with:
        id: tools.id
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-azure-returns-manifest-this
      description: Microsoft Azure Returns An Manifest For This Base Model Which Can Be Used In An On Premise Container
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: speech-services-api-v31-custom-speech-models.microsoftazuremodelsgetbasemodelmanifest
      with:
        id: tools.id
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-azure-gets-list-supported
      description: Microsoft Azure Gets A List Of Supported Locales For Model Adaptation
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: speech-services-api-v31-custom-speech-models.microsoftazuremodelslistsupportedlocales
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-azure-gets-model-identified
      description: Microsoft Azure Gets The Model Identified By The Given Id
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: speech-services-api-v31-custom-speech-models.microsoftazuremodelsgetcustommodel
      with:
        id: tools.id
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-azure-updates-metadata-model
      description: Microsoft Azure Updates The Metadata Of The Model Identified By The Given Id
      hints:
        readOnly: false
        destructive: false
        idempotent: true
      call: speech-services-api-v31-custom-speech-models.microsoftazuremodelsupdate
      with:
        id: tools.id
        modelUpdate: tools.modelUpdate
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-azure-deletes-model-identified
      description: Microsoft Azure Deletes The Model Identified By The Given Id
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: speech-services-api-v31-custom-speech-models.microsoftazuremodelsdelete
      with:
        id: tools.id
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-azure-gets-files-model
      description: Microsoft Azure Gets The Files Of The Model Identified By The Given Id
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: speech-services-api-v31-custom-speech-models.microsoftazuremodelslistfiles
      with:
        id: tools.id
        filter: tools.filter
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-azure-gets-one-specific
      description: Microsoft Azure Gets One Specific File Identified With Fileid From A Model Identified With Id
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: speech-services-api-v31-custom-speech-models.microsoftazuremodelsgetfile
      with:
        id: tools.id
        fileId: tools.fileId
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-azure-returns-manifest-this-2
      description: Microsoft Azure Returns An Manifest For This Model Which Can Be Used In An On Premise Container
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: speech-services-api-v31-custom-speech-models.microsoftazuremodelsgetcustommodelmanifest
      with:
        id: tools.id
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-azure-copies-model-one
      description: Microsoft Azure Copies A Model From One Subscription To Another
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: speech-services-api-v31-custom-speech-models.microsoftazuremodelscopyto
      with:
        id: tools.id
        modelCopy: tools.modelCopy
      outputParameters:
      - type: object
        mapping: $.