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	Success
`17721`	200	服务器正常运行中
`17701`	413	图片大小过大
`17702`	503	服务器繁忙，请重试
`17703`	-	请求参数不正确
`17704`	403	API 维护中
`17705`	-	图片格式不支持
`17706`	-	识别无法完成（内部错误，请重试）
`17707`	-	内部错误
`17708`	-	图片中的人物数量超过限制
`17722`	-	图片下载失败
`17728`	-	已达到本次使用上限
`17731`	-	服务利用人数过多，请重新尝试
`404`	-	页面不存在