粪便分析 - Poomi Docs

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

POST/api/v1/feces-analysis

图片5 每次调用额度

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

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

响应字段

字段	类型	必填	描述
`color`	`string`	是	Observed stool color in plain language
`summary`	`string`	是	A detailed 4 to 6 sentence owner-facing summary that explains the key visible observations, the overall interpretation, any important limitation, and the main takeaway for the user
`severity`	`string`	是	Overall severity of the visible stool findings, written in the requested response language
`home_care`	`array<string>`	是	Practical at-home care or monitoring steps with enough context to be useful. Must contain at least 3 items, even when the findings look normal.
`vet_advice`	`array<string>`	是	Veterinary follow-up guidance with concrete triggers, urgency, or timeframes when supported by the visible findings. Use an empty array when no clinic follow-up is supported.
`consistency`	`string`	是	Observed stool consistency or texture
`health_score`	`integer`	是	Overall digestive health score from 1 (most concerning) to 10 (healthiest)
`health_score_max`	`integer`	是	Maximum possible digestive health score

响应 Schema

json-schema

{
  "type": "object",
  "required": [
    "health_score",
    "health_score_max",
    "severity",
    "color",
    "consistency",
    "summary",
    "home_care",
    "vet_advice"
  ],
  "properties": {
    "color": {
      "type": "string",
      "description": "Observed stool color in plain language"
    },
    "summary": {
      "type": "string",
      "description": "A detailed 4 to 6 sentence owner-facing summary that explains the key visible observations, the overall interpretation, any important limitation, and the main takeaway for the user"
    },
    "severity": {
      "type": "string",
      "description": "Overall severity of the visible stool findings, written in the requested response language"
    },
    "home_care": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "minItems": 3,
      "description": "Practical at-home care or monitoring steps with enough context to be useful. Must contain at least 3 items, even when the findings look normal."
    },
    "vet_advice": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Veterinary follow-up guidance with concrete triggers, urgency, or timeframes when supported by the visible findings. Use an empty array when no clinic follow-up is supported."
    },
    "consistency": {
      "type": "string",
      "description": "Observed stool consistency or texture"
    },
    "health_score": {
      "type": "integer",
      "maximum": 10,
      "minimum": 1,
      "description": "Overall digestive health score from 1 (most concerning) to 10 (healthiest)"
    },
    "health_score_max": {
      "type": "integer",
      "const": 10,
      "description": "Maximum possible digestive health score"
    }
  },
  "additionalProperties": false
}

响应示例

json200 OK

{
  "success": true,
  "request_id": "req_xxxxxxxx",
  "data": {
    "color": "medium brown",
    "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, parasites, or foreign material on the surface. This pattern is generally consistent with stable digestion when appetite, energy, and stool frequency are also normal. Image-only review cannot assess odor, frequency, straining, or microscopic abnormalities, so day-to-day context still matters.",
    "severity": "normal",
    "home_care": [
      "Keep the current diet steady and avoid sudden food changes",
      "Make sure fresh water is always available",
      "Watch stool color, frequency, and form over the next 24-48 hours for any changes"
    ],
    "vet_advice": [],
    "consistency": "well-formed and log-shaped",
    "health_score": 9,
    "health_score_max": 10
  }
}