# Generated by ShowAPI OpenAPI generator # source: market/1 # generated-at: 2026-07-29T10:30:47.997Z openapi: 3.0.3 info: title: 图片水印裁剪缩略接口 description: 图片水印裁剪缩略api是一个全功能的图像处理服务，能够快速生成缩略图、裁剪图片以及添加水印，满足您的多样化图像处理需求。简单易用的接口设计，让您轻松实现专业级的图像处理效果。 termsOfService: https://www.showapi.com/helpcenter/view#/4019/2 version: 1.0.0 servers: - url: https://route.showapi.com paths: /1-8: x-pointCode: 8 x-mode: mapping x-read-timeout: 15 x-connect-timeout: 10 post: summary: 生成缩略图-URL description: 生成缩略图服务能够根据您传入的比率要求，将原始图片智能地缩减到指定的大小，从而快速创建出缩略图版本。广泛应用于网页设计、图像分享和数据库管理中。 responses: "200": description: 成功响应 content: application/json: schema: allOf: - $ref: "#/components/schemas/ShowapiResEnvelope" - type: object properties: showapi_res_body: type: object properties: des_pic_url: type: string description: 生成的图片地址 ret_code: type: number description: 0表示调用成功 description: 业务返回体 operationId: 1_8_POST parameters: [] requestBody: content: application/x-www-form-urlencoded: schema: type: object properties: width: type: string description: 裁剪后的宽度 height: type: string description: 裁剪后的高度 keepRate: type: string description: 当type=size时有效。是否保持高宽比,1为保持，0为不保持 rate: type: string description: 当type=rate时，此值才有效，指的是缩小比率。其值为0到1之间的一个小数。 src_img_url: type: string description: 图片URL，最大不要超过5M type: type: string description: type=size为尺寸缩略，br type=rate为比率缩略。 required: - src_img_url - type /1-5: x-pointCode: 5 x-mode: mapping x-read-timeout: 15 x-connect-timeout: 10 post: summary: 生成缩略图-base64 description: 生成缩略图服务能够根据您传入的比率要求，将原始图片智能地缩减到指定的大小，从而快速创建出缩略图版本。广泛应用于网页设计、图像分享和数据库管理中。 responses: "200": description: 成功响应 content: application/json: schema: allOf: - $ref: "#/components/schemas/ShowapiResEnvelope" - type: object properties: showapi_res_body: type: object properties: des_pic_url: type: string description: 生成的图片地址 description: 业务返回体 operationId: 1_5_POST parameters: [] requestBody: content: application/x-www-form-urlencoded: schema: type: object properties: type: type: string description: type=size为尺寸缩略，br type=rate为比率缩略。 src_img_base64: type: string minLength: 20 maxLength: 10500000 description: 图片文件的base64格式字符串。 height: type: string description: 缩略图高度，单位px，正整数 width: type: string description: 缩略图宽度，单位px,，正整数 keepRate: type: string description: 当type=size时有效。br/是否保持高宽比,1为保持，0为不保持 rate: type: string description: 当type=rate时，此值才有效，指的是缩小比率。其值为0到1之间的一个小数。 required: - type - src_img_base64 /1-4: x-pointCode: 4 x-mode: mapping x-read-timeout: 15 x-connect-timeout: 10 post: summary: 图像裁剪-base64 description: 提供了一种方便快捷的方式来裁剪原始图像的特定区域。通过这一服务，您可以轻松地从原始图片中提取出您感兴趣的部分，以便于更好地展示或应用于不同的场合。 responses: "200": description: 成功响应 content: application/json: schema: allOf: - $ref: "#/components/schemas/ShowapiResEnvelope" - type: object properties: showapi_res_body: type: object properties: des_pic_url: type: string description: 裁剪后的图片地址 description: 业务返回体 operationId: 1_4_POST parameters: [] requestBody: content: application/x-www-form-urlencoded: schema: type: object properties: width: type: string description: 裁剪后的宽度 height: type: string description: 裁剪后的高度 x: type: string description: 从x轴哪个座标点开始 y: type: string description: 从y轴哪个座标点开始 src_img_base64: type: string minLength: 20 maxLength: 10000000 description: 原图的base64格式字符串。 required: - width - height - src_img_base64 /1-3: x-pointCode: 3 x-mode: mapping x-read-timeout: 10 x-connect-timeout: 10 post: summary: 添加图片水印-base64 description: 传入底板图及水印图，根据位置参数，接口把水印图添加到底板图上。 responses: "200": description: 成功响应 content: application/json: schema: allOf: - $ref: "#/components/schemas/ShowapiResEnvelope" - type: object properties: showapi_res_body: type: object properties: des_pic_url: type: string description: 合成后的图片地址 description: 业务返回体 operationId: 1_3_POST parameters: [] requestBody: content: application/x-www-form-urlencoded: schema: type: object properties: src_img_base64: type: string minLength: 1 maxLength: 10000000 description: 底板图的base64格式字符串。 logo_img_base64: type: string minLength: 1 maxLength: 10000000 description: 水印图的base64格式字符串。 position: type: string description: 水印在底图的位置。可以为这些参数：NorthWest North NorthEast West Center East SouthWest South SouthEast/默认值在右下角。 xy: type: string description: 比如+5+10表示水印的下边缘距原始图片10像素、右边缘距原始图片5像素 required: - src_img_base64 - logo_img_base64 /1-2: x-pointCode: 2 x-mode: mapping x-read-timeout: 15 x-connect-timeout: 10 post: summary: 添加图片水印 description: 传入底板图及水印图，根据位置参数，接口把水印图添加到底板图上。 responses: "200": description: 成功响应 content: application/json: schema: allOf: - $ref: "#/components/schemas/ShowapiResEnvelope" - type: object properties: showapi_res_body: type: object properties: des_pic_url: type: string description: 合成后的图片地址 ret_code: type: string description: 0为成功，其他失败 description: 业务返回体 operationId: 1_2_POST parameters: [] requestBody: content: multipart/form-data: schema: type: object properties: src_img: type: string format: binary description: 底图文件 logo_img: type: string format: binary description: logo图文件 position: type: string description: 水印在底图的位置。可以为这些参数：NorthWest North NorthEast West Center East SouthWest South SouthEast/默认值在右下角。 xy: type: string description: 比如+5+10表示水印的下边缘距原始图片10像素、右边缘距原始图片5像素 required: - src_img - logo_img /1-1: x-pointCode: 1 x-mode: mapping x-read-timeout: 10 x-connect-timeout: 5 post: summary: 生成缩略图 description: 我们的生成缩略图服务为您提供了一种高效便捷的方式，可以将原始图片按照您设定的比例转化为缩略图。这一服务特别适用于需要预览或节省存储空间的场景，例如社交媒体分享、网页设计、图片库管理等。 responses: "200": description: 成功响应 content: application/json: schema: allOf: - $ref: "#/components/schemas/ShowapiResEnvelope" - type: object properties: showapi_res_body: type: object properties: des_pic_url: type: string description: 生成的图片地址 ret_code: type: string description: 0为成功，其他失败 description: 业务返回体 operationId: 1_1_POST parameters: [] requestBody: content: multipart/form-data: schema: type: object properties: type: type: string description: type=size为尺寸缩略，br type=rate为比率缩略。 src_img: type: string format: binary description: 以文件形式（ multipart/form-data）上传的表单字段 height: type: string description: 缩略图高度，单位px，正整数 width: type: string description: 缩略图宽度，单位px,，正整数 keepRate: type: string description: 当type=size时有效。br/是否保持高宽比,1为保持，0为不保持 rate: type: string description: 当type=rate时，此值才有效，指的是缩小比率。其值为0到1之间的一个小数。 required: - type - src_img components: securitySchemes: AppKeyAuth: type: apiKey in: query name: appKey description: 从 ShowAPI 控制台获取的 appKey，管理地址：https://www.showapi.com/console#/myApp schemas: ShowapiResEnvelope: type: object description: ShowAPI 统一返回包裹（业务数据位于 showapi_res_body） properties: showapi_res_code: type: integer description: API 返回的状态码 showapi_res_error: type: string description: API 返回的错误信息 showapi_res_id: type: string description: API 请求的唯一标识 showapi_fee_num: type: integer description: API 调用计费次数 security: - AppKeyAuth: [] externalDocs: url: https://www.showapi.com/apiGateway/view/1?tab=book x-apiCode: "1" x-is-own: false x-is-op: false