参数名	类型	必填	说明	示例
key	string	是	接口调用密钥
imgurl	string	是	图片链接	https://ts3.tc.mm.bing.net/th/id/OIP-C.UWZMQfqSbLE8bXeqzzdkAQHaKl
radius	string	否	控制素描的线条深浅 / 绘画深度默认20	20
sigma	string	否	控制厚薄 / 量化粒度，影响画面的颗粒感默认20	20

图片素描

接口说明

该接口接收一张图片链接，利用算法将其转换为素描风格并直接返回处理后的图像。此功能适用于需要快速获取图片线稿或艺术化处理的场景。

调用地址

/api/content/sketch.php

请求方式

GET

鉴权说明

必须携带密钥。采用 Query 方式传递，将密钥赋值给参数 key，拼接到请求 URL 中。

请求参数

参数名	类型	必填	说明
key	string	是	接口调用密钥，通过 Query 参数传递。
imgurl	string	是	待处理的图片 URL 链接。需为可公开访问的有效图片地址。
radius	string	否	控制素描线条深浅及绘画深度。默认值为 20。
sigma	string	否	控制画面厚薄及量化粒度，影响颗粒感。默认值为 20。

成功响应示例

请求成功时，服务器直接返回经过素描处理后的图片数据。浏览器或客户端可直接渲染该响应内容，无需解析额外的 JSON 结构。

HTTP/1.1 200 OK
Content-Type: image/png
Cache-Control: public, max-age=3600

响应体为标准的 PNG 图片流，包含根据 radius 和 sigma 参数生成的素描效果图像。

响应字段说明

由于该接口直接返回二进制图片流，不存在传统的 JSON 字段定义。响应状态与内容说明如下：

项目	说明
状态码	`200 OK` 表示处理成功；非 200 状态码表示处理失败或参数错误。
Content-Type	固定为 `image/png`，客户端需按图像格式解析响应体。
响应内容	二进制图片流，即经过素描算法处理后的最终图像数据。
缓存策略	响应头包含缓存控制信息，客户端可依据 `Cache-Control` 进行本地缓存。

注意：若请求参数缺失（如 key 或 imgurl）或图片链接无效，接口将不会返回图片流，而是返回具体的错误提示信息或错误状态码。

错误响应示例

{
    "code": 0,
    "msg": "密钥错误",
    "errcode": 11002
}

业务错误码说明

调用本接口时，若发生鉴权、权限、计费或系统异常，响应体中的 errcode 字段将返回以下业务错误码。请根据具体错误码排查请求参数、密钥状态及账户积分余额。

错误码	含义	说明与建议
11001	未提供调用密钥	请求参数中缺少 `key` 字段，请补充完整的调用密钥。
11002	密钥错误	提供的密钥格式不正确或与系统记录不符，请核对密钥拼写。
11003	密钥已禁用	该密钥已被管理员手动禁用，请联系管理员恢复或更换密钥。
11004	积分余额不足	账户积分不足以支付本次调用费用，请充值或检查计费配置。
11005	请求过于频繁	触发 QPM（每分钟请求数）限制，请降低请求频率或增加重试间隔。
11006	接口维护中	服务端正在进行临时维护，请稍后重试。
11007	接口已禁用	该功能接口已被全局禁用，无法调用。
11008	接口不可用	接口当前处于不可用状态，可能由于后端服务异常。
11009	密钥校验暂不可用	密钥校验服务暂时中断，非密钥本身错误，请稍后重试。
11010	积分系统暂不可用	积分查询或扣除服务暂时中断，请稍后重试。
11011	收费接口须提供有效密钥	当前接口为收费接口，必须携带有效密钥且账户有足够积分。
11012	鉴权方式错误	密钥传递方式不符合要求（如应使用 Query 参数但使用了 Header）。
11013	接口不存在	请求的 API 路径错误，或该接口尚未上线。
11014	***地址无效	指定的图片链接 `imgurl` 格式错误或无法解析。
11015	***地址不允许	指定的图片链接来源不在允许访问的域名白名单内。
11016	***请求失败	获取源图片数据失败，请检查链接有效性或网络连通性。
11017	服务暂不可用	内部图像处理服务暂时过载或异常，请稍后重试。
11018	请求方式不允许	使用了错误的 HTTP 方法（本接口仅支持 GET）。
11019	当前IP不在白名单内	调用方 IP 地址不在允许访问的白名单列表中。
11020	启用出口代理须提供有效密钥	在代理模式下调用，但未提供有效的调用密钥。
11021	未配置可用出口代理	系统未配置可用的出口代理节点，无法发起请求。
11022	出口代理不可用	配置的出口代理服务当前状态异常或不可达。
11023	密钥已过期	提供的密钥超过有效期限，请重新生成或更新密钥。
11024	令牌分配积分不足	针对特定令牌分配的积分额度耗尽，请调整分配策略或充值。

调用示例

终端 curl（bash）

curl "https://your-domain.com/api/content/sketch.php?key=YOUR_KEY&imgurl=https://ts3.tc.mm.bing.net/th/id/OIP-C.UWZMQfqSbLE8bXeqzzdkAQHaKl"

PHP

// PHP
$key = 'YOUR_KEY';
$imgurl = 'https://ts3.tc.mm.bing.net/th/id/OIP-C.UWZMQfqSbLE8bXeqzzdkAQHaKl';
$url = "https://your-domain.com/api/content/sketch.php?key=" . urlencode($key) . "&imgurl=" . urlencode($imgurl);
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);
echo $response;

注意事项

密钥安全保管
- 调用密钥（key）是访问本接口的唯一凭证，请妥善保存在服务端环境变量或安全配置中心。
- 严禁将密钥硬编码在前端代码、移动端安装包或公开仓库中。由于本接口通过 GET 请求传输参数，密钥会直接暴露在 URL 查询字符串中，若在前端直接调用，极易被逆向或抓包窃取。建议通过后端服务中转，由后端持有密钥并向下属客户端提供代理或仅返回最终图片地址。
频率限制合规
- 本接口限频为每分钟约 60 次。高频调用不仅会被服务方拦截，还可能触发 IP 临时封禁。
- 建议在客户端或服务端实现请求队列或节流机制（Throttling），将瞬时并发请求平滑分散至时间窗口内。若业务需要批量处理图片，应严格控制并发连接数，并预留失败重试间隔。
参数取值规范
- imgurl 必须为有效 HTTPS 链接：确保传入的图片 URL 可被公网直接访问，且协议正确。若使用 HTTP 链接，部分网络环境下的混合内容（Mixed Content）策略可能阻断请求。
- radius 与 sigma 参数调整：
  - radius 默认值为 20，控制线条深浅。数值越大，线条越粗且对比度越强；数值过小可能导致素描细节丢失。
  - sigma 默认值为 20，控制量化粒度。数值越大，画面颗粒感越明显；数值过小则画面趋于平滑。
  - 这两个参数均为字符串类型，但在传入时建议确保为纯数字字符串，避免包含空格或特殊字符导致解析异常。
  - 若未指定参数，服务端将采用默认值。根据视觉反馈微调这两个参数时，建议先以默认值测试，再逐步调整以获得最佳视觉效果。
响应内容处理
- 本接口返回的是直接显示的图片（通常 MIME 类型为 image/jpeg 或 image/png，具体取决于服务端处理）。
- 客户端在接收响应时，不应按 JSON 格式解析。应检查 HTTP 状态码：
  - 200 OK：成功获取图片，可直接用于 `` 标签显示或保存至本地。
  - 4xx 或 5xx：表示请求参数错误、密钥无效或服务端内部异常。此时需检查 key 是否正确、imgurl 是否可访问，以及是否触发频率限制。
图片大小与格式限制
- 虽然接口未明确列出图片尺寸上限，但过大的原图（如超过 10MB）可能导致处理时间过长，触发网关超时或响应中断。
- 建议对上传的 imgurl 指向的图片进行预处理，确保其为常见主流格式（JPG, PNG, WebP 等），且分辨率适中。若图片文件过大，可预先压缩或缩略图化处理后再调用本接口。
HTTPS 强制推荐
- 所有调用应通过 HTTPS 进行。明文 HTTP 请求不仅存在密钥泄露风险，还可能导致浏览器安全策略拦截图片加载。确保调用地址前缀为 https://。

免责声明

欢迎使用 万象数据API（以下简称“本平台”，域名为 api.vsaa.cn）。在使用本平台提供的任何接口、数据及相关服务之前，请您务必仔细阅读并充分理解本免责声明的全部内容。您对本平台任何服务的使用，均视为您已阅读、理解并同意本声明的全部条款。

1. 本平台仅提供**技术接口与数据聚合服务**，不存储、不生产、不拥有任何原始数据内容。 2. 本平台所返回的数据均来源于公开网络或第三方接口，仅作**技术学习、研究与交流**之用。 3. 本平台不保证任何接口的**持续可用性、准确性、完整性或及时性**，接口可能因第三方原因随时变更、中断或停止。 1. 使用者应遵守中华人民共和国相关法律法规，以及其所在地的所有适用法律。 2. **禁止**将本平台接口用于任何违法违规用途，包括但不限于： - 侵犯他人知识产权、隐私权或其他合法权益； - 从事网络攻击、数据爬取滥用、恶意刷量等行为； - 传播违法、有害、虚假或不良信息； - 用于任何商业转售、二次分发而未获授权的情形。 3. 使用者应自行承担因使用本平台服务而产生的一切后果与法律责任。 1. 本平台**不收集、不存储**使用者的个人敏感信息。 2. 使用者通过接口提交的查询参数，仅用于当次请求处理，不做持久化留存。 3. 若接口涉及第三方数据，其版权与解释权归原数据方所有，本平台不承担相关争议责任。 1. 本平台以**“现状”**和**“现有”**为基础提供服务，不对服务作出任何明示或暗示的担保。 2. 因使用或无法使用本平台服务而导致的任何**直接、间接、偶然或必然损失**，本平台及其运营者均不承担任何责任。 3. 因不可抗力、网络故障、第三方服务中断、政策调整等原因导致的服务异常，本平台不承担责任。 1. 本平台的接口设计、文档、代码及相关标识，其知识产权归本平台所有。 2. 未经书面许可，任何单位或个人不得复制、修改、传播或用于商业用途。 1. 本平台有权随时修改本免责声明，修改后的内容将在本页面公布，不再另行通知。 2. 使用者应定期查阅本声明，继续使用即视为接受变更后的条款。 1. 本声明的最终解释权归 **万象数据API** 所有。 2. 如您不同意本声明的任何内容，请立即停止使用本平台服务。 3. 如因本声明产生争议，双方应友好协商解决；协商不成的，可提交本平台运营者所在地有管辖权的人民法院裁决。

最后更新日期：2026年10月6日

图片素描

接口信息

请求参数

返回示例

详细文档

图片素描

接口说明

调用地址

请求方式

鉴权说明

请求参数

成功响应示例

响应字段说明

错误响应示例

业务错误码说明

调用示例

终端 curl（bash）

PHP

注意事项

快速上手

在线测试

接口反馈

免责声明

免责声明

推荐接口

whois查询