品种识别 - Poomi Docs

POST/api/v1/breed-identification

图片5 每次调用额度

字段	类型	必填	描述
`image`	`string`	是	Base64 编码的图片数据（JPG/PNG/WEBP，最大 3MB）
`animalType`	`string`	否	分析的动物类型（如：dog、cat、rabbit、hamster）
`language`	`string`	否	响应语言代码（zh, en）

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"
  }'

响应字段

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

响应 Schema

json-schema

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

响应示例

json200 OK

{
  "success": true,
  "request_id": "req_xxxxxxxx",
  "data": {
    "species": "dog",
    "breed": "Golden Retriever",
    "confidence": 0.88,
    "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 and soft retriever-like facial features support that reading. Confidence would be lower if the full body or tail were not clearly visible."
  }
}