Breed Identification

Upload a photo of your pet to identify its breed, mixed-breed composition, and breed-specific characteristics.

POST/api/v1/breed-identification

Image5 Credits per call

Field	Type	Required	Description
`image`	`string`	Yes	Base64-encoded image data (JPG/PNG/WEBP, max 3MB)
`animalType`	`string`	No	Animal type for analysis (e.g. dog, cat, rabbit, hamster)
`language`	`string`	No	Response language code (zh, en)

API Playground

Animal Type

Language

Request Example

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

Response Fields

Field	Type	Required	Description
`species`	`string`	Yes	Identified animal species
`breed`	`string`	Yes	Single most likely breed or breed-group name
`confidence`	`number`	Yes	Confidence score from 0 to 1
`summary`	`string`	Yes	A concise 2 to 4 sentence summary covering the visible traits that support the species and breed judgment, plus any important limitation

Response 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
}

Response Example

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