Feces Health Analysis

Upload a photo of your pet's feces to analyze potential health indicators and generate a detailed health report.

POST/api/v1/feces-analysis

Image5 Credits per call

Field	Type	Required	Description
`image`	`string`	Yes	Base64-encoded image data (JPG/PNG/WEBP, max 3MB)
`animalType`	`string`	No	Animal type for analysis (e.g. dog, cat, rabbit, hamster)
`language`	`string`	No	Response language code (zh, en)

API Playground

Animal Type

Language

Request Example

bash

curl -X POST https://poomi.cn/api/v1/feces-analysis \
  -H "Authorization: Bearer pk_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "image": "base64_encoded_data",
    "animalType": "dog",
    "language": "en"
  }'

Response Fields

Field	Type	Required	Description
`health_score`	`integer`	Yes	Overall digestive health score from 1 (most concerning) to 10 (healthiest)
`health_score_max`	`integer`	Yes	Maximum possible digestive health score
`severity`	`string`	Yes	Overall severity of the visible stool findings
`color`	`string`	Yes	Observed stool color in plain language
`consistency`	`string`	Yes	Observed stool consistency or texture
`summary`	`string`	Yes	A concise 2 to 4 sentence summary covering the key visible observations, the overall interpretation, and any important limitation
`home_care`	`array<string>`	Yes	Practical at-home care or monitoring steps. Use an empty array when none are needed.
`vet_advice`	`array<string>`	Yes	When veterinary follow-up is appropriate based on the visible findings. Use an empty array when none are needed.

Response Schema

json-schema

{
  "type": "object",
  "properties": {
    "health_score": {
      "type": "integer",
      "description": "Overall digestive health score from 1 (most concerning) to 10 (healthiest)",
      "minimum": 1,
      "maximum": 10
    },
    "health_score_max": {
      "type": "integer",
      "description": "Maximum possible digestive health score",
      "const": 10
    },
    "severity": {
      "type": "string",
      "description": "Overall severity of the visible stool findings",
      "enum": [
        "normal",
        "mild",
        "moderate",
        "severe",
        "inconclusive"
      ]
    },
    "color": {
      "type": "string",
      "description": "Observed stool color in plain language"
    },
    "consistency": {
      "type": "string",
      "description": "Observed stool consistency or texture"
    },
    "summary": {
      "type": "string",
      "description": "A concise 2 to 4 sentence summary covering the key visible observations, the overall interpretation, and any important limitation"
    },
    "home_care": {
      "type": "array",
      "description": "Practical at-home care or monitoring steps. Use an empty array when none are needed.",
      "items": {
        "type": "string"
      }
    },
    "vet_advice": {
      "type": "array",
      "description": "When veterinary follow-up is appropriate based on the visible findings. Use an empty array when none are needed.",
      "items": {
        "type": "string"
      }
    }
  },
  "required": [
    "health_score",
    "health_score_max",
    "severity",
    "color",
    "consistency",
    "summary",
    "home_care",
    "vet_advice"
  ],
  "additionalProperties": false
}

Response Example

json200 OK

{
  "success": true,
  "request_id": "req_xxxxxxxx",
  "data": {
    "health_score": 9,
    "health_score_max": 10,
    "severity": "normal",
    "color": "medium brown",
    "consistency": "well-formed and log-shaped",
    "summary": "The visible stool appears within normal limits in this image. It looks well formed, with a typical medium-brown color and no obvious mucus, blood, or foreign material. Image-only review cannot assess odor, frequency, or microscopic abnormalities.",
    "home_care": [],
    "vet_advice": []
  }
}