---

name: tomoviee-recognition description: Auto-generate masks for objects/regions in images. Use when users request image_recognition operations or related tasks.

Tomoviee AI - 图像识别 (Image Recognition)

Overview

Auto-generate masks for objects/regions in images.

API: tm_reference_img2mask

Quick Start

Authentication

python scripts/generate_auth_token.py YOUR_APP_KEY YOUR_APP_SECRET

Python Client

from scripts.tomoviee_image_recognition_client import TomovieeClient

client = TomovieeClient("app_key", "app_secret")

API Usage

Basic Example

task_id = client._make_request({
    image='https://example.com/photo.jpg'
    control_type='2'  # subject/default
})

result = client.poll_until_complete(task_id)
import json
output = json.loads(result['result'])

Parameters

• image (required): Image URL to analyze
• control_type: 0=edge, 1=pose, 2=subject, 3=depth

Async Workflow

1. Create task: Get task_id from API call
2. Poll for completion: Use poll_until_complete(task_id)
3. Extract result: Parse returned JSON for output URLs

Status codes:

• 1 = Queued
• 2 = Processing
• 3 = Success (ready)
• 4 = Failed
• 5 = Cancelled
• 6 = Timeout

Resources

scripts/

• tomoviee_image_recognition_client.py - API client
• generate_auth_token.py - Auth token generator

references/

See bundled reference documents for detailed API documentation and examples.

External Resources

• Developer Portal: https://www.tomoviee.ai/developers.html
• API Documentation: https://www.tomoviee.ai/doc/
• Get API Credentials: Register at developer portal