品种识别 - Poomi Docs

POST/api/v1/breed-identification

图片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/breed-identification \
  -H "Authorization: Bearer pk_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "image": "base64_encoded_data",
    "animalType": "dog",
    "language": "zh"
  }'

响应字段

字段	类型	必填	描述
`breed`	`string`	是	Single most likely breed or breed-group name
`species`	`string`	是	Identified animal species
`summary`	`string`	是	A detailed 4 to 6 sentence summary covering the visible traits that support the species and breed judgment, confidence factors, and any important limitation
`confidence`	`number`	是	Confidence score from 0 to 1

响应 Schema

json-schema

{
  "type": "object",
  "required": [
    "species",
    "breed",
    "confidence",
    "summary"
  ],
  "properties": {
    "breed": {
      "type": "string",
      "description": "Single most likely breed or breed-group name"
    },
    "species": {
      "type": "string",
      "description": "Identified animal species"
    },
    "summary": {
      "type": "string",
      "description": "A detailed 4 to 6 sentence summary covering the visible traits that support the species and breed judgment, confidence factors, and any important limitation"
    },
    "confidence": {
      "type": "number",
      "maximum": 1,
      "minimum": 0,
      "description": "Confidence score from 0 to 1"
    }
  },
  "additionalProperties": false
}

响应示例

json200 OK

{
  "success": true,
  "request_id": "req_xxxxxxxx",
  "data": {
    "breed": "Golden Retriever",
    "species": "dog",
    "summary": "This pet appears to be a dog, and the visible coat texture, head shape, and overall proportions are most consistent with a Golden Retriever. The feathered golden coat, soft retriever-like facial features, and balanced medium-large build support that reading. The result should be treated as a visual breed estimate rather than proof of pedigree, because mixed ancestry can share many of the same traits. Confidence would be lower if the full body, tail, or side profile were not clearly visible.",
    "confidence": 0.88
  }
}