TensorFlow Serving REST API — Inference

naftiko: 1.0.0-alpha2
info:
  label: TensorFlow Serving REST API — Inference
  description: 'TensorFlow Serving REST API — Inference. 6 operations. Lead operation: Classify With Model Version. Self-contained
    Naftiko capability covering one Tensorflow business surface.'
  tags:
  - Tensorflow
  - Inference
  created: '2026-05-19'
  modified: '2026-05-19'
binds:
- namespace: env
  keys:
    TENSORFLOW_API_KEY: TENSORFLOW_API_KEY
capability:
  consumes:
  - type: http
    namespace: serving-inference
    baseUri: http://{host}:{port}
    description: TensorFlow Serving REST API — Inference business capability. Self-contained, no shared references.
    resources:
    - name: v1-models-model_name-versions-version}:classify
      path: /v1/models/{model_name}/versions/{version}:classify
      operations:
      - name: classifymodelversion
        method: POST
        description: Classify With Model Version
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: model_name
          in: path
          type: string
          description: The name of the model
          required: true
        - name: version
          in: path
          type: integer
          description: The specific version number of the model
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: v1-models-model_name-versions-version}:predict
      path: /v1/models/{model_name}/versions/{version}:predict
      operations:
      - name: predictmodelversion
        method: POST
        description: Predict With Model Version
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: model_name
          in: path
          type: string
          description: The name of the model
          required: true
        - name: version
          in: path
          type: integer
          description: The specific version number of the model
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: v1-models-model_name-versions-version}:regress
      path: /v1/models/{model_name}/versions/{version}:regress
      operations:
      - name: regressmodelversion
        method: POST
        description: Regress With Model Version
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: model_name
          in: path
          type: string
          description: The name of the model
          required: true
        - name: version
          in: path
          type: integer
          description: The specific version number of the model
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: v1-models-model_name}:classify
      path: /v1/models/{model_name}:classify
      operations:
      - name: classifymodel
        method: POST
        description: Classify With Model
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: model_name
          in: path
          type: string
          description: The name of the model
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: v1-models-model_name}:predict
      path: /v1/models/{model_name}:predict
      operations:
      - name: predictmodel
        method: POST
        description: Predict With Model
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: model_name
          in: path
          type: string
          description: The name of the model
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
    - name: v1-models-model_name}:regress
      path: /v1/models/{model_name}:regress
      operations:
      - name: regressmodel
        method: POST
        description: Regress With Model
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: model_name
          in: path
          type: string
          description: The name of the model
          required: true
        - name: body
          in: body
          type: object
          description: Request body (JSON).
          required: true
  exposes:
  - type: rest
    namespace: serving-inference-rest
    port: 8080
    description: REST adapter for TensorFlow Serving REST API — Inference. One Spectral-compliant resource per consumed operation,
      prefixed with /v1.
    resources:
    - path: /v1/v1/models/{model-name}/versions/version-classify
      name: v1-models-model-name-versions-version-classify
      description: REST surface for v1-models-model_name-versions-version}:classify.
      operations:
      - method: POST
        name: classifymodelversion
        description: Classify With Model Version
        call: serving-inference.classifymodelversion
        with:
          model_name: rest.model_name
          version: rest.version
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v1/models/{model-name}/versions/version-predict
      name: v1-models-model-name-versions-version-predict
      description: REST surface for v1-models-model_name-versions-version}:predict.
      operations:
      - method: POST
        name: predictmodelversion
        description: Predict With Model Version
        call: serving-inference.predictmodelversion
        with:
          model_name: rest.model_name
          version: rest.version
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v1/models/{model-name}/versions/version-regress
      name: v1-models-model-name-versions-version-regress
      description: REST surface for v1-models-model_name-versions-version}:regress.
      operations:
      - method: POST
        name: regressmodelversion
        description: Regress With Model Version
        call: serving-inference.regressmodelversion
        with:
          model_name: rest.model_name
          version: rest.version
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v1/models/model-name-classify
      name: v1-models-model-name-classify
      description: REST surface for v1-models-model_name}:classify.
      operations:
      - method: POST
        name: classifymodel
        description: Classify With Model
        call: serving-inference.classifymodel
        with:
          model_name: rest.model_name
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v1/models/model-name-predict
      name: v1-models-model-name-predict
      description: REST surface for v1-models-model_name}:predict.
      operations:
      - method: POST
        name: predictmodel
        description: Predict With Model
        call: serving-inference.predictmodel
        with:
          model_name: rest.model_name
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/v1/models/model-name-regress
      name: v1-models-model-name-regress
      description: REST surface for v1-models-model_name}:regress.
      operations:
      - method: POST
        name: regressmodel
        description: Regress With Model
        call: serving-inference.regressmodel
        with:
          model_name: rest.model_name
          body: rest.body
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: serving-inference-mcp
    port: 9090
    transport: http
    description: MCP adapter for TensorFlow Serving REST API — Inference. One tool per consumed operation, routed inline through
      this capability's consumes block.
    tools:
    - name: classify-model-version
      description: Classify With Model Version
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: serving-inference.classifymodelversion
      with:
        model_name: tools.model_name
        version: tools.version
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: predict-model-version
      description: Predict With Model Version
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: serving-inference.predictmodelversion
      with:
        model_name: tools.model_name
        version: tools.version
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: regress-model-version
      description: Regress With Model Version
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: serving-inference.regressmodelversion
      with:
        model_name: tools.model_name
        version: tools.version
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: classify-model
      description: Classify With Model
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: serving-inference.classifymodel
      with:
        model_name: tools.model_name
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: predict-model
      description: Predict With Model
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: serving-inference.predictmodel
      with:
        model_name: tools.model_name
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.
    - name: regress-model
      description: Regress With Model
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: serving-inference.regressmodel
      with:
        model_name: tools.model_name
        body: tools.body
      outputParameters:
      - type: object
        mapping: $.