皮肤分析 - Poomi Docs

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

POST/api/v1/skin-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/skin-analysis \
  -H "Authorization: Bearer pk_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "image": "base64_encoded_data",
    "animalType": "dog",
    "language": "zh"
  }'

响应字段

字段	类型	必填	描述
`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 skin findings, written in the requested response language
`condition`	`string`	是	Owner-facing label for the visible skin condition
`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.

响应 Schema

json-schema

{
  "type": "object",
  "required": [
    "severity",
    "condition",
    "summary",
    "home_care",
    "vet_advice"
  ],
  "properties": {
    "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 skin findings, written in the requested response language"
    },
    "condition": {
      "type": "string",
      "description": "Owner-facing label for the visible skin condition"
    },
    "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."
    }
  },
  "additionalProperties": false
}

响应示例

json200 OK

{
  "success": true,
  "request_id": "req_xxxxxxxx",
  "data": {
    "summary": "The visible skin and coat look within normal limits in this image. I do not see clear redness, hair loss, crusting, discharge, swelling, or open lesions on the visible surface. That visible appearance is reassuring if the pet is not scratching, licking, or showing discomfort. This photo cannot rule out itching, pain, parasites hidden under the coat, or microscopic skin issues, so behavior and changes over time still matter.",
    "severity": "normal",
    "condition": "appears within normal limits",
    "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": []
  }
}