依据给出的图片,猜出图片对应的成语,体验视觉与文学的交织感。
| 参数名 | 类型 | 必填 | 说明 | 示例 |
|---|---|---|---|---|
| id | string | 是 | 用户唯一标识,用于区分不同用户,可自定义(如用户 ID、设备 ID 等) | 1828222534 |
| msg | string | 是 | 用户输入参数,仅可为:开始游戏、提示、我猜 | 开始游戏 |
[
{
"name": "id",
"type": "string",
"required": true,
"description": "用户唯一标识,用于区分不同用户,可自定义(如用户 ID、设备 ID 等)",
"example": "1828222534"
},
{
"name": "msg",
"type": "string",
"required": true,
"description": "用户输入参数,仅可为:开始游戏、提示、我猜",
"example": "开始游戏"
}
]
{"openapi":"3.1.1","info":{"title":"看图猜成语","description":"依据给出的图片,猜出图片对应的成语,体验视觉与文学的交织感。","version":"1.0.0"},"paths":{"/v1/game_ktccy.php":{"get":{"summary":"看图猜成语","description":"依据给出的图片,猜出图片对应的成语,体验视觉与文学的交织感。","parameters":[{"name":"id","in":"query","required":true,"schema":{"type":"string","example":"1828222534"},"description":"用户唯一标识,用于区分不同用户,可自定义(如用户 ID、设备 ID 等)"},{"name":"msg","in":"query","required":true,"schema":{"type":"string","example":"开始游戏"},"description":"用户输入参数,仅可为:开始游戏、提示、我猜"}],"responses":{"200":{"description":"成功","content":{"application/json":{"schema":{"type":"object"}}}}}},"post":{"summary":"看图猜成语","description":"依据给出的图片,猜出图片对应的成语,体验视觉与文学的交织感。","parameters":[{"name":"id","in":"query","required":true,"schema":{"type":"string","example":"1828222534"},"description":"用户唯一标识,用于区分不同用户,可自定义(如用户 ID、设备 ID 等)"},{"name":"msg","in":"query","required":true,"schema":{"type":"string","example":"开始游戏"},"description":"用户输入参数,仅可为:开始游戏、提示、我猜"}],"responses":{"200":{"description":"成功","content":{"application/json":{"schema":{"type":"object"}}}}}}}},"servers":[{"url":"http://xiaoapi.cn","description":"当前访问入口(http)"}]}
{
"code": 200,
"data": {
"msg": "游戏开始啦,请看图!",
"pic": "http://api.suol.cc/v1/data/ktccy/img/030.jpg",
"answer": "三头六臂"
},
"tips": "慕名API:http://xiaoapi.cn"
}
通过随机展示图片,用户根据图片内容猜测对应成语,支持开始游戏、获取提示、提交答案等交互,适用于休闲娱乐与中文学习场景。
https://api.xiaoapi.cn/v1/game_ktccy.php
GET
无需密钥调用接口。
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| id | string | 是 | 用户唯一标识,用于区分不同用户,可自定义(如用户 ID、设备 ID 等) |
| msg | string | 是 | 用户输入参数,用于控制游戏流程 |
| 取值 | 说明 |
|---|---|
| 开始游戏 | 开启一轮新的看图猜成语游戏,返回一张图片供用户猜答 |
| 提示 | 获取当前题目的提示信息 |
| 我猜 | 提交用户对当前图片所对应成语的猜测答案 |
{
"code": 200,
"data": {
"msg": "游戏开始啦,请看图!",
"pic": "http://api.suol.cc/v1/data/ktccy/img/030.jpg",
"answer": "三头六臂"
},
"tips": "慕名API:http://xiaoapi.cn"
}
| 字段 | 类型 | 说明 |
|---|---|---|
| code | int | 状态码,200 表示接口调用成功 |
| data | object | 响应数据体,包含游戏返回的各项信息 |
| data.msg | string | 当前操作的提示信息,如“游戏开始啦,请看图!” |
| data.pic | string | 图片 URL 地址,供用户查看并猜成语 |
| data.answer | string | 图片对应的成语答案 |
| tips | string | 平台提示信息 |
接口调用失败时,返回统一的 JSON 错误响应格式。
JSON 错误响应结构:
{"code":0,"msg":"错误描述信息","errcode":错误码}
错误响应示例:
{"code":0,"msg":"请求过于频繁,请稍后重试","errcode":11005}
接口返回的错误码采用统一的 errcode 字段标识,以下为完整的错误码含义说明。
| errcode | 说明 |
|---|---|
| 11001 | 未提供调用密钥 |
| 11002 | 密钥错误 |
| 11003 | 密钥已禁用 |
| 11004 | 积分余额不足 |
| 11005 | 请求过于频繁(QPM 限制) |
| 11006 | 接口维护中 |
| 11007 | 接口已禁用 |
| 11008 | 接口不可用 |
| 11009 | 密钥校验暂不可用 |
| 11010 | 积分系统暂不可用 |
| 11011 | 收费接口须提供有效密钥 |
| 11012 | 鉴权方式错误 |
| 11013 | 接口不存在 |
| 11014 | ***地址无效 |
| 11015 | ***地址不允许 |
| 11016 | ***请求失败 |
| 11017 | 服务暂不可用 |
| 11018 | 请求方式不允许 |
| 11019 | 当前IP不在白名单内 |
| 11020 | 启用出口代理须提供有效密钥 |
| 11021 | 未配置可用出口代理 |
| 11022 | 出口代理不可用 |
curl -X GET "http://api.suol.cc/v1/game_ktccy.php?id=1828222534&msg=%E5%BC%80%E5%A7%8B%E6%B8%B8%E6%88%8F"
// 看图猜成语 - 开始游戏
$id = "1828222534";
$msg = "开始游戏";
$url = "http://api.suol.cc/v1/game_ktccy.php?id=" . $id . "&msg=" . urlencode($msg);
$response = file_get_contents($url);
echo $response;
msg 参数仅支持 开始游戏、提示、我猜 三种固定值,请勿传入其他内容,否则将无法正常响应。id 参数用于区分不同用户,建议使用长期稳定的唯一标识(如用户 ID),避免游戏进度错乱或数据混乱。answer 字段包含当前题目的成语答案,pic 字段为题目对应的图片,请根据 msg 参数类型合理解析返回数据。curl -s "https://api.xiaoapi.cn/v1/game_ktccy.php?id=1828222534&msg=开始游戏" | head -1 | grep -o '"msg":"[^"]*"' && echo ''
// 结果将在此处显示