Microsoft Azure Azure OpenAI Service API — Deployments

naftiko: 1.0.0-alpha2
info:
  label: Microsoft Azure Azure OpenAI Service API — Deployments
  description: 'Microsoft Azure Azure OpenAI Service API — Deployments. 7 operations. Lead operation: Microsoft Azure Generates
    Audio From The Input Text. Self-contained Naftiko capability covering one Microsoft Azure business surface.'
  tags:
  - Microsoft Azure
  - Deployments
  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: azure-openai-service-deployments
    baseUri: https://{endpoint}/openai
    description: Microsoft Azure Azure OpenAI Service API — Deployments business capability. Self-contained, no shared references.
    resources:
    - name: deployments-deployment-id-audio-speech
      path: /deployments/{deployment-id}/audio/speech
      operations:
      - name: microsoftazurespeechcreate
        method: POST
        description: Microsoft Azure Generates Audio From The Input Text
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: deployment-id
          in: path
          type: string
          required: true
        - name: api-version
          in: query
          type: string
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: deployments-deployment-id-audio-transcriptions
      path: /deployments/{deployment-id}/audio/transcriptions
      operations:
      - name: microsoftazuretranscriptionscreate
        method: POST
        description: Microsoft Azure Transcribes Audio Into The Input Language
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: deployment-id
          in: path
          type: string
          required: true
        - name: api-version
          in: query
          type: string
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: deployments-deployment-id-audio-translations
      path: /deployments/{deployment-id}/audio/translations
      operations:
      - name: microsoftazuretranslationscreate
        method: POST
        description: Microsoft Azure Transcribes And Translates Input Audio Into English Text
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: deployment-id
          in: path
          type: string
          required: true
        - name: api-version
          in: query
          type: string
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: deployments-deployment-id-chat-completions
      path: /deployments/{deployment-id}/chat/completions
      operations:
      - name: microsoftazurechatcompletionscreate
        method: POST
        description: Microsoft Azure Creates A Completion For The Chat Message
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: deployment-id
          in: path
          type: string
          required: true
        - name: api-version
          in: query
          type: string
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: deployments-deployment-id-completions
      path: /deployments/{deployment-id}/completions
      operations:
      - name: microsoftazurecompletionscreate
        method: POST
        description: Microsoft Azure Creates A Completion For The Provided Prompt, Parameters And Chosen Model
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: deployment-id
          in: path
          type: string
          required: true
        - name: api-version
          in: query
          type: string
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: deployments-deployment-id-embeddings
      path: /deployments/{deployment-id}/embeddings
      operations:
      - name: microsoftazureembeddingscreate
        method: POST
        description: Microsoft Azure Get A Vector Representation Of A Given Input That Can Be Easily Consumed By Machine Learning
          Models And Algorithms
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: deployment-id
          in: path
          type: string
          description: The deployment id of the model which was deployed.
          required: true
        - name: api-version
          in: query
          type: string
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: deployments-deployment-id-images-generations
      path: /deployments/{deployment-id}/images/generations
      operations:
      - name: microsoftazureimagegenerationscreate
        method: POST
        description: Microsoft Azure Generates A Batch Of Images From A Text Caption On A Given Dalle Model Deployment
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: deployment-id
          in: path
          type: string
          required: true
        - name: api-version
          in: query
          type: string
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    authentication:
      type: bearer
      token: '{{env.MICROSOFT_AZURE_API_KEY}}'
  exposes:
  - type: rest
    namespace: azure-openai-service-deployments-rest
    port: 8080
    description: REST adapter for Microsoft Azure Azure OpenAI Service API — Deployments. One Spectral-compliant resource
      per consumed operation, prefixed with /v1.
    resources:
    - path: /v1/deployments/{deployment-id}/audio/speech
      name: deployments-deployment-id-audio-speech
      description: REST surface for deployments-deployment-id-audio-speech.
      operations:
      - method: POST
        name: microsoftazurespeechcreate
        description: Microsoft Azure Generates Audio From The Input Text
        call: azure-openai-service-deployments.microsoftazurespeechcreate
        with:
          deployment-id: rest.deployment-id
          api-version: rest.api-version
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/deployments/{deployment-id}/audio/transcriptions
      name: deployments-deployment-id-audio-transcriptions
      description: REST surface for deployments-deployment-id-audio-transcriptions.
      operations:
      - method: POST
        name: microsoftazuretranscriptionscreate
        description: Microsoft Azure Transcribes Audio Into The Input Language
        call: azure-openai-service-deployments.microsoftazuretranscriptionscreate
        with:
          deployment-id: rest.deployment-id
          api-version: rest.api-version
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/deployments/{deployment-id}/audio/translations
      name: deployments-deployment-id-audio-translations
      description: REST surface for deployments-deployment-id-audio-translations.
      operations:
      - method: POST
        name: microsoftazuretranslationscreate
        description: Microsoft Azure Transcribes And Translates Input Audio Into English Text
        call: azure-openai-service-deployments.microsoftazuretranslationscreate
        with:
          deployment-id: rest.deployment-id
          api-version: rest.api-version
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/deployments/{deployment-id}/chat/completions
      name: deployments-deployment-id-chat-completions
      description: REST surface for deployments-deployment-id-chat-completions.
      operations:
      - method: POST
        name: microsoftazurechatcompletionscreate
        description: Microsoft Azure Creates A Completion For The Chat Message
        call: azure-openai-service-deployments.microsoftazurechatcompletionscreate
        with:
          deployment-id: rest.deployment-id
          api-version: rest.api-version
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/deployments/{deployment-id}/completions
      name: deployments-deployment-id-completions
      description: REST surface for deployments-deployment-id-completions.
      operations:
      - method: POST
        name: microsoftazurecompletionscreate
        description: Microsoft Azure Creates A Completion For The Provided Prompt, Parameters And Chosen Model
        call: azure-openai-service-deployments.microsoftazurecompletionscreate
        with:
          deployment-id: rest.deployment-id
          api-version: rest.api-version
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/deployments/{deployment-id}/embeddings
      name: deployments-deployment-id-embeddings
      description: REST surface for deployments-deployment-id-embeddings.
      operations:
      - method: POST
        name: microsoftazureembeddingscreate
        description: Microsoft Azure Get A Vector Representation Of A Given Input That Can Be Easily Consumed By Machine Learning
          Models And Algorithms
        call: azure-openai-service-deployments.microsoftazureembeddingscreate
        with:
          deployment-id: rest.deployment-id
          api-version: rest.api-version
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/deployments/{deployment-id}/images/generations
      name: deployments-deployment-id-images-generations
      description: REST surface for deployments-deployment-id-images-generations.
      operations:
      - method: POST
        name: microsoftazureimagegenerationscreate
        description: Microsoft Azure Generates A Batch Of Images From A Text Caption On A Given Dalle Model Deployment
        call: azure-openai-service-deployments.microsoftazureimagegenerationscreate
        with:
          deployment-id: rest.deployment-id
          api-version: rest.api-version
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: azure-openai-service-deployments-mcp
    port: 9090
    transport: http
    description: MCP adapter for Microsoft Azure Azure OpenAI Service API — Deployments. One tool per consumed operation,
      routed inline through this capability's consumes block.
    tools:
    - name: microsoft-azure-generates-audio-input
      description: Microsoft Azure Generates Audio From The Input Text
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: azure-openai-service-deployments.microsoftazurespeechcreate
      with:
        deployment-id: tools.deployment-id
        api-version: tools.api-version
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-azure-transcribes-audio-input
      description: Microsoft Azure Transcribes Audio Into The Input Language
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: azure-openai-service-deployments.microsoftazuretranscriptionscreate
      with:
        deployment-id: tools.deployment-id
        api-version: tools.api-version
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-azure-transcribes-and-translates
      description: Microsoft Azure Transcribes And Translates Input Audio Into English Text
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: azure-openai-service-deployments.microsoftazuretranslationscreate
      with:
        deployment-id: tools.deployment-id
        api-version: tools.api-version
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-azure-creates-completion-chat
      description: Microsoft Azure Creates A Completion For The Chat Message
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: azure-openai-service-deployments.microsoftazurechatcompletionscreate
      with:
        deployment-id: tools.deployment-id
        api-version: tools.api-version
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-azure-creates-completion-provided
      description: Microsoft Azure Creates A Completion For The Provided Prompt, Parameters And Chosen Model
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: azure-openai-service-deployments.microsoftazurecompletionscreate
      with:
        deployment-id: tools.deployment-id
        api-version: tools.api-version
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-azure-get-vector-representation
      description: Microsoft Azure Get A Vector Representation Of A Given Input That Can Be Easily Consumed By Machine Learning
        Models And Algorithms
      hints:
        readOnly: true
        destructive: false
        idempotent: false
      call: azure-openai-service-deployments.microsoftazureembeddingscreate
      with:
        deployment-id: tools.deployment-id
        api-version: tools.api-version
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-azure-generates-batch-images
      description: Microsoft Azure Generates A Batch Of Images From A Text Caption On A Given Dalle Model Deployment
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: azure-openai-service-deployments.microsoftazureimagegenerationscreate
      with:
        deployment-id: tools.deployment-id
        api-version: tools.api-version
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.