耳道分析 - Poomi Docs

上传宠物耳朵照片，分析感染、耳螨、耳垢堆积等耳部状况。

POST/api/v1/ear-analysis

图片5 每次调用额度

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

API Playground

动物类型

语言

请求示例

bash

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

响应字段

字段	类型	必填	描述
`severity`	`string`	是	Overall severity of the visible ear findings
`condition`	`string`	是	Short owner-facing label for the visible ear condition
`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. MUST contain at least 2 items, even when the findings look normal — fall back to routine daily care or monitoring suggestions in that case.
`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": {
    "severity": {
      "type": "string",
      "description": "Overall severity of the visible ear findings",
      "enum": [
        "normal",
        "mild",
        "moderate",
        "severe",
        "inconclusive"
      ]
    },
    "condition": {
      "type": "string",
      "description": "Short owner-facing label for the visible ear condition"
    },
    "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. MUST contain at least 2 items, even when the findings look normal — fall back to routine daily care or monitoring suggestions in that case.",
      "items": {
        "type": "string"
      },
      "minItems": 2
    },
    "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": [
    "severity",
    "condition",
    "summary",
    "home_care",
    "vet_advice"
  ],
  "additionalProperties": false
}

响应示例

json200 OK

{
  "success": true,
  "request_id": "req_xxxxxxxx",
  "data": {
    "severity": "normal",
    "condition": "appears within normal limits",
    "summary": "The visible ear entrance looks pink and reasonably clean in this image. I do not see obvious redness, discharge, swelling, or heavy debris in the visible portion. The photo does not show the deep canal, but the visible area appears within normal limits.",
    "home_care": [
      "Do a quick visual ear check once a week for redness, discharge, or unusual smell",
      "Gently dry the outer ear after baths or swimming to prevent moisture buildup",
      "Watch for head shaking, scratching at the ears, or new odor and recheck if any appear"
    ],
    "vet_advice": []
  }
}