naftiko: 1.0.0-alpha2
info:
  label: Mubert Music API — Streaming
  description: 'Mubert Music API — Streaming. 4 operations: get-link, restart, set-intensity, set-loop-state. Self-contained Naftiko capability for live generative streaming.'
  tags:
    - Mubert
    - Streaming
    - Generative
  created: '2026-05-25'
  modified: '2026-05-25'
binds:
  - namespace: env
    keys:
      MUBERT_CUSTOMER_ID: MUBERT_CUSTOMER_ID
      MUBERT_ACCESS_TOKEN: MUBERT_ACCESS_TOKEN
capability:
  consumes:
    - type: http
      namespace: streaming-streaming
      baseUri: https://music-api.mubert.com
      description: Mubert live streaming business capability.
      resources:
        - name: streamingGetLink
          path: /api/v3/public/streaming/get-link
          operations:
            - name: getStreamingLink
              method: GET
              description: Generate a streaming URL for continuous generative playback (HTTP or WebRTC).
              outputRawFormat: json
              outputParameters:
                - name: result
                  type: object
                  value: $.
              inputParameters:
                - name: playlist_index
                  in: query
                  type: string
                - name: bitrate
                  in: query
                  type: integer
                - name: intensity
                  in: query
                  type: string
                - name: type
                  in: query
                  type: string
        - name: streamingRestart
          path: /api/v3/public/streaming/restart
          operations:
            - name: restartStream
              method: POST
              description: Restart the current stream from a fresh transition point.
              inputParameters:
                - name: body
                  in: body
                  type: object
        - name: streamingSetIntensity
          path: /api/v3/public/streaming/set-intensity
          operations:
            - name: setStreamIntensity
              method: POST
              description: Change the live stream intensity (low / medium / high).
              inputParameters:
                - name: body
                  in: body
                  type: object
        - name: streamingSetLoopState
          path: /api/v3/public/streaming/set-loop-state
          operations:
            - name: setStreamLoopState
              method: POST
              description: Toggle loop mode on the live stream.
              inputParameters:
                - name: body
                  in: body
                  type: object
      authentication:
        type: apikey
        key: customer-id
        value: '{{env.MUBERT_CUSTOMER_ID}}'
        placement: header
  exposes:
    - type: rest
      namespace: streaming-streaming-rest
      port: 8080
      description: REST adapter for Mubert streaming.
      resources:
        - path: /v1/streaming
          name: streaming
          description: REST surface for the Mubert live streaming controller.
          operations:
            - method: GET
              name: getStreamingLink
              call: streaming-streaming.getStreamingLink
            - method: POST
              name: restart
              call: streaming-streaming.restartStream
            - method: POST
              name: setIntensity
              call: streaming-streaming.setStreamIntensity
            - method: POST
              name: setLoopState
              call: streaming-streaming.setStreamLoopState