粪便分析 - Poomi Docs

上传宠物粪便照片，分析潜在健康指标并生成详细健康报告。

POST/api/v1/feces-analysis

图片5 每次调用额度

字段	类型	必填	描述
`image`	`string`	是	Base64 编码的图片数据（JPG/PNG/WEBP，最大 3MB）
`animalType`	`string`	否	分析的动物类型（如：dog、cat、rabbit、hamster）
`language`	`string`	否	响应语言代码（zh, en）

API Playground

动物类型

语言

请求示例

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": "zh"
  }'

响应字段

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

响应 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
}

响应示例

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": []
  }
}