BIXINAI图片转矢量API文档

API简介

本API提供多服务器图片上传与矢量格式转换服务，支持同时上传到三台不同云服务商的服务器，并可将图片转换为多种矢量格式。

接口认证

所有接口调用需要使用API密钥进行认证：KEY请联系客服微信：hytx668801 索取

GET接口

1. 图片URL上传

接口地址
http://mm.kknc.site/webapi/webapi.php

请求参数

参数	必填	说明
pic	是	图片URL地址
vectorformat	是	转换格式(.svg/.eps/.pdf/.dxf/.png)
key	是	API认证密钥

请求示例
http://mm.kknc.site/webapi/webapi.php?pic=https://example.com/image.jpg&vectorformat=.pdf&key=9B812E6CDD711664

成功响应

{
  "code": 200,
  "state": "success",
  "msg": "3台服务器上传成功！",
  "fileName": "pic_1621234567.jpg",
  "fileSize": 102400,
  "bianhao": "WEBAPI_1621259892",
  "servers": [
    {
      "name": "阿里云线路①",
      "url": "http://123.56.15.144/webapi_upload.php",
      "success": true,
      "fileName": "pic_1621234567.jpg",
      "fileSize": 102400,
      "imageUrl": "http://123.56.15.144/uploads/pic_1621234567.jpg"
    },
    {...}
  ]
}

2. 任务状态查询

接口地址
http://mm.kknc.site/webapi/webapi.php

请求参数

参数	必填	说明
bianhao	是	任务编号(上传接口返回)

请求示例
http://mm.kknc.site/webapi/webapi.php?bianhao=WEBAPI_1621259892

响应示例

{
  "code": 200,
  "state": "服务器处理成功",
  "msg": "http://example.com/converted_file.pdf"
}

3. 调用次数查询

接口地址
http://mm.kknc.site/webapi/webapi.php?act=query&key=YOUR_API_KEY

请求参数

参数	必填	说明
act	是	固定值"query"
key	是	API认证密钥

响应示例

{
  "code": 200,
  "msg": "查询成功",
  "data": {
    "key": "9B812E6CDD711664",
    "used_num": 15,
    "max_num": 60,
    "remaining_num": 45
  }
}

POST接口

接口地址
http://mm.kknc.site/webapi/webapi.php

请求参数

参数	类型	必填	说明
file	file	是	上传的图片文件
apiKey	string	是	API认证密钥
vectorFormat	string	是	转换格式(.svg/.eps/.pdf/.dxf/.png)
fileName	string	否	自定义文件名(不包含扩展名)

请求示例

<form action="http://mm.kknc.site/webapi/webapi.php" method="post" enctype="multipart/form-data">
  <input type="file" name="file">
  <input type="hidden" name="apiKey" value="9B812E6CDD711664">
  <input type="hidden" name="vectorFormat" value=".pdf">
  <input type="submit" value="Upload">
</form>

响应格式
与GET方式图片URL上传相同

返回状态码

状态码	说明
200	成功
400	参数错误或认证失败
404	任务不存在
500	服务器处理错误

错误处理

所有错误响应格式如下：

{
  "code": 400,
  "state": "error",
  "msg": "错误描述信息"
}

常见错误：

• 接口秘钥key错误
• vectorformat 或 key 为空值！
• 调用次数已满，最大允许次数: XX
• 图片大小不能超过10MB

示例代码

Python上传示例

import requests

url = "http://mm.kknc.site/webapi/webapi.php"
params = {
    "pic": "https://example.com/image.jpg",
    "vectorformat": ".pdf",
    "key": "9B812E6CDD711664"
}

response = requests.get(url, params=params)
print(response.json())

JavaScript查询示例

fetch('http://mm.kknc.site/webapi/webapi.php?bianhao=WEBAPI_1621234567')
  .then(response => response.json())
  .then(data => console.log(data));

PHP上传示例

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "http://mm.kknc.site/webapi/webapi.php");
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

$file = new CURLFile('image.jpg', 'image/jpeg', 'image.jpg');
$postData = [
    'file' => $file,
    'apiKey' => '9B812E6CDD711664',
    'vectorFormat' => '.pdf'
];

curl_setopt($ch, CURLOPT_POSTFIELDS, $postData);
$response = curl_exec($ch);
curl_close($ch);

echo $response;