API REFERENCE

AnimeTrace API

（最終更新2026年7月3日）

api.animetrace.com multipart/form-data JSON

認識API

POST https://api.animetrace.com/v1/search

リクエスト例

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

インターフェース説明

パラメータ	説明	オプション値	必須かどうか
`is_multi`	複数の結果を表示するかどうか	`0` または `1`	いいえ
`model`	使用する認識モデル（モデル選択は下表参照）	モデル一覧API（下記）参照	いいえ
`ai_detect`	AI画像検出を有効にするかどうか	`1`: はい / `0`: いいえ	いいえ
`file`	認識する画像データ（オプション）	[画像データ]	はい
`url`	認識する画像のURLソース（オプション）	URL	はい
`base64`	認識する画像のBase64（オプション）	Base64 str	はい

file または url または base64

モデル選択

GET https://api.animetrace.com/v1/model/list

利用可能なモデルは動的に増減します。モデル名をコードに固定せず、本APIで最新一覧を取得してください。enabled が false のモデルは一時停止中のため選択できません。

レスポンス例

JSON

{
  "data": [
    {
      "id": "example-model-1.0",
      "name": "Example Model 1.0",
      "provider": "amt",
      "enabled": true,
      "default": true,
      "desc": {
        "ja": "…",
        "en": "…",
        "zh": "…"
      }
    }
  ],
  "code": 0,
  "message": "success"
}

フィールド説明

フィールド	タイプ	説明
`data`	array	モデルの配列
`data[].id`	string	モデルID（/v1/search の model パラメータに渡す値）
`data[].name`	string	表示名
`data[].provider`	string	モデル提供元
`data[].enabled`	bool	利用可能か（false＝一時停止中・選択不可）
`data[].default`	bool	既定モデルかどうか
`data[].desc`	object	モデル説明（ja / en / zh）

レスポンス

レスポンス例

JSON

{
  "code": 0,
  "ai": false,
  "trace_id": "34ab47ab-9162-4213-a7e3-635e8ccb6640",
  "data": [
    {
      "box": [0.173, 0.219, 0.460, 0.398],
      "box_id": "6a555364-1c8b-4be7-9c48-97af53ad856b",
      "not_confident": true,
      "character": [
        { "work": "ご注文はうさぎですか？", "character": "保登心愛" },
        { "work": "Clover Day's", "character": "鷹倉杏鈴" },
        { "work": "恋×シンアイ彼女", "character": "小鞠ゆい" }
      ]
    },
    {
      "box": [0.489, 0.035, 0.724, 0.197],
      "box_id": "3f4430a9-5ef0-4276-8bf2-78bd11b8a4c4",
      "not_confident": false,
      "character": [
        { "work": "Clover Day's", "character": "鷹倉杏璃" }
      ]
    }
  ]
}

フィールド説明

フィールド	タイプ	説明
`code`	int	状態コード（0＝成功）
`trace_id`	string	今回の認識を一意に識別するID（お問い合わせ時に使用）
`ai`	bool	AI生成画像と判定されたか（true / false）
`data`	array	検出された人物ごとの結果リスト
`data[].box`	number[4]	人物の位置 [x1, y1, x2, y2]（画像の幅・高さに対する0〜1の相対座標）
`data[].box_id`	string	検出枠ごとの一意ID
`data[].not_confident`	bool	確信度が低い（候補が多く、要確認）
`data[].character`	array	候補キャラクターのリスト（上位ほど可能性が高い）
`data[].character[].work`	string	作品名
`data[].character[].character`	string	キャラクター名

ステータスコード説明

ステータスコード	HTTPステータスコード	説明
`17720`	-	認識成功
`200`	200	成功
`17721`	200	サーバーは正常に稼働しています
`17701`	413	画像サイズが大きすぎます
`17702`	503	サーバーが忙しいです。もう一度お試しください
`17703`	-	リクエストパラメータが正しくありません
`17704`	403	APIはメンテナンス中です
`17705`	-	サポートされていない画像形式です
`17706`	-	認識に失敗しました（内部エラー、もう一度お試しください）
`17707`	-	内部エラー
`17708`	-	画像内の人物数が制限を超えています
`17722`	-	画像のダウンロードに失敗しました
`17728`	-	今回の使用上限に達しました
`17731`	-	サーバーリソースが多すぎます。もう一度お試しください
`404`	-	ページが見つかりません