皮肤分析 - Poomi Docs

上传宠物皮肤状况照片，分析皮疹、病变、脱毛等皮肤问题。

POST/api/v1/skin-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/skin-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 skin findings
`condition`	`string`	是	Short owner-facing label for the visible skin 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 skin findings",
      "enum": [
        "normal",
        "mild",
        "moderate",
        "severe",
        "inconclusive"
      ]
    },
    "condition": {
      "type": "string",
      "description": "Short owner-facing label for the visible skin 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 skin and coat look within normal limits in this image. I do not see clear redness, hair loss, crusting, discharge, or open lesions on the visible surface. This photo cannot rule out itching, pain, or microscopic skin issues.",
    "home_care": [
      "Brush the coat regularly with a gentle brush to check skin and remove loose hair",
      "Keep the area clean and dry, and avoid harsh shampoos or unfamiliar topical products",
      "Watch for new redness, scratching, hair loss, or odor over the next 1-2 weeks"
    ],
    "vet_advice": []
  }
}