文档接口背甲检测

背甲检测

上传一张乌龟背甲照片，返回甲壳软化、破损、腐甲等情况、健康评分和护理建议。

POST

/api/v1/shell-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/shell-analysis \
  -H "Authorization: Bearer pk_xxxxxxxx…" \
  -H "Content-Type: application/json" \
  -d '{"image":"<base64>","animalType":"turtle"}'

响应字段

公共字段多个接口共用

字段	类型	说明
`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.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": {
    "summary": "照片里背甲后半部有两块发白的区域，表面坑坑洼洼、边缘不整齐，和周围正常的盾片不一样。这种样子可能是腐甲的早期表现，常和水质不干净、晒背不足有关。也可能是正在脱落的旧盾片，单看照片不能确定。照片看不出甲壳软硬，需要用手轻按确认。建议马上改善饲养环境，并带去看爬宠的兽医。",
    "urgency": "一周内就医",
    "findings": [
      {
        "area": "背甲后半部",
        "meaning": "可能是早期腐甲，也可能是脱落中的旧盾片",
        "severity": "中度",
        "observation": "两块发白区域，表面坑洼、边缘不齐"
      },
      {
        "area": "背甲其他部分",
        "meaning": "其他部位看起来正常",
        "severity": "正常",
        "observation": "盾片完整，颜色和花纹均匀"
      }
    ],
    "severity": "中度",
    "condition": "疑似腐甲",
    "home_care": [
      "每天给乌龟提供干燥的晒背区，开启爬宠专用的紫外线灯，每天 8–10 小时",
      "勤换水并清洁水箱，保持水质干净",
      "每隔 2–3 天拍一张同角度的照片，对比发白区域有没有扩大"
    ],
    "vet_advice": [
      "发白区域扩大、按压发软、有异味或渗液时，24 小时内找看爬宠的兽医"
    ],
    "retake_tips": [
      "把乌龟翻过来拍一张腹甲",
      "擦干背甲后在自然光下拍发白区域的近景"
    ],
    "health_score": 5,
    "health_score_max": 10,
    "species": "turtle",
    "species_source": "provided"
  }
}

上一个品种识别下一个四肢与肉垫检测

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

投诉举报：support@poomi.cn