Hova API Reference

Overview

The Hova API provides endpoints for image processing and format conversion in the TKM AI Agency Platform. It handles image uploads, processing, thumbnail generation, and HEIC format conversion.

Endpoints

Process Image

POST /process_image

Processes an uploaded image and generates thumbnails.

Request Body (multipart/form-data)

Name	Type	Required	Description
`file`	File	Yes	The image file to process
`user_id`	string	Yes	The user ID
`session_id`	string	Yes	The session ID
`conversation_id`	string	Yes	The conversation ID
`organization_id`	string	No	The organization ID (defaults to "tkm_123456")

Response

{
    "success": true,
    "data": {
        "thumbnail_path": "string",
        "original_path": "string",
        "metadata": {
            "dimensions": "string",
            "format": "string",
            "size": "string"
        }
    },
    "normalized_response": "string",
    "metadata": {
        "additional": "data"
    },
    "thumbnail_path": "organization_id/user_id/thumbnails/filename"
}

Convert HEIC

POST /convert_heic

Converts an HEIC image file to JPEG format.

Request Body (multipart/form-data)

Name	Type	Required	Description
`file`	File	Yes	The HEIC file to convert

Response

Content-Type: image/jpeg
Body: Binary JPEG image data

Error Responses

500 Internal Server Error

{
    "detail": "Error message"
}

Integration Notes

Image Processing Features

Thumbnail generation
Metadata extraction
Format conversion
Organization-based storage

File Management

Temporary file handling
Secure file cleanup
Path organization
Storage optimization

Format Support

HEIC to JPEG conversion
RGB color space handling
Quality preservation
Multiple format support

Integration with Other Agents

Humile: Response normalization
Niger: Storage management (optional)
Atta: Conversation context

Gulosa Rufa