Annotate Template

Suggest pose / skin / aspect / background for an uploaded hand photo. Used by the upload modal to auto-fill the form so the user typically only needs to confirm + click Save.

The endpoint is best-effort: Gemini outages don't 5xx — the annotator falls back to the form defaults (single_hand / light / 1:1 / white) so the upload still works. Confidence rides in the response so the UI can dim low-confidence suggestions.

Latency: 1-3s typical (Gemini Pro Vision on a single 4K-or-smaller image), 30s ceiling via the genai HTTP timeout.

post/api/hand-templates/annotate

Request

  • Base URL: https://api.tintin-x.com (the document declares no server; this is the origin it was published from)
  • URL: https://api.tintin-x.com/api/hand-templates/annotate
  • Auth: HTTP bearer

Request body

hand_s3_keystring nullable
content_typestring nullable

Response

Successful Response

pose'single_hand' | 'two_hands_layered' | 'fist_flat_dual' | 'holding_prop' required
skin_tone'fair' | 'light' | 'medium' | 'tan' | 'deep' required
aspect_ratio'1:1' | '4:5' | '3:4' | '16:9' required
background'white' | 'gradient' | 'extended' required
confidencenumber required

Changes

No recorded changes to this operation across all 1 revision of this API.