AnimeTrace

開発ドキュメントは移転しました / Docs Moved

本サイト(docs.animedb.cn)は運用を終了しました。AnimeTrace の開発ドキュメントは現在、本家サイトに掲載されています。

开发文档已迁移至主站。 / This documentation site has moved to the main site.

API クイックリファレンス / Quick Reference

以下は主要エンドポイントの概要です。パラメータ・レスポンスフィールド・ステータスコードの完全な仕様は最新ドキュメントを参照してください。

認識エンドポイント

POST https://api.animetrace.com/v1/searchmultipart/form-data

パラメータ説明
file / url / base64認識する画像。いずれか1つ必須(ファイル / 画像URL / Base64 文字列)
model認識モデルID(下記のモデル一覧APIで取得。ハードコード非推奨)
is_multi複数の候補を返すか。0 または 1(任意)
ai_detectAI生成画像の検出を有効にするか。0 または 1(任意)

リクエスト例

curl -X POST https://api.animetrace.com/v1/search \
  -F "is_multi=1" \
  -F "ai_detect=1" \
  -F "file=@image.jpg"

モデル一覧

GET https://api.animetrace.com/v1/model/list —— 利用可能なモデルは随時追加・廃止されるため、本APIで最新の一覧を取得してください。enabled: false のモデルは利用不可、default: true がデフォルトモデルです。

レスポンス構造

{
  "code": 0,            // 0 = 成功
  "ai": false,          // AI生成画像と判定されたか
  "trace_id": "…",      // 今回の認識の一意なID
  "data": [{
    "box": [x1, y1, x2, y2],   // 人物の位置(0〜1 の相対座標)
    "box_id": "…",
    "not_confident": false,     // true = 信頼度が低く、要確認
    "character": [{             // 候補キャラクター。先頭ほど可能性が高い
      "work": "作品名",
      "character": "キャラクター名"
    }]
  }]
}