第三方平台通过调用创建AI任务接口，向开放平台提交AI图像生成请求，平台同步返回AI任务ID（prompt_id），自动派发至设备终端软件；支持设备离线时创建任务，设备上线后可查看并执行待生成/打印任务。
接口信息
请求参数
| 参数名 |
参数值（示例） |
必填项 |
参数说明 |
| 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 |
39 |
是 |
39-双图（image-上传图 scene-场景图）40-单图（image-上传图） |
| scene |
http://rfccrm.oss-cn-shenzhen.aliyuncs.com/render/2025/11/26/1124014/2d1852e24c659bbaeeca4e44e972426e7448755f.png |
是 |
场景图地址 |
| callback |
http://www.abc.com/api/callback |
是 |
回调地址，甲方系统用于接收任务提交通知的回调地址 |
| prompt |
将图 1 中的人物完整替换到图 2 的人物位置，保持图 2 原有背景、光影、透视、色调不变，人物大小比例匹配原图，融合自然、无违和感，细节真实，高质量合成，高清、8K、细节丰富、边缘干净、光影统一、自然融合、专业级合成、无瑕疵。 |
是 |
提示词（中文） |
| 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} |
| width |
|
否 |
图像宽度,默认1440px |
| height |
|
否 |
图像高度,默认2560px |
推荐的宽高像素值：
| 分辨率 |
宽高比 |
宽高像素值 |
| 2K |
1:1 |
2048x2048 |
| 4:3 |
2304x1728 |
| 3:4 |
1728x2304 |
| 16:9 |
2848x1600 |
| 9:16 |
1600x2848 |
| 3:2 |
2496x1664 |
| 2:3 |
1664x2496 |
| 21:9 |
3136x1344 |
| 3K |
1:1 |
3072x3072 |
| 4:3 |
3456x2592 |
| 3:4 |
2592x3456 |
| 16:9 |
4096x2304 |
| 9:16 |
2304x4096 |
| 2:3 |
2496x3744 |
| 3:2 |
3744x2496 |
| 21:9 |
4704x2016 |
callback 回调通知
| 请求方式 |headers| 通知 | 返回数据 |
|----|----|----|
| post |Content-Type:application/x-www-form-urlencoded| fail | {"status":"fail","prompt_id":10449,"picture":"","message":"图片类型错误，请检查图片类型和内容"} |
| || success | {"status":"success","prompt_id":11047,"picture":"https://rfccrm.colorpark.cn/colorcloud/ai/406d414e7167a4b09bae92626e3fed6585980d11.png","message":"generated successfully"} |
提示：
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云打印服务商 ® 瑞丰彩
![https://rfccrm.colorpark.cn/colorcloud/ai/406d414e7167a4b09bae92626e3fed6585980d11.png","message":"generated](https://rfccrm.colorpark.cn/colorcloud/ai/406d414e7167a4b09bae92626e3fed6585980d11.png","message":"generated){kind=link}