GET
图片处理
图片转圆形
把图片裁成圆形（做头像用），支持指定直径。
累计调用 14
今日调用 0
更新于 2026-10-16
调用地址
GET
https://itapi.top/api/imgcircle
请求参数
| 参数名 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|
| url | string | 必填 | 图片链接，或 data:image/...;base64,... | https://itapi.top/og.png |
| image | string | 可选 | 图片的 base64（与 url 二选一，可带 data:image 前缀） | https://itapi.top/og.png |
| size | int | 可选 | 直径，留空取短边 | 10 |
| img | int | 可选 | 传 1 直接输出图片二进制 | 1 |
| raw | string | 可选 | img 的别名，传 1 效果相同 | 1 |
返回字段
| 字段名 | 类型 | 说明 |
|---|---|---|
| code | int | 状态码 |
| data.image | string | data URI（可直接放 img src） |
| data.format | string | 图片格式 |
| data.size | int | 直径 |
响应示例
200 OK
{"code":200,"msg":"success","data":{"size":20,"image":"data:image\/png;base64,iVBORw0KGgoAAAANSUhEUgAAABQAAAAUCAYAAACNiR0NAAAACXBIWXMAAA7EAAAOxAGVKw4bAAABX0lEQVQ4jZ2Uz8qCQBTFz+hO8g8GQpsIewUXImZIREIEEb2Hy56nx2on7nShLYbARcy3UjRnRvkOuLjnzv3NGWUEJFosFqx9Ho8HY4yxNE2ZbEaRgfrebrcDAMRxzO23Ir8g3iJVVZHnOQzDwPv9xmazwff77fqU0o7TJRTBAMDzPBiGAQCwLAue541ONALKdDweB\/XpdBKuVabS8YC\/dZ9BpoDL5RJZlo387XaLsiwHHqWUKFPpDofDrNRtsMl3mCQJ1z+fz1yfyBKqqoosy2BZ1qj3+XywXq\/RNM3AlyYMgoALAwBN0xDH8ciXAq\/Xq6yNy+Uy8oRHJoTg9XphtVoJgVVVwXXdwa1R+temL9\/3pTAAsG0bYRh2NaWUCI98v9+lsFa3243f6P+qTNNkRVGwOSqKgum6Lr\/L+\/0ejuPMSug4DqIokqd8Pp+z0rWa3LWu63+DuF+4lXCIEOHcHyxq6T0YjUAOAAAAAElFTkSuQmCC","format":"png"}}
在线测试
代码示例
cURL · GET
curl "https://itapi.top/api/imgcircle?url=https%3A%2F%2Fitapi.top%2Fog.png&image=https%3A%2F%2Fitapi.top%2Fog.png&size=10&img=1&raw=1"
PHP
<?php
$res = file_get_contents("https://itapi.top/api/imgcircle?url=https%3A%2F%2Fitapi.top%2Fog.png&image=https%3A%2F%2Fitapi.top%2Fog.png&size=10&img=1&raw=1");
$json = json_decode($res, true);
print_r($json);
JavaScript
const res = await fetch("https://itapi.top/api/imgcircle?url=https%3A%2F%2Fitapi.top%2Fog.png&image=https%3A%2F%2Fitapi.top%2Fog.png&size=10&img=1&raw=1");
const json = await res.json();
console.log(json);
Python
import requests
r = requests.get("https://itapi.top/api/imgcircle?url=https%3A%2F%2Fitapi.top%2Fog.png&image=https%3A%2F%2Fitapi.top%2Fog.png&size=10&img=1&raw=1", timeout=10)
print(r.json())