API REFERENCE

AnimeTrace API

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

api.animetrace.com multipart/form-data JSON

識別接口

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`	使用的識別模型（模型選擇見下表）	見下方模型列表介面	否
`ai_detect`	是否開啟AI圖檢測	`1`: 是 / `0`: 否	否
`file`	識別的圖片數據（可選）	[圖片數據]	是
`url`	識別的圖片URL來源（可選）	URL	是
`base64`	識別的圖片Base64（可選）	Base64 str	是

file 或 url 或 base64

模型選擇

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

可用模型會動態增減，請不要在程式碼裡寫死模型名，應透過本介面取得最新列表。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`	-	頁面不存在