# API ????

> ????????????????????? API ???????????????????

- ?????50
- ?????JSON / ?? / JSON ?????????????
- ???????? JSON ???? URL??????? `url` ? `image_url` ??
- ????????? `x/y` ??????????????????????? `moves[].point` ? A1/H8 ??????

## 游戏互动

### 成语接龙

- ???`/openapi/cyjl`
- ???`GET`
- ???JSON

**????**

- msg 必填。开始：msg=开始成语接龙+一个汉字；接龙：msg=我接+成语。id 必填，使用中请勿修改，建议填用户 QQ。

**????**

```text
开始：https://ai.typh.top/openapi/cyjl?msg=开始成语接龙慕&id=2046893478
接龙：https://ai.typh.top/openapi/cyjl?msg=我接慕名而来&id=2046893478
```

**????**

```json
{"success":true,"action":"start","id":"2046893478","msg":"开始成语接龙慕","reply":"开始咯！请接以〖来〗字开头的成语。","idiom":{"word":"慕名而来","pinyin":"mù míng ér lái","meaning":"仰慕名声而来。"},"expected_char":"来","next_char":"","usage":{"start":"/openapi/cyjl?msg=开始成语接龙慕&id=用户QQ","answer":"/openapi/cyjl?msg=我接慕名而来&id=用户QQ"}}
```

> 说明：id 是接龙会话标识，同一局开始和接龙必须保持一致。

### 五子棋（图片版）

- ???`/openapi/wzq`
- ???`GET`
- ???JSON

**????**

- n：动作编号。1 创建房间；0 销毁房间；2 落子；3 初始化头像；4 查看棋盘；5 更新头像。
- qun：房间号，创建、销毁、落子、查看都要保持一致。
- q1：玩家 1 QQ，创建房间必填，五子棋中为黑棋。
- q2：玩家 2 QQ，创建房间必填，五子棋中为白棋。
- qq：当前落子玩家 QQ，落子时必填。
- x：落子横坐标，接口传数字，从 1 开始；图片上横轴显示 A-O，x=1 对应 A，x=8 对应 H。
- y：落子纵坐标，接口传数字，从 1 开始；图片左侧显示 1-15。

**????**

```text
创建：https://ai.typh.top/openapi/wzq?n=1&qun=10001&q1=10001&q2=10002
落子：https://ai.typh.top/openapi/wzq?n=2&qun=10001&qq=10001&x=8&y=8 （图片位置 H8）
查看：https://ai.typh.top/openapi/wzq?n=4&qun=10001
销毁：https://ai.typh.top/openapi/wzq?n=0&qun=10001
```

**????**

```json
{
  "success": true,
  "game": "[游戏标识：wzq / jzq / jzq_two]",
  "action": "[动作编号：1创建 / 2落子 / 4查看 / 0销毁]",
  "action_name": "[动作名称：create / move / view / destroy]",
  "message": "[本次操作结果提示]",
  "room_id": "[房间号 qun]",
  "players": {
    "black_or_x": "[玩家1 QQ]",
    "white_or_o": "[玩家2 QQ]"
  },
  "current_player": "[下一步该谁落子，返回 QQ]",
  "winner": "[获胜玩家 QQ；未获胜时为空字符串]",
  "board": "[棋盘数组，二维数组，每格是空字符串 / B / W / X / O]",
  "moves": "[落子记录数组，包含 qq、x、y、point、mark；point 例如 A1/H8]",
  "image": {
    "type": "image",
    "url": "[完整棋盘图片链接，例如：https://你的域名/static/generated/wzq_xxx.svg]"
  },
  "usage": {
    "create": "[创建房间链接]",
    "move": "[落子链接]",
    "view": "[查看棋盘链接]",
    "destroy": "[销毁房间链接]"
  }
}
```

> 15x15 棋盘，五子连珠获胜。 五子棋（图片版） n=1 创建，0 销毁，2 落子，4 查看；qun 房间；q1/q2 玩家；qq/x/y 落子

### 井字棋（图片版）

- ???`/openapi/jzq`
- ???`GET`
- ???JSON

**????**

- n：动作编号。1 创建房间；0 销毁房间；2 落子；3 初始化头像；4 查看棋盘；5 更新头像。
- qun：房间号，创建、销毁、落子、查看都要保持一致。
- q1：玩家 1 QQ，创建房间必填，井字棋中为 X。
- q2：玩家 2 QQ，创建房间必填，井字棋中为 O。
- qq：当前落子玩家 QQ，落子时必填。
- x：落子横坐标，接口传数字，从 1 开始；图片上横轴显示 A-C，x=1 对应 A。
- y：落子纵坐标，接口传数字，从 1 开始；图片左侧显示 1-3。

**????**

```text
创建：https://ai.typh.top/openapi/jzq?n=1&qun=10001&q1=10001&q2=10002
落子：https://ai.typh.top/openapi/jzq?n=2&qun=10001&qq=10001&x=2&y=2 （图片位置 B2）
查看：https://ai.typh.top/openapi/jzq?n=4&qun=10001
销毁：https://ai.typh.top/openapi/jzq?n=0&qun=10001
```

**????**

```json
{
  "success": true,
  "game": "[游戏标识：wzq / jzq / jzq_two]",
  "action": "[动作编号：1创建 / 2落子 / 4查看 / 0销毁]",
  "action_name": "[动作名称：create / move / view / destroy]",
  "message": "[本次操作结果提示]",
  "room_id": "[房间号 qun]",
  "players": {
    "black_or_x": "[玩家1 QQ]",
    "white_or_o": "[玩家2 QQ]"
  },
  "current_player": "[下一步该谁落子，返回 QQ]",
  "winner": "[获胜玩家 QQ；未获胜时为空字符串]",
  "board": "[棋盘数组，二维数组，每格是空字符串 / B / W / X / O]",
  "moves": "[落子记录数组，包含 qq、x、y、point、mark；point 例如 A1/H8]",
  "image": {
    "type": "image",
    "url": "[完整棋盘图片链接，例如：https://你的域名/static/generated/wzq_xxx.svg]"
  },
  "usage": {
    "create": "[创建房间链接]",
    "move": "[落子链接]",
    "view": "[查看棋盘链接]",
    "destroy": "[销毁房间链接]"
  }
}
```

> 3x3 井字棋。 井字棋（图片版） n=1 创建，0 销毁，2 落子，4 查看；qun 房间；q1/q2 玩家；qq/x/y 落子

### 井字棋（三子版）

- ???`/openapi/jzq_two`
- ???`GET`
- ???JSON

**????**

- n：动作编号。1 创建房间；0 销毁房间；2 落子；3 初始化头像；4 查看棋盘；5 更新头像。
- qun：房间号，创建、销毁、落子、查看都要保持一致。
- q1：玩家 1 QQ，创建房间必填，三子版中为 X。
- q2：玩家 2 QQ，创建房间必填，三子版中为 O。
- qq：当前落子玩家 QQ，落子时必填。
- x：落子横坐标，接口传数字，从 1 开始；图片上横轴显示 A-C，x=1 对应 A。
- y：落子纵坐标，接口传数字，从 1 开始；图片左侧显示 1-3。
- 规则：每方最多保留 3 颗棋子，继续落子会移除该玩家最早的一颗棋子。

**????**

```text
创建：https://ai.typh.top/openapi/jzq_two?n=1&qun=10001&q1=10001&q2=10002
落子：https://ai.typh.top/openapi/jzq_two?n=2&qun=10001&qq=10001&x=2&y=2 （图片位置 B2）
查看：https://ai.typh.top/openapi/jzq_two?n=4&qun=10001
```

**????**

```json
{
  "success": true,
  "game": "[游戏标识：wzq / jzq / jzq_two]",
  "action": "[动作编号：1创建 / 2落子 / 4查看 / 0销毁]",
  "action_name": "[动作名称：create / move / view / destroy]",
  "message": "[本次操作结果提示]",
  "room_id": "[房间号 qun]",
  "players": {
    "black_or_x": "[玩家1 QQ]",
    "white_or_o": "[玩家2 QQ]"
  },
  "current_player": "[下一步该谁落子，返回 QQ]",
  "winner": "[获胜玩家 QQ；未获胜时为空字符串]",
  "board": "[棋盘数组，二维数组，每格是空字符串 / B / W / X / O]",
  "moves": "[落子记录数组，包含 qq、x、y、point、mark；point 例如 A1/H8]",
  "image": {
    "type": "image",
    "url": "[完整棋盘图片链接，例如：https://你的域名/static/generated/wzq_xxx.svg]"
  },
  "usage": {
    "create": "[创建房间链接]",
    "move": "[落子链接]",
    "view": "[查看棋盘链接]",
    "destroy": "[销毁房间链接]"
  }
}
```

> 第三颗后继续落子会移除该玩家最早棋子。 井字棋（三子版） 同井字棋；每方最多保留 3 颗棋子

### 漂流瓶（图片版）

- ???`/openapi/plp`
- ???`GET`
- ???JSON 图片链接

**????**

- n=1 扔一个，qq/txt 必填；n=2 捞一个

**????**

```text
https://ai.typh.top/openapi/plp?n=1&qq=2046893478&txt=今天也要开心
```

**????**

```json
{
  "code": 0,
  "success": true,
  "data": {
    "type": "image",
    "url": "[完整图片链接，例如：https://你的域名/static/generated/xxx.png]",
    "image_url": "[同 url，方便不同调用方读取]"
  }
}
```

> 返回图片或图片链接。 漂流瓶（图片版） n=1 扔一个，qq/txt 必填；n=2 捞一个

## 图片生成 / 图床

### QQ 头像互动表情

- ???`/openapi/qqface`
- ???`GET`
- ???JSON 图片链接

**????**

- qq：左侧/主 QQ。
- qq2：右侧/对手 QQ，可选；填写后自动生成双人 VS 圆头像。
- style：模板，可选 moyu/kiss/pat/work/wanted/boss/sleep/rich/angry/cute/vs/pk/cp。
- name：左侧昵称，可选。
- name2：右侧昵称，可选。

**????**

```text
https://ai.typh.top/openapi/qqface?qq=2046893478&style=rich&name=贪夜怕黑
https://ai.typh.top/openapi/qqface?qq=2046893478&qq2=10002&style=vs&name=贪夜怕黑&name2=对手
```

**????**

```json
{
  "code": 0,
  "success": true,
  "data": {
    "type": "image",
    "url": "[完整图片链接，例如：https://你的域名/static/generated/xxx.png]",
    "image_url": "[同 url，方便不同调用方读取]"
  }
}
```

> 返回图片链接，支持单人头像卡和双人 VS 圆头像。 QQ 头像互动表情 qq 必填；qq2 可选；style 可选 moyu/kiss/pat/work/wanted/boss/sleep/rich/angry/cute/vs/pk/cp；name/name2 可选

### 美女接口

- ???`/openapi/meinv`
- ???`GET`
- ???JSON 图片链接

**????**

- m 可选，表示图片风格或序号。

**????**

```text
https://ai.typh.top/openapi/meinv?m=1
```

**????**

```json
{
  "code": 0,
  "success": true,
  "data": {
    "type": "image",
    "url": "[完整图片链接，例如：https://你的域名/static/generated/xxx.png]",
    "image_url": "[同 url，方便不同调用方读取]"
  }
}
```

> 调用图片源并返回图片链接。 美女接口 m 可选

### 图片排行榜

- ???`/openapi/phb`
- ???`GET`
- ???JSON 图片链接

**????**

- n 排行标题；n1 排行数据；qun 群号

**????**

```text
https://ai.typh.top/openapi/phb?n=摸鱼排行榜&n1=小明|88,小红|76&qun=10001
```

**????**

```json
{
  "code": 0,
  "success": true,
  "data": {
    "type": "image",
    "url": "[完整图片链接，例如：https://你的域名/static/generated/xxx.png]",
    "image_url": "[同 url，方便不同调用方读取]"
  }
}
```

> 返回生成好的排行榜图片链接。 图片排行榜 n 排行标题；n1 排行数据；qun 群号

### 小人举牌

- ???`/openapi/xrjp`
- ???`GET`
- ???JSON 图片链接

**????**

- msg 文字

**????**

```text
https://ai.typh.top/openapi/xrjp?msg=你好呀
```

**????**

```json
{
  "code": 0,
  "success": true,
  "data": {
    "type": "image",
    "url": "[完整图片链接，例如：https://你的域名/static/generated/xxx.png]",
    "image_url": "[同 url，方便不同调用方读取]"
  }
}
```

> 返回生成好的举牌图片链接。 小人举牌 msg 文字

### 美女图片

- ???`/openapi/meitui`
- ???`GET`
- ???JSON 图片链接

**????**

- 无必填参数。

**????**

```text
https://ai.typh.top/openapi/meitui
```

**????**

```json
{
  "code": 0,
  "success": true,
  "data": {
    "type": "image",
    "url": "[完整图片链接，例如：https://你的域名/static/generated/xxx.png]",
    "image_url": "[同 url，方便不同调用方读取]"
  }
}
```

> 从旧图集随机返回图片链接。 美女图片 无

### cos图片

- ???`/openapi/cos`
- ???`GET`
- ???JSON 图片链接

**????**

- 无必填参数。

**????**

```text
https://ai.typh.top/openapi/cos
```

**????**

```json
{
  "code": 0,
  "success": true,
  "data": {
    "type": "image",
    "url": "[完整图片链接，例如：https://你的域名/static/generated/xxx.png]",
    "image_url": "[同 url，方便不同调用方读取]"
  }
}
```

> 这里的 cos 是 COS 主题图片，不是腾讯 COS 存储接口。

### 小猫举牌

- ???`/openapi/jupai`
- ???`GET`
- ???JSON 图片链接

**????**

- qq 必填，用 QQ 头像合成小猫举牌图。

**????**

```text
https://ai.typh.top/openapi/jupai?qq=2046893478
```

**????**

```json
{
  "code": 0,
  "success": true,
  "data": {
    "type": "image",
    "url": "[完整图片链接，例如：https://你的域名/static/generated/xxx.png]",
    "image_url": "[同 url，方便不同调用方读取]"
  }
}
```

> 返回生成好的举牌图片链接。 小猫举牌 qq QQ号；msg 可选文字

### 文字转图片

- ???`/openapi/twzsy`
- ???`GET`
- ???JSON 图片链接

**????**

- txt 必填，生成纯文字自适应图片。

**????**

```text
https://ai.typh.top/openapi/twzsy?txt=这是一段文字
```

**????**

```json
{
  "code": 0,
  "success": true,
  "data": {
    "type": "image",
    "url": "[完整图片链接，例如：https://你的域名/static/generated/xxx.png]",
    "image_url": "[同 url，方便不同调用方读取]"
  }
}
```

> 返回生成好的图片链接。 文字转图片 txt 文本

### 买家秀

- ???`/openapi/mjx`
- ???`GET`
- ???JSON 图片链接

**????**

- 无必填参数。

**????**

```text
https://ai.typh.top/openapi/mjx
```

**????**

```json
{
  "code": 0,
  "success": true,
  "data": {
    "type": "image",
    "url": "[完整图片链接，例如：https://你的域名/static/generated/xxx.png]",
    "image_url": "[同 url，方便不同调用方读取]"
  }
}
```

> 从旧图集随机返回图片链接。 买家秀 无

### 手写字

- ???`/openapi/write`
- ???`GET`
- ???JSON 图片链接

**????**

- txt 文本

**????**

```text
https://ai.typh.top/openapi/write?txt=手写文字
```

**????**

```json
{
  "code": 0,
  "success": true,
  "data": {
    "type": "image",
    "url": "[完整图片链接，例如：https://你的域名/static/generated/xxx.png]",
    "image_url": "[同 url，方便不同调用方读取]"
  }
}
```

> 返回生成好的手写图片链接。 手写字 txt 文本

### 墓碑生成

- ???`/openapi/mzmimg`
- ???`GET`
- ???JSON 图片链接

**????**

- txt1 名字；txt 内容

**????**

```text
https://ai.typh.top/openapi/mzmimg?txt1=名字&txt=内容
```

**????**

```json
{
  "code": 0,
  "success": true,
  "data": {
    "type": "image",
    "url": "[完整图片链接，例如：https://你的域名/static/generated/xxx.png]",
    "image_url": "[同 url，方便不同调用方读取]"
  }
}
```

> 返回生成好的墓碑图片链接。 墓碑生成 txt1 名字；txt 内容

### ChatGPT 绘图

- ???`/openapi/openaiimg`
- ???`GET / POST`
- ???JSON

**????**

- prompt 或 DT 为绘图提示词；如果后台给此接口设置价格，调用时还要传 api_key。

**????**

```text
GET https://ai.typh.top/openapi/openaiimg?prompt=一只猫；POST JSON {"prompt":"一只猫"}
```

**????**

```json
{
  "code": 0,
  "success": true,
  "data": {
    "type": "image",
    "url": "[完整图片链接，例如：https://你的域名/static/generated/xxx.png]",
    "image_url": "[同 url，方便不同调用方读取]"
  }
}
```

> 可用：配置自己的绘图 Key 后可接入真实绘图。 ChatGPT 绘图 POST DT 绘画提示词；key 可选

### 图床 Base64 上传

- ???`/openapi/image-upload`
- ???`POST`
- ???JSON
- ????? `api_key`

**????**

- api_key 必填；image/base64 必填；filename 可选

**????**

```text
POST https://ai.typh.top/openapi/image-upload  {api_key, filename, image}
```

**????**

```json
{
  "success": true,
  "url": "[上传成功后的图片链接]",
  "path": "[站内图片访问路径]",
  "remaining_slots": "[剩余可上传张数]"
}
```

> 上传成功返回图片链接，消耗图床张数额度。 图床 Base64 上传 api_key 必填；image/base64 必填；filename 可选

## 文字娱乐 / 工具

### 判断文本字数

- ???`/openapi/pdzs`
- ???`GET`
- ???JSON / 文本

**????**

- • msg （必填）

**????**

```text
https://ai.typh.top/openapi/pdzs
```

**????**

```json
{
  "code": 0,
  "success": true,
  "data": "[这里返回接口的文本内容，例如一句话、查询结果、链接或提示]"
}
```

> 使用mb_strlen()直接判断字数

### 段子

- ???`/openapi/duanzi`
- ???`GET`
- ???JSON / 文本

**????**

- • 无

**????**

```text
https://ai.typh.top/openapi/duanzi
```

**????**

```json
{
  "code": 0,
  "success": true,
  "data": "[这里返回接口的文本内容，例如一句话、查询结果、链接或提示]"
}
```

> id只能为1或者2，随机返回精选短视频或段子。

### 随机颜色

- ???`/openapi/sjys`
- ???`GET`
- ???JSON / 文本

**????**

- • 无

**????**

```text
https://ai.typh.top/openapi/sjys
```

**????**

```json
{
  "code": 0,
  "success": true,
  "data": "[这里返回接口的文本内容，例如一句话、查询结果、链接或提示]"
}
```

> 随机返回十六进制颜色代码。

### 随机谜语

- ???`/openapi/miyu`
- ???`GET`
- ???JSON / 文本

**????**

- • 无

**????**

```text
https://ai.typh.top/openapi/miyu
```

**????**

```json
{
  "code": 0,
  "success": true,
  "data": "[这里返回接口的文本内容，例如一句话、查询结果、链接或提示]"
}
```

> 共收集10715条谜语信息，将给您带来不一样的体验。

### 农历

- ???`/openapi/nl`
- ???`GET`
- ???JSON / 文本

**????**

- • 无

**????**

```text
https://ai.typh.top/openapi/nl
```

**????**

```json
{
  "code": 0,
  "success": true,
  "data": "[这里返回接口的文本内容，例如一句话、查询结果、链接或提示]"
}
```

> 返回当日农历、节气。

### 今日运势

- ???`/openapi/fortune`
- ???`GET`
- ???JSON / 文本

**????**

- name 或 qq 可选；format=json 可返回 JSON

**????**

```text
https://ai.typh.top/openapi/fortune?name=小明&format=json
```

**????**

```json
{
  "name": "[参与运势计算的名字或 QQ]",
  "score": "[今日运势分数]",
  "lucky_color": "[幸运颜色]",
  "lucky_number": "[幸运数字]",
  "good": "[宜做事项数组]",
  "bad": "[忌做事项数组]",
  "advice": "[一句话建议]"
}
```

> 同一天同一名字结果稳定。 今日运势 name 或 qq 可选；format=json 可返回 JSON

### 历史今天

- ???`/openapi/today`
- ???`GET`
- ???JSON / 文本

**????**

- 无

**????**

```text
https://ai.typh.top/openapi/today
```

**????**

```json
{
  "code": 0,
  "success": true,
  "data": "[这里返回接口的文本内容，例如一句话、查询结果、链接或提示]"
}
```

> 返回 JSON 文本。 历史今天 无

### 取时间间隔

- ???`/openapi/qsjjg`
- ???`GET`
- ???JSON / 文本

**????**

- date1/date2；part 年/月/日/分/秒

**????**

```text
https://ai.typh.top/openapi/qsjjg
```

**????**

```json
{
  "code": 0,
  "success": true,
  "data": "[这里返回接口的文本内容，例如一句话、查询结果、链接或提示]"
}
```

> 返回时间差。 取时间间隔 date1/date2；part 年/月/日/分/秒

### 舔狗日记

- ???`/openapi/tiangou`
- ???`GET`
- ???JSON / 文本

**????**

- 无

**????**

```text
https://ai.typh.top/openapi/tiangou
```

**????**

```json
{
  "code": 0,
  "success": true,
  "data": "[这里返回接口的文本内容，例如一句话、查询结果、链接或提示]"
}
```

> 返回文本。 舔狗日记 无

### 污言秽语

- ???`/openapi/wyhy`
- ???`GET`
- ???JSON / 文本

**????**

- msg 类型 1-5

**????**

```text
https://ai.typh.top/openapi/wyhy
```

**????**

```json
{
  "code": 0,
  "success": true,
  "data": "[这里返回接口的文本内容，例如一句话、查询结果、链接或提示]"
}
```

> 返回娱乐文本。 污言秽语 msg 类型 1-5

## 音乐 / 搜索

### 铃声多多（QR、SQ可发）

- ???`/openapi/lsdd`
- ???`GET`
- ???JSON / 文本

**????**

- • msg （必填）
- • n （选择时必填）
- • m （返回数量设置，默认10，最多可100。选择时必填）

**????**

```text
https://ai.typh.top/openapi/lsdd
```

**????**

```json
{
  "code": 0,
  "success": true,
  "data": "[这里返回接口的文本内容，例如一句话、查询结果、链接或提示]"
}
```

> 来源铃声多多，有n=数字为选歌，无n则为列表。

### 酷狗mv

- ???`/openapi/kgmv`
- ???`GET`
- ???JSON / 文本

**????**

- • msg （必填）
- • type （选填）
- • n （选择时必填）

**????**

```text
https://ai.typh.top/openapi/kgmv
```

**????**

```json
{
  "code": 0,
  "success": true,
  "data": "[这里返回接口的文本内容，例如一句话、查询结果、链接或提示]"
}
```

> 来源酷狗音乐，type为json时将输出json格式，否则将输出播放直链。有n=数字为选，无n则为列表。

### 酷狗音乐

- ???`/openapi/kg`
- ???`GET`
- ???JSON / 文本

**????**

- • msg （必填）
- • type （选填）
- • n （选择时必填）

**????**

```text
https://ai.typh.top/openapi/kg
```

**????**

```json
{
  "code": 0,
  "success": true,
  "data": "[这里返回接口的文本内容，例如一句话、查询结果、链接或提示]"
}
```

> 来源酷狗音乐，type为json时将输出json格式，否则将输出播放直链。有n=数字为选歌，无n则为列表。

### 诗词查询

- ???`/openapi/shici`
- ???`GET`
- ???JSON / 文本

**????**

- • msg （必填）

**????**

```text
https://ai.typh.top/openapi/shici
```

**????**

```json
{
  "code": 0,
  "success": true,
  "data": "[这里返回接口的文本内容，例如一句话、查询结果、链接或提示]"
}
```

> 可模糊输入，查询诗词。

### 哔哩哔哩

- ???`/openapi/bilibili`
- ???`GET`
- ???JSON / 文本

**????**

- • msg （必填）
- • n （选择时必填）

**????**

```text
https://ai.typh.top/openapi/bilibili
```

**????**

```json
{
  "code": 0,
  "success": true,
  "data": "[这里返回接口的文本内容，例如一句话、查询结果、链接或提示]"
}
```

> 来源于网络，有n=数字为选，无n则为列表。

### 漫画搜书

- ???`/openapi/comlc`
- ???`GET`
- ???JSON / 文本

**????**

- msg 漫画名；b 可选序号

**????**

```text
https://ai.typh.top/openapi/comlc
```

**????**

```json
{
  "code": 0,
  "success": true,
  "data": "[这里返回接口的文本内容，例如一句话、查询结果、链接或提示]"
}
```

> 返回搜索入口链接。 漫画搜书 msg 漫画名；b 可选序号

## 查询 / 网络

### ping

- ???`/openapi/ping1`
- ???`GET`
- ???JSON / 文本

**????**

- • msg （必填）

**????**

```text
https://ai.typh.top/openapi/ping1
```

**????**

```json
{
  "code": 0,
  "success": true,
  "data": "[这里返回接口的文本内容，例如一句话、查询结果、链接或提示]"
}
```

> 调用本地ping功能，查询网站响应速度。

### 王者荣耀英雄出装

- ???`/openapi/wzry`
- ???`GET`
- ???JSON / 文本

**????**

- • msg （必填）

**????**

```text
https://ai.typh.top/openapi/wzry
```

**????**

```json
{
  "code": 0,
  "success": true,
  "data": "[这里返回接口的文本内容，例如一句话、查询结果、链接或提示]"
}
```

> 查询英雄出装、铭文配置等。

### 香港节点ping

- ???`/openapi/ping1`
- ???`GET`
- ???JSON / 文本

**????**

- • msg （必填）

**????**

```text
https://ai.typh.top/openapi/ping1
```

**????**

```json
{
  "code": 0,
  "success": true,
  "data": "[这里返回接口的文本内容，例如一句话、查询结果、链接或提示]"
}
```

> 本服务器归属地为香港。

### QQ 群 AI 协议链接生成

- ???`/openapi/qq-ai-url`
- ???`GET`
- ???JSON

**????**

- groupCode：QQ群号，必填。
- botUin：机器人 QQ，必填。
- botUid：机器人 UID，可选；如果不知道可以不传。
- screen：弹窗屏幕参数，可选，默认 1。

**????**

```text
https://ai.typh.top/openapi/qq-ai-url?groupCode=142655101&botUin=3889003506
```

**????**

```json
{
  "groupCode": "[QQ群号]",
  "botUin": "[机器人 QQ]",
  "botUid": "[机器人 UID；未传则为空]",
  "screen": "[屏幕参数]",
  "open_kuikly_info": "[用于 QQ 跳转的内部 JSON 参数]",
  "transfer_url": "[已 URL 编码的 QQ transfer 跳转链接]",
  "url": "[最终可直接复制使用的二维码页面完整 URL]",
  "qrcode_url": "[同 url]",
  "traceDetail": {
    "encoded": "[traceDetail 编码值]",
    "decoded": {
      "appid": "outside",
      "page_id": "not_qq"
    }
  }
}
```

> 说明：这里的“加密”实际是 QQ 链接需要的 URL 编码封装。botUid 不能由 botUin 反推，所以只作为可选参数。

### 天气查询

- ???`/openapi/tianqi`
- ???`GET`
- ???JSON / 文本

**????**

- msg 城市；b 可选；hh 可选

**????**

```text
https://ai.typh.top/openapi/tianqi
```

**????**

```json
{
  "code": 0,
  "success": true,
  "data": "[这里返回接口的文本内容，例如一句话、查询结果、链接或提示]"
}
```

> 兼容文字天气。 天气查询 msg 城市；b 可选；hh 可选

### QQ号评估

- ???`/openapi/qqpg`
- ???`GET`
- ???JSON / 文本

**????**

- qq QQ号

**????**

```text
https://ai.typh.top/openapi/qqpg
```

**????**

```json
{
  "code": 0,
  "success": true,
  "data": "[这里返回接口的文本内容，例如一句话、查询结果、链接或提示]"
}
```

> 返回本地评估文本。 QQ号评估 qq QQ号

## AI / 对话

### 语音聊天接口

- ???`/openapi/ttslt`
- ???`GET`
- ???JSON / 文本

**????**

- • msg （必填）

**????**

```text
https://ai.typh.top/openapi/ttslt
```

**????**

```json
{
  "code": 0,
  "success": true,
  "data": "[这里返回接口的文本内容，例如一句话、查询结果、链接或提示]"
}
```

> 返回聊天语音〖mp3〗。
对接图灵聊天接口。〖限次数〗

### 文字转语音

- ???`/openapi/tts`
- ???`GET`
- ???JSON / 文本

**????**

- • msg （必填）

**????**

```text
https://ai.typh.top/openapi/tts
```

**????**

```json
{
  "code": 0,
  "success": true,
  "data": "[这里返回接口的文本内容，例如一句话、查询结果、链接或提示]"
}
```

> 文字转语音。
注：生成语音保留60秒，60秒后失效。

### 聊天

- ???`/openapi/lt`
- ???`GET`
- ???JSON / 文本

**????**

- • msg （必填）

**????**

```text
https://ai.typh.top/openapi/lt
```

**????**

```json
{
  "code": 0,
  "success": true,
  "data": "[这里返回接口的文本内容，例如一句话、查询结果、链接或提示]"
}
```

> 返回接口结果。

### 语音接口

- ???`/openapi/vioce`
- ???`GET`
- ???JSON / 文本

**????**

- msg 文本

**????**

```text
https://ai.typh.top/openapi/vioce
```

**????**

```json
{
  "code": 0,
  "success": true,
  "data": "[这里返回接口的文本内容，例如一句话、查询结果、链接或提示]"
}
```

> 返回语音合成提示文本。 语音接口 msg 文本

### ChatGPT 对话

- ???`/openapi/gpt`
- ???`GET / POST`
- ???JSON

**????**

- message 或 msg 为用户问题；如果后台给此接口设置价格，调用时还要传 api_key。

**????**

```text
GET https://ai.typh.top/openapi/gpt?message=你好；POST JSON {"message":"你好"}
```

**????**

```json
{
  "success": true,
  "reply": "[AI 回复文本]",
  "prompt": "[用户提交的问题]",
  "configured": "[是否已接入真实模型配置]"
}
```

> 可用：配置自己的模型 Key 后可接入真实对话。 ChatGPT 对话 POST context；message 可选

## 其他接口

### 土味情话

- ???`/openapi/twqh`
- ???`GET`
- ???JSON / 文本

**????**

- 本API无需参数

**????**

```text
https://ai.typh.top/openapi/twqh
```

**????**

```json
{
  "code": 0,
  "success": true,
  "data": "[这里返回接口的文本内容，例如一句话、查询结果、链接或提示]"
}
```

> 1700句土味情话

### 搜图

- ???`/openapi/st`
- ???`GET`
- ???图片 / SVG

**????**

- • msg （必填）

**????**

```text
https://ai.typh.top/openapi/st
```

**????**

```json
{
  "code": 0,
  "success": true,
  "data": {
    "type": "image",
    "url": "[完整图片链接，例如：https://你的域名/static/generated/xxx.png]",
    "image_url": "[同 url，方便不同调用方读取]"
  }
}
```

> 搜图资源来源于网络，并非贪夜收集，其搜索图片可能受版权保护，您应知晓其连带责任。若搜索不到时自动随机推荐精选图。

### 精选短视频

- ???`/openapi/jingxuanshipin`
- ???`GET`
- ???JSON / 文本

**????**

- • type （必填）

**????**

```text
https://ai.typh.top/openapi/jingxuanshipin
```

**????**

```json
{
  "code": 0,
  "success": true,
  "data": "[这里返回接口的文本内容，例如一句话、查询结果、链接或提示]"
}
```

> type可为网红、明星、热舞、风景、游戏、动物。

### 美女图

- ???`/openapi/meinvtu`
- ???`GET`
- ???图片 / SVG

**????**

- • msg （必填）

**????**

```text
https://ai.typh.top/openapi/meinvtu
```

**????**

```json
{
  "code": 0,
  "success": true,
  "data": {
    "type": "image",
    "url": "[完整图片链接，例如：https://你的域名/static/generated/xxx.png]",
    "image_url": "[同 url，方便不同调用方读取]"
  }
}
```

> m值为1时只返回链接，m为其他值时返回图片和类型。

### 语音报时

- ???`/openapi/yybaoshi`
- ???`GET`
- ???JSON / 文本

**????**

- msg 1-24 点

**????**

```text
https://ai.typh.top/openapi/yybaoshi
```

**????**

```json
{
  "code": 0,
  "success": true,
  "data": "[这里返回接口的文本内容，例如一句话、查询结果、链接或提示]"
}
```

> 返回报时文本。 语音报时 msg 1-24 点