Emotion Analysis - Poomi Docs

Upload a photo of your pet to analyze their facial expression, body language, and emotional state.

POST/api/v1/emotion-analysis

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/emotion-analysis \
  -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
`emotion`	`string`	Yes	Most likely current emotional state
`confidence`	`number`	Yes	Confidence score from 0 to 1
`summary`	`string`	Yes	A concise 2 to 4 sentence summary covering the visible cues, the emotional interpretation, and any important limitation

Response Schema

json-schema

{
  "type": "object",
  "properties": {
    "emotion": {
      "type": "string",
      "description": "Most likely current emotional state"
    },
    "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 cues, the emotional interpretation, and any important limitation"
    }
  },
  "required": [
    "emotion",
    "confidence",
    "summary"
  ],
  "additionalProperties": false
}

Response Example

json200 OK

{
  "success": true,
  "request_id": "req_xxxxxxxx",
  "data": {
    "emotion": "relaxed",
    "confidence": 0.84,
    "summary": "The pet appears relaxed in this image. The visible posture looks loose and balanced rather than tense or defensive, and there are no strong signs of fear or distress in the visible frame. A clearer full-body view would help confirm tail and lower-body cues."
  }
}