图片水印裁剪缩略接口实战：用图片 URL 直接生成缩略图（1-8 接入点）
# 图片水印裁剪缩略接口实战：用图片 URL 直接生成缩略图（1-8 接入点）
> 接口/接入点：图片水印裁剪缩略接口（apiCode=1）· 1-8 生成缩略图-URL · 是否免费：免费 · 请求方式：POST/GET · 返回格式：JSON · 适用人群：后端、全栈 · 阅读时间：5 分钟
## 核心要点
- 1-8 直接吃「网络图片 URL」，不用先把图下载到本地再上传，省一步。
- `src_img_url`（图片地址，**必填，≤5M**）与 `type`（size/rate，**必填**）都要传。
- 适合图已在对象存储/CDN 上的场景，如电商图、用户头像远程地址。
## Why：为什么用 URL 版
图片本就在公网（OSS、COS、CDN），如果走文件版，得先下载→再上传，白白多两跳流量。1-8 把 URL 直接丢给接口，它自己拉图处理，调用方最省事。
## What：参数速览
| 参数 | 必填 | 说明 |
|------|------|------|
| `src_img_url` | 是 | 图片 URL，最大不超 5M |
| `type` | 是 | `size`（尺寸缩略）/ `rate`（比率缩略） |
| `width` | 否 | type=size 时生效 |
| `height` | 否 | type=size 时生效 |
| `keepRate` | 否 | type=size 时是否保持比例，1/0 |
| `rate` | 否 | type=rate 时生效，0~1 |
## How：按 60% 比率缩
**Python（requests）**
```python
import requests
url = "https://route.showapi.com/1-8"
data = {
"type": "rate",
"rate": "0.6",
"src_img_url": "https://example.com/big.jpg",
}
r = requests.post(url, params={"appKey": "YOUR_APPKEY"}, data=data, timeout=10)
body = r.json()["showapi_res_body"]
if str(body.get("ret_code")) == "0":
print("缩略图:", body["des_pic_url"])
else:
print("失败", body.get("ret_code"), r.json().get("showapi_res_error"))
```
**cURL**
```bash
curl -X POST "https://route.showapi.com/1-8?appKey=YOUR_APPKEY" \
-H "content-type: application/x-www-form-urlencoded" \
--data-urlencode "type=rate" --data-urlencode "rate=0.6" \
--data-urlencode "src_img_url=https://example.com/big.jpg"
```
**Node.js（fetch）**
```javascript
const body = new URLSearchParams({ type:"rate", rate:"0.6", src_img_url:"https://example.com/big.jpg" });
const b = (await (await fetch("https://route.showapi.com/1-8?appKey=YOUR_APPKEY",{method:"POST",body})).json()).showapi_res_body;
if (String(b.ret_code) === "0") console.log("缩略图:", b.des_pic_url);
```
## 返回示例
```json
{
"showapi_res_body": {
"ret_code": 0,
"des_pic_url": "http://app1.showapi.com/temp/1.jpg"
}
}
```
## 进阶/边界
- `src_img_url` 最大 5M，超限会失败；超大图请先在自己侧压缩再传，或用文件版 1-1。
- URL 需公网可访问；鉴权/私有权限图先下载转 base64（见[base64 选型篇](https://www.showapi.com/guides/base64-vs-file-1)）。
- 批量远程图处理注意限流，见[频率控制篇](https://www.showapi.com/guides/image-process-ratelimit-1)。
## FAQ
**Q1：只传 URL 不传 type 报错？** 1-8 要求 `src_img_url` 与 `type` 都必填，漏 `type` 会失败。
**Q2：URL 图片要带鉴权？** 文档未支持，按公网可访问地址使用。
**Q3：返回 ret_code 是数字还是字符串？** 1-8 示例为 Number `0`，判断时统一转字符串比较最稳。
**Q4：和水印能一起做吗？** 1-8 只缩略；要加水印请对结果图再调 1-2/1-3。
## 相关能力 / 下一步阅读
- [图片水印裁剪缩略接口：base64 与文件上传两种入参怎么选](https://www.showapi.com/guides/base64-vs-file-1)
- [图片水印裁剪缩略接口：免费档位限制与频率控制，如何避免触发限流](https://www.showapi.com/guides/image-process-ratelimit-1)
- **本系列共 13 篇**：查看[图片水印裁剪缩略接口指南总目录](https://www.showapi.com/guides/image-process-guides-1)
