瑞丰彩・UV云打印・开放平台

> 创建AI任务：第三方平台通过接口向指定设备实时创建AI生成任务，开放平台同步返回生成编号，自动派发至该设备的终端软件，支持设备离线生成AI任务，设备启动后可查看待打印任务。

#### 接口信息

|  接口地址 |  &#x68;ttp://www.colorpark.cn/api/ai/run |
|----|----|
|请求方式|POST|
#### 请求参数
| 参数名  |  参数值（示例） |  必填项 |  参数说明 |
| ---- | ---- | ---- | ---- |
| partner_id   | 2025000001  |  是 | 开放平台提供的商户编号（登录开放平台查看：商户管理-我的商户-编号）  |
| once   | 8305   | 是  |  加密生成签名时使用的随机数值 |
|  time | 1646790335   | 是  |  加密生成签名时使用的时间戳 |
|  sign  |  9ce3ce7a3fccaf3d7715bd7e9bb1dc1c  |  是 | 根据“生成商户签名”接口获取字符串sign  |
|  image  |  http://rfccrm.oss-cn-shenzhen.aliyuncs.com/temp/502707bf1b65e307c43bcb86aa10746a43107961.png  |  是 | 原始图地址（模板中的oss_image） |
|  template_id  |  1 |  是 | 模板id |
|  scene  |  http://rfccrm.oss-cn-shenzhen.aliyuncs.com/render/2025/11/26/1124014/2d1852e24c659bbaeeca4e44e972426e7448755f.png  |  是 | 场景图地址 |
|  callback  |  http://www.abc.com/api/callback  |  是 | 回调地址，甲方系统用于接收任务提交通知的回调地址 |
|  style_index  |  2  |  否 | 风格关联各类：0：复古漫画,1：3D 童话,2：二次元,3：小清新,4：未来科技,5：国画古风,6：将军百战,7：炫彩卡通,8：清雅国风,9：喜迎新年,14：国风工笔,15：恭贺新禧,30：童话世界,31：黏土世界,32：像素世界, 33：冒险世界,34：日漫世界,35：3D 世界,36：二次元世界, 37：手绘世界,38：蜡笔世界,39：冰箱贴世界,40：吧唧世界 |
|  text  |  婚姻纪念  |  否 | 描述 |
|  comment  |  合照  |  否 | 第三方风格名称或备注 |
|  app_number  |  10908002  |  否 | ai拍照设备的应用编号 |
|image_out|{"angle":45,"x_scale":1.5,"y_scale":1.5}|否|扩图:旋转图像-{"angle":45,"x_scale":1.5,"y_scale":1.5}, 等比例图像:{"x_scale":2,"y_scale":2,"best_quality":false,"limit_image_size":true},指定方向扩图: {"left_offset": 200,"right_offset": 100,"best_quality": false,"limit_image_size": true},指定宽高比扩图:{"angle":0,"output_ratio":"4:3", "best_quality":false,"limit_image_size":true}
```
提示：
1、template_id=17：AI 扩图，text参数可以为空；
2、模型是【人像风格】，style_index 属性需要传参数，否则不需要传参；
3、创建 AI 任务 ：异步任务，图像生成通过callback属性 POST 回调通知()

异步回调结果: 
headers Content-Type=application/x-www-form-urlencoded
form_params

status="success"
picture="http://abc.com/xxx.jpeg"
prompt_id="xxxxxxxx"
message=""

status:状态 queueing-队列中,success-成功,fail-失败,cancel-待取消,canceled-已取消
picture:图像地址
prompt_id:任务 ID
message:信息提示
```

#### 返回结果

| 参数名 | | 参数值(示例) |参数说明|
| --- | --- | --- |----|
| code |  | 0 | 返回结果状态码，成功时为0，失败时为400 |
| msg |  | 请求成功 | 返回结果描述，如：请求成功 |
|data| prompt_id | c20d543a-8c8f-4b55-81da-3c54a5ba93ca | AI任务ID |

------------

*若设备在调试过程中遇到不能解决问题，可以联系云打印负责人排除问题，找到解决的方法。联系方法如下：
电 话：137-5177-4454【微信同号】
邮 箱：info@ColorPark.cn*

##### *软硬件深度整合的UV云打印服务商  &reg; 瑞丰彩*