智汇云-企业数智化核心引擎

首页> 开发者中心>图片处理>API文档>API文档

# 接口名
/c_post/

# 请求域名
p.zyun.360.cn

# 名词解释
** 指令：**出现在 URI 中，以c_开头，完成对应的图片处理功能，需要与指令对应的参数一起使用生效，详见后续 “功能” 部分

**指令参数：**出现在 URI 中，非c_开头，符合 xxx_yyy 形式的内容，为指令参数，每个指令对应的指令参数不尽相同，详见后续 “功能” 部分*****

**URI path：**以 / 分隔的 Path 段，两个 "/" 之间为一个完整的 指令（包括对应参数），完成特定的一组图片处理功能。

**指令组合使用：**不同的指令可以叠加，串行处理。

**指令格式：**c_DIRECTIVE, PARAM1_VALUE1, PARAM2_VALUE2/c_DIRECTIVE, PARAM1_VALUE1, PARAM2_VALUE2

# 功能

**1.缩放**

* 正常缩放 c_resize
* 缩小（或保持原图大小） c_fit
* 放大（或保持原图大小） c_zoom

**参数说明**

| 参数名 | 含义 | 数值范围 |
| ------ | ------ | ------------------------------- |
| w | 宽 | 整数数字 (1-10000)：直接指定目标图像的宽，单位：像素。 小数数字 (0.001-7.999)：指定目标图像的宽度为原图的w倍。 不指定：按照其他参考项等比缩放 |
| h | 高 | 整数数字 (1-10000)：直接指定目标图像的宽，单位：像素。 小数数字 (0.001-7.999)：指定目标图像的宽度为原图的w倍。 不指定：按照其他参考项等比缩放 |
| u | 较长边 | 整数数字 (1-10000)：直接指定目标图像的宽，单位：像素。 小数数字 (0.001-7.999)：指定目标图像的宽度为原图的w倍。 不指定：按照其他参考项等比缩放 |
| l | 较短边 | 整数数字 (1-10000)：直接指定目标图像的宽，单位：像素。 小数数字 (0.001-7.999)：指定目标图像的宽度为原图的w倍。 不指定：按照其他参考项等比缩放 |

**参数优先级与冲突**

* w，h 优先级高于 u,l
* w，h 与 u，l互斥，当w，h任意一个被指定时，u，l均不生效

**样例**

* 原图：

![img](https://p0.qhimg.com/t011637e00e55ca96e1.jpg)

* 宽缩小到 100px，高度等比缩放

``` /c_resize,w_100 ```

![img](https://p0.qhimg.com/t01efe14b2c81780c8a.jpg)

* 宽缩小到 原来的 0.5倍

``` /c_resize,w_0.5 ```

![img](https://p0.qhimg.com/t01efe14b2c81780c8a.jpg)

* 将原图的小边缩放至 100px （整个图像不小于 100*100）

``` /c_resize,l_100 ```

![img](https://p0.qhimg.com/t01efe14b2c81780c8a.jpg)

* 将原图的最大边缩放至 100px （整个图像不大于 100*100）

``` /c_resize,u_100 ```

![img](https://p0.qhimg.com/t0102a5ed1940a8048f.jpg)

* 对图片进行缩小，使其不超过 500 * 500, 当原图尺寸小于 500*500 时，返回原图 （本例直接返回原图）

``` /c_fit,l_500 ```

![img](https://p0.qhimg.com/t011637e00e55ca96e1.jpg)

* 对图片进行放大，使其不小于 50 X 50，当原图尺寸大于 50 X 50 时，返回原图 （本例直接返回原图）

```/c_zoom,l_50 ```

![img](https://p0.qhimg.com/t011637e00e55ca96e1.jpg)

**2.裁剪**

* 按照用户指定的长、宽、裁剪点 将图片中多余的部分裁掉 c_crop

**参数说明**

| 参数名 | 含义 | 值范围 |
| ------ | -------------------- | ----------------- |
| w | 目标图像宽 | 整数数字 (1-10000)：直接指定目标图像的宽，单位：像素。 小数数字 (0.001-7.999)：指定目标图像的宽度为原图的w倍。 不指定：按照其他参考项等比缩放 |
| h | 目标图像高 | 整数数字 (1-10000)：直接指定目标图像的宽，单位：像素。 小数数字 (0.001-7.999)：指定目标图像的宽度为原图的w倍。 不指定：按照其他参考项等比缩放 |
| px | 裁剪参考点横坐标 | 整数，表示 (px, py) 为左上角坐标，裁掉超过 长、宽的部分 小数，表示原图宽度 * 该百分比 作为 px l - 左边对齐裁剪 r - 右边对齐裁剪 |
| y | 裁剪参考点纵坐标 | 整数，表示 (px, py) 为左上角坐标，裁掉超过 长、宽的部分 小数，表示原图宽度 * 该百分比 作为 py l - 左边对齐裁剪 r - 右边对齐裁剪 |

**样例**

* 原图

![img](https://p0.qhimg.com/t011637e00e55ca96e1.jpg)

* 将原图裁剪为 100 * 100，左上角 为原点，偏移 50, 50

```text
/c_crop,px_100,py_133,w_50,h_50
```

![img](https://p0.qhimg.com/t0116498a6d517f004c.jpg)

* 将原图裁剪为 100*100， 右下角对齐

```
/c_crop,px_r,py_b,w_100,h_100
```

![img](https://p0.qhimg.com/t01685595f3d3fc0456.jpg)

**3.旋转**

**参数说明**

| 参数名 | 含义 | 值范围 |
| ------ | ------------ | ------|
| d | 旋转角度 | 整数/小数 (-360.0 - 360.0) 表示顺时针旋转的角度。负数表示逆时针旋转 auto 表示根据 EXIF 信息（如有）自动旋转 |
| f | 旋转后填充色 | 000000 - 999999 RGB 色号 alpha ： 透明，仅限支持透明通道的图片 |

**样例**

* 原图

![img](https://p0.qhimg.com/t011637e00e55ca96e1.jpg)

* 将图片顺时针旋转 30度，红色填充底色

```
/c_rotate,d_30,f_FF0000
```

![img](https://p0.qhimg.com/t01273e68d9014354ad.jpg)

* 按照用户指定的旋转角度，对图片进行旋转，返回旋转后的图片。特别的，EXIF中的旋转属性会自动应用到原始图片

**4.填充**

* 根据用户指定的填充颜色、填充范围，对图片进行一次填充，原图覆盖于填充色之上。

**参数说明**

| 参数名 | 含义         | 值范围                   |
| ------ | ------------ | ------------------------ |
| w      | 目标宽度     | 与“缩放”功能中的 w 相同  |
| h      | 目标高度     | 与“缩放”功能中的 w 相同  |
| px     | 参考点横坐标 | 与“裁剪”功能中的 px 相同 |
| py     | 参考点纵坐标 | 与“裁剪”功能中的 px 相同 |
| f      | 填充色       | 与“旋转”功能中的f相同    |

**样例**

* 原图

![img](https://p0.qhimg.com/t011637e00e55ca96e1.jpg)

* 图片扩大到 250*250 用红色填充四周

```
/c_pad,f_FF0000,w_250,h_250
```

![img](https://p0.qhimg.com/t010e6535c1da646da3.jpg)

* 图片扩大到 250*250 用红色填充四周，左上角对齐

```
/c_pad,f_FF0000,w_250,h_250,px_l,py_t
```

![img](https://p0.qhimg.com/t01f07c40196f5f7f8a.jpg)

**5.格式转换**

* 将图片转为用户指定的格式并输出

**参数说明**

| 参数名 | 含义 | 值范围 |
| ------ | ------------- | -------- |
| f | 目标格式 | png, bmp, ico, jpg, jpeg, gif |
| s | 是否强制转换 当启用强制转换时，动图转换为不支持动图的格式，会默认取第一帧 | 0 / 1 |

**样例**

* 原图

![img](https://p0.qhimg.com/t011637e00e55ca96e1.jpg)

* 将图片转换为 bmp 格式

```/c_fmt,f_bmp ```

![img](https://p0.qhimg.com/t011637e00e55ca96e1.bmp)

**6.质量调整**

* 对图片质量进行调整（通常是降低质量）

**参数说明**

| 参数名 | 含义         | 值范围        |
| ------ | -------------- | --------- |
| f      | 图片质量百分比 | 20-100，整数，通常越接近100 质量越好，图片体积越大 |

**样例**

* 原图
![img](https://p0.qhimg.com/t011637e00e55ca96e1.jpg)

* 将图像质量调整为 20

```/c_quality,q_20 ```

![img](https://p0.qhimg.com/t0105f00fbd8508aef7.jpg)

**7.抽帧**

* 对于多帧动画图片，抽取特定的1帧或多帧

**参数说明**

| 参数名 | 含义           | 值范围                   |
| ------ | -------------- | ----------------------- |
| n      | 指定第n帧    | 整数，当给负值时表示倒数第n帧 |
| f      | 起始帧（包含）| 取值范围、用法与参数n相同   |
| t      | 终止帧（包含） | 取值范围、用法与参数n相同    |

**参数优先级与冲突**

n 存在时 f，t 不生效

**样例**

* 原图 （图像版权归原作者所有）

![img](https://p0.qhimg.com/t010129f5c24f805e8e.gif)

* 取第5帧 （图像版权归原作者所有）

```
/c_idx,n_5 
```

![img](https://p0.qhimg.com/t012697ebd903bee996.gif)

* 取第5-10帧

```
/c_idx,f_5,t_10
```

![img](https://p0.qhimg.com/t01a0281031c354cfc0.gif)

AI大模型

AI平台

AI应用

视频

物联网

数据上云

IoT设备

账号体系

智慧城市

电商视频解决方案

教育

全屋智能

医疗

智能制造

游戏

图片处理

产品简介

产品介绍

API文档

API文档

电话咨询：

服务咨询

建议反馈

产品与服务

文档与社区

关于我们

关注我们

请您联系我们

小安提醒您

1对1免费咨询智汇云专属顾问

为您量身定制产品解决方案

AI大模型

AI平台

AI应用

视频

物联网

数据上云

IoT设备

账号体系

智慧城市

电商视频解决方案

教育

全屋智能

医疗

智能制造

游戏

图片处理

产品简介

产品介绍

API文档

API文档

电话咨询：

服务咨询

建议反馈

产品与服务

文档与社区

关于我们

关注我们

请您联系我们

小安提醒您

1对1免费 咨询智汇云专属顾问

为您量身定制产品解决方案

1对1免费咨询智汇云专属顾问