# AnimeTrace

> AnimeTrace (アニメトレース) is a free web service that identifies anime / Galgame characters from an image. Upload a picture and it returns the character name and the work (anime/game) they appear in. A public HTTP API is available for developers.

Site UI languages: 日本語 / 简体中文 / 繁體中文 / English / 한국어 (language-prefixed URLs: /ja/, /zh/, /en/, /kr/, /tw/).

## API documentation (for developers / code generation)

- API docs (Simplified Chinese, default): https://www.animetrace.com/api-docs/
- API docs (English): https://www.animetrace.com/en/api-docs/
- API docs (日本語): https://www.animetrace.com/ja/api-docs/

Quick facts (see the docs above for the authoritative, up-to-date reference):

- Recognition endpoint: `POST https://api.animetrace.com/v1/search`
  - Content-Type: `multipart/form-data`
  - Image input (exactly one required): `file` (binary) or `url` or `base64`
  - Optional fields: `model` (model id), `is_multi` (0/1, return multiple candidates), `ai_detect` (0/1, AI-generated-image detection)
- Model list: `GET https://api.animetrace.com/v1/model/list`
  - Available models change over time — do NOT hardcode model names; fetch this list and pick a model whose `enabled` is true (`default: true` marks the default model).
- Response (JSON): `{ code, ai, trace_id, data: [ { box[4], box_id, not_confident, character: [ { work, character } ] } ] }`
  - `code` 0 = success; `box` is [x1, y1, x2, y2] relative (0–1) coordinates; `character` candidates are ordered most-likely first.
- Error codes (e.g. 17701 image too large, 17702 server busy, 17704 maintenance, 17705 unsupported format, 17728 usage limit reached) are documented on the API docs page.

## Other pages

- Home / recognition UI: https://www.animetrace.com/
- Privacy & copyright notice: https://www.animetrace.com/copyright/

## Notes

- The website and API only identify characters in anime/Galgame images; no anime resources are hosted or distributed.
- Sitemap: https://www.animetrace.com/sitemap.xml