文档接口姿态检测

姿态检测

上传一张蜘蛛照片，返回姿态、腹部是否干瘪、健康评分和护理建议。

POST

/api/v1/posture-analysis

输入：图片基础模型 ¥0.20强化模型 ¥1.00/ 次

请求参数

字段	类型	必填	说明
`image`	string	必填	图片的 base64 编码（不带 data: 前缀）。JPG / PNG / WEBP，≤ 3MB
`animalType`	string	选填	dog / cat / rabbit / hamster / bird / turtle / snake / spider。建议传，更准更快；不传时自动识别物种，不另收费。传的动物和照片不符时，按照片里的动物分析，summary 开头会说明，照常收费
`model`	string	选填	basic = 基础模型（默认），更快更省；pro = 强化模型，判断更准、发现更细。也可以填「基础模型」「强化模型」
`language`	string	选填	已废弃，只返回中文

支持的动物

在线调试

发一个真实请求基础模型 ¥0.20 / 次

API Key

动物类型

模型

更快更省 · 约 10–15 秒

图片

点击或拖入图片JPG / PNG / WEBP，≤ 3MB

状态 —耗时 —费用 —

结果会显示在这里

选好 Key 和图片，点「发送」

请求示例

curl https://open.poomi.cn/api/v1/posture-analysis \
  -H "Authorization: Bearer pk_xxxxxxxx…" \
  -H "Content-Type: application/json" \
  -d '{"image":"<base64>","animalType":"spider"}'

响应字段

公共字段多个接口共用

字段	类型	说明
`success`	boolean	成功为 true；失败为 false，并返回 error
`request_id`	string	本次调用编号，查账和申请删除时用
`model_tier`	string	本次用的模型档位：basic（基础模型）或 pro（强化模型）
`ai_generated`	boolean	固定为 true，展示时请注明「内容由 AI 生成」
`data.species`	string	动物类型
`data.species_source`	string	provided = 你传的 animalType；auto = 照片识别（不传，或传的和照片不符）
`data.health_score`	integer	健康评分 1–10，越高越好。只有健康检测有
`data.health_score_max`	integer	评分满分，固定为 10。只有健康检测有
`data.severity`	string	严重程度（正常 / 轻度 / 中度 / 严重 / 无法判断）
`data.summary`	string	结论说明，4–6 句
`data.home_care`	array<string>	居家护理建议，至少 3 条
`data.vet_advice`	array<string>	就医建议；不需要就医时为空数组

本接口特有字段旧字段继续返回

字段	类型	说明
`data.abdomen`	string	How full the abdomen looks, written in the response language (default Chinese: 饱满 / 正常 / 偏瘪 / 明显干瘪 / 无法判断)
`data.posture`	string	Short owner-facing description of the spider's posture, written in the response language
`data.urgency`	string	就医紧急程度，固定取值：马上就医 / 24小时内就医 / 一周内就医 / 观察几天 / 日常观察 / 无法判断
`data.findings`	array<object>	逐条列出照片里看到的发现，最重要的在前；照片看不清时为空数组
`data.findings[].area`	string	部位，例如「左眼内眼角」「粪便表面」「后脚脚底」
`data.findings[].meaning`	string	可能意味着什么（初筛，不是诊断）
`data.findings[].severity`	string	这一条的严重程度：正常 / 轻度 / 中度 / 严重
`data.findings[].observation`	string	看到了什么：颜色、大小、形态、范围
`data.condition`	string	可见状况的简短描述
`data.retake_tips`	array<string>	照片不够判断时，具体怎么补拍（1–3 条）；照片够用时为空数组

响应示例

{
  "success": true,
  "request_id": "req_66o9oGrP5xJVu3Gx7tkvi",
  "model_tier": "basic",
  "ai_generated": true,
  "data": {
    "abdomen": "偏瘪",
    "posture": "正常站立",
    "summary": "照片里蜘蛛八条腿正常展开站立，没有蜷缩在身下。腹部看起来比头胸部小，表面有些皱，属于偏瘪。这种样子常见于喝水不够或一段时间没进食。姿态正常，说明目前还不紧急。照片看不出箱内湿度，先补水观察几天。",
    "urgency": "观察几天",
    "findings": [
      {
        "area": "腿部",
        "meaning": "姿态正常",
        "severity": "正常",
        "observation": "八条腿向四周展开，身体离地"
      },
      {
        "area": "腹部",
        "meaning": "可能喝水不够或进食少",
        "severity": "轻度",
        "observation": "比头胸部小，表面有皱褶"
      }
    ],
    "severity": "轻度",
    "condition": "腹部偏瘪",
    "home_care": [
      "放一个浅水盆，每天换干净的水，水深不要超过它的身体高度",
      "按这个品种的要求调整湿度，可以往垫材一角喷水",
      "近期不要上手，几天后再拍一张同角度照片对比腹部"
    ],
    "vet_advice": [
      "腿开始往身下蜷缩、身上有液体渗出，或补水几天后腹部仍明显干瘪时，尽快找看异宠的兽医"
    ],
    "retake_tips": [],
    "health_score": 6,
    "health_score_max": 10,
    "species": "spider",
    "species_source": "provided"
  }
}

上一个眼睛检测下一个蜕皮检测

文档有误？发邮件到 support@poomi.cn

投诉举报：support@poomi.cn