insentek/fangwu-models repository overview

⁠insentek/fangwu-models

Container image for running the Fangwu soil model inference API.

⁠Quick Start

Pull the image:

docker pull insentek/fangwu-models:soil_general.2.10.1

Prepare a valid license.lic on the host, for example at ./license/license.lic.

Run the container with the license mounted to /code/license/license.lic:

docker run --rm \
  -p 28085:28085 \
  -v "$(pwd)/license/license.lic:/code/license/license.lic:ro" \
  insentek/fangwu-models:soil_general.2.10.1

After the container starts, the service is available at:

http://localhost:28085

If the mounted license is missing, expired, or invalid, the container prints Missing or Invalid License and exits during startup.

⁠Available Endpoints

• GET /metadata
• POST /predict

⁠Get Metadata

Use this endpoint to retrieve the current model information and the list of supported measurements.

curl -X GET "http://localhost:28085/metadata"

The response includes:

• model identifier
• model version
• supported measurements
• measurement types and units

⁠Predict

Use this endpoint to submit spectrum data and receive prediction results.

curl -X POST "http://localhost:28085/predict" \
  -H "Content-Type: application/json" \
  -d '{
    "spectrum": {
      "901.100343408": [0.491966, 0.487541, 0.481363],
      "905.1394512": [0.476025, 0.475065, 0.481621],
      "909.173904768": [0.484665, 0.482226, 0.482857],
      "913.203704112": [0.488137, 0.486383, 0.483963],
      "917.228849232": [0.489808, 0.483123, 0.481044]
    }
  }'

Successful responses return prediction values directly in JSON format. The response keys match the measurement identifiers declared by the metadata endpoint.

⁠Notes

• Requests and responses use application/json; charset=utf-8.
• POST /predict requires a JSON request body.
• Successful responses use HTTP 200.
• Non-200 responses return a standard error object with type, code, and message.