AI能力 · 同步接口
AI聊天API接入指南
AI聊天API提供开箱即用的智能对话能力：传入text（问题或指令），接口同步返回AI生成的答复，约0.02元/次。平台侧支持配置上游模型，无需自行申请大模型Key、处理限流与计费细节，适合客服问答、内容生成、意图理解等轻量AI场景快速上线。
接口速览
以下信息来自轻语API开放平台生产环境接口元数据，可直接用于技术选型评估。
| 接口地址 | POST /data/api/fetchAiResult |
|---|---|
| 计费 | 约0.02元/次 |
| 频率限制 | 60次/分钟 |
| 超时时间 | 30秒 |
| 鉴权方式 | apikey（注册后获取） |
| 内容类型 | application/json |
请求参数
| 参数名 | 必填 | 类型 | 说明 |
|---|---|---|---|
apikey | 必填 | string | 用户的apikey，身份凭证 |
text | 必填 | string | 传给AI的内容，可以是问题、指令或需要处理的文本 |
响应示例
成功响应（HTTP 200）
{
"msg": "你好！有什么我可以帮助你的吗？请告诉我你的需求或问题，我会尽力回答和提供帮助。",
"code": 200
}调用示例
cURL 示例
curl -X POST 'https://5555api.com/data/api/fetchAiResult' \
-H 'Content-Type: application/json' \
-d '{"apikey":"YOUR_APIKEY","text":"用一句话介绍轻语API"}'JavaScript 示例
const resp = await fetch('https://5555api.com/data/api/fetchAiResult', {
method: 'POST',
headers: { 'Content-Type': 'application/json' },
body: JSON.stringify({
apikey: 'YOUR_APIKEY',
text: '帮我把这句话改写成更正式的商务语气：东西什么时候发货？'
})
});
const result = await resp.json();
if (result.code === 200) {
console.log('AI答复:', result.msg);
}Python 示例
import requests
resp = requests.post(
'https://5555api.com/data/api/fetchAiResult',
json={
'apikey': 'YOUR_APIKEY',
'text': '用三点说明REST API和GraphQL的区别'
}
)
result = resp.json()
if result['code'] == 200:
print('AI答复:', result['msg'])示例中的 YOUR_APIKEY 请替换为你在轻语API控制台获取的apikey；不要在公开页面或客户端代码中暴露正式API Key。
应用场景
智能客服与FAQ
常见问题自动应答，无法命中时再转人工，降低客服人力成本。
文案与内容辅助
商品描述润色、标题生成、邮件改写，嵌入编辑器做一键优化。
意图理解与分类
用户留言自动打标签、分优先级，为工单系统提供前置处理。
常见问题
AI聊天API怎么调用？
POST https://5555api.com/data/api/fetchAiResult，JSON携带apikey和text即可，AI答复在返回的msg字段中。单次约0.02元。
用的是哪个大模型？
接口对接平台侧配置的上游模型，用户无需自行申请模型Key。具体模型版本以平台公告为准，调用方式保持稳定。
支持多轮对话吗？
当前接口为单轮问答：每次调用独立返回。需要多轮上下文时，可以在text中拼接之前的问答记录后再提交。
响应速度怎么样？
接口超时30秒，常规问题通常数秒内返回。生成内容越长耗时越久，建议前端做loading状态与超时兜底。
可以用于内容审核敏感的场景吗？
生成内容经过平台侧合规处理，但请勿用于违法违规用途；业务侧仍建议对输出做二次过滤。
调用失败常见原因有哪些？
apikey错误或余额不足、text为空、请求频率超过60次/分钟。返回code非200时msg会给出具体原因。