API文档

API 文档

宠物识别 API

接口信息

请求参数

字段类型必填描述
imageFile/Base64是宠物图片文件或Base64编码
accessKeyIdstring是访问密钥ID

响应参数

字段类型描述
codenumber状态码：200成功，其他表示错误
messagestring响应消息
dataobject响应数据对象
data.typestring识别结果（cat/dog）
data.confidencestring置信度（百分比格式）
data.recognitionTypestring使用的识别类型
request_idstring请求ID，用于追踪
transaction_idstring事务ID，用于计费追踪

错误码

状态码描述
400请求参数错误或无法处理图像数据
401访问密钥无效或未授权
402账户余额不足，需要充值
405仅支持POST请求
415不支持的内容类型，请使用multipart/form-data
429请求频率超过限制
500服务器内部错误

示例代码

使用 FormData 上传图片

// 使用fetch调用API（FormData方式）
const formData = new FormData();
formData.append('image', imageFile);
formData.append('accessKeyId', 'your_access_key_id');
formData.append('recognitionType', 'dual'); // 可选：cat, dog, dual

const response = await fetch('https://xuanji-ai.tech/api/classify', {
  method: 'POST',
  body: formData
});

const result = await response.json();
console.log(result);
// 成功响应示例：
// {
//   "code": 200,
//   "message": "识别成功",
//   "data": {
//     "type": "cat",
//     "confidence": "95.23%",
//     "recognitionType": "dual"
//   },
//   "request_id": "550e8400-e29b-41d4-a716-446655440000",
//   "transaction_id": "550e8400-e29b-41d4-a716-446655440001"
// }