# 文字转图片

**请求方式：** GET

**接口地址：** https://api.aiys.net/api/text2img

**接口描述：** 将文字转成图片

## 请求参数

| 参数名 | 可传值说明 | 传入位置 | 是否必填 | 示例值 | 默认值 | 参数说明 |
|--------|----------|----------|----------|--------|--------|----------|
| text | 字符串 | query | 可选 | — | — | 说明：指定要生成图片的文字内容，将文字转换成图片<br><br>支持：\n、\|、<br>、JSON数组格式<br><br>默认值：默认文字 |
| size | 整数 | query | 可选 | — | — | 说明：设置文字初始字体大小（单位px）<br><br>默认值：80<br><br>备注：开启 autosize 时会自动缩小适配画布 |
| angle | 整数 | query | 可选 | — | — | 说明：设置文字旋转角度（单位：度）<br><br>默认值：0 |
| w | 整数 | query | 可选 | — | — | 说明：设置图片宽度（单位px）<br><br>备注：可单独传入，系统自动计算高度 |
| h | 整数 | query | 可选 | — | — | 说明：设置图片高度（单位px）<br><br>备注：可单独传入，系统自动计算宽度 |
| bgimg | 字符串（URL） | query | 可选 | — | — | 说明：设置背景图片直链地址（支持http/https）<br><br>默认值：无 |
| fit | 字符串 | query | 可选 | — | — | 可选值：<br>cover：填满画布，可能裁剪（默认）<br>contain：完整显示，可能留白<br>默认值：cover |
| bg | 字符串（颜色值） | query | 可选 | — | — | 说明：设置背景颜色（支持十六进制）<br><br>示例：000000<br><br>默认值：transparent（透明） |
| color | 字符串（颜色值） | query | 可选 | — | — | 说明：设置文字颜色（支持十六进制）<br>默认值：ffffff |
| stroke | 字符串（颜色值） | query | 可选 | — | — | 说明：设置文字描边颜色<br><br>默认值：无 |
| strokew | 整数 | query | 可选 | — | — | 设置文字描边宽度（单位px）<br>默认值：0 |
| shadow | 字符串（颜色值） | query | 可选 | — | — | 说明：设置文字阴影颜色<br><br>默认值：无 |
| shadowx | 整数 | query | 可选 | — | — | 说明：设置文字阴影横向偏移量（单位px）<br><br>默认值：3 |
| shadowy | 整数 | query | 可选 | — | — | 说明：设置文字阴影纵向偏移量（单位px）<br><br>默认值：3 |
| gradient | 字符串 | query | 可选 | — | — | 说明：设置文字渐变颜色，格式为 颜色1,颜色2<br><br>示例：#ff0000,#0000ff<br><br>默认值：无 |
| autosize | 整数 | query | 可选 | — | — | 说明：是否自动缩小文字以适配画布<br><br>可选值：<br><br>1：开启（默认）<br>0：关闭<br>默认值：1 |
| format | 字符串 | query | 可选 | — | — | 说明：设置输出图片格式<br><br>可选值：<br><br>png（默认）<br>webp<br>默认值：png |

## 返回示例

```json
<p><img src="../../api/text2img/?text=Aiys.Net&amp;color=000000" alt="">
```