laybot / ai-sdk
LayBot LingTeach AI PHP SDK
v1.0.2
2025-07-07 04:21 UTC
Requires
- php: >=8.1
- guzzlehttp/guzzle: ^7.8
- psr/http-message: ^1.0 || ^2.0
- psr/log: ^1|^2|^3
- workerman/workerman: ^4.1 || ^5.0
README
教育智能中枢引擎 · 为教学场景深度优化
Powered by LayBot LingTeach AI | 官网 https://ai.laybot.cn
LayBot 灵语智教 是一套专为 分层教学支持、课堂教学、作业批改、教研创作、动态Q&A 打磨的 AI 引擎。
本 SDK 以 OpenAI 完全兼容的调用方式,一键接入 灵语智教 教育核心模型矩阵,自动完成计费与合规审计,让开发者专注教学业务本身。
⚡ Webman 专享 · 真·思维链流式
- 本 SDK 内置 自动流式驱动检测
Webman / Workerman 进程 → AsyncTcpConnection,毫秒级逐 token 推流,对于Webman框架在AI流式输出提速更友好;
在 Laravel / ThinkPHP / 其他 FPM 环境 → Guzzle Stream,零依赖零配置。 - 告别“整段再返”,实时展示思维链。
- 本 SDK 默认为LayBot专属模型调用,同时也支持使用本SDK的能力直接面向DeepSeek,OpenAI这些大模型api调用场景
✨ 为什么选择 LayBot 灵语智教?
功能 | 价值 |
---|---|
🛰️ 流式 SSE | stream:true 即获毫秒级增量反馈 |
🛡️ 企业级安全 | API-Key / IP 白名单、余额预扣、敏感词脱敏 |
💰 成本透明 | 按教育任务颗粒度计费,Credit 明细实时可查 |
🧠 教学深度适配 | 预置 K12/高教/国际课程专用推理参数 |
🚀 智能分层教学 | 动态生成梯度化习题(基础→拓展→竞赛) |
✍️ 作业批改引擎 | 支持数学公式/图文混排版面解析(LB-Aethel) |
🌐 国际课程适配 | A-Level/AP/IB成绩单智能分析+选课推荐 |
📝 教研创作加速 | 3秒生成考点明确的试卷(支持LaTeX输出) |
🛡️ 教育合规保障 | 内置K12内容过滤+GDPR合规审计 |
📚 旗舰教育智能模型(节选)
教育场景 | 解决方案 | 模型推荐 | 模型代号 | 核心优势 |
---|---|---|---|---|
口语评测 | 实时发音打分+口语表达能力分析 | 灵语·语韵 | LB-Phona | 毫秒级语音识别+精准发音纠错,定制化口语评测方案,适配K12与成人口语训练场景 |
能力素养测评 | 综合素养分析+成长路径建议 | 灵语·慧学 | LB-Skillwise | 多维度素质能力测评,自动生成个性化成长建议,覆盖学科+创新+综合素质等模块 |
K12分层教学 | 动态梯度习题生成 | 明心·洞玄 | LB-Insight | 中英双语分层训练 → 5分钟生成千人千面习题,智能匹配学力水平 |
智能组卷批改 | 图文混排试卷生成+批改 | 灵语·玄穹 | LB-Aethel | 数学公式/图文解析 → 精准识别手写解题步骤,自动生成错题本 |
学业诊断 | 成绩单分析+薄弱点定位 | 灵语·太初 | LB-Primordius | 多步链式解题 → 深度追踪思维漏洞,提供针对性补强方案 |
跨学科教学 | 学科知识串联教学 | 灵语·寰宇 | LB-Cosmos | 高中/大学跨学科推理 → 打破学科壁垒,构建知识网络图谱 |
完整模型列表与价格,请参考控制台「模型与价格」页。所有模型均针对教学场景深度优化,支持 K12/高教/国际课程等全学段教育需求。
📦 安装
composer require laybot/ai-sdk
🏃♂️ 快速上手
🧩 与 LayBot 前端框架深度集成
若您使用 LayBot MPA/SPA 前端框架(发明专利申请号:2025108367676),可无缝嵌入 AI 组件:
<laybot-ai-chat model="LB-Cosmos" api-key="sk-live-xxxxxxxx" prompt="用高中难度讲解牛顿第二定律" > <!-- 组件自动处理流式输出 --> </laybot-ai-chat>
<?php // 课堂教学场景:动态分层讲解 $chat->completions([ 'model' => 'LB-Cosmos', 'messages' => [ ['role' => 'user', 'content' => '为初二学生讲解浮力定律'] ], 'edu_features' => [ 'difficulty' => 'middle_school', // K12学段适配 'tiered' => true // 启用分层教学(自动生成基础+拓展内容) ] ]); // 作业批改场景:数学图文解析 $chat->completions([ 'model' => 'LB-Aethel', 'messages' => [ ['role' => 'user', 'content' => file_get_contents('math_homework.jpg')] ], 'task_type' => 'grading' // 激活批改模式 ]);
<?php require 'vendor/autoload.php'; use Laybot\Chat; /** 初始化(支持 PSR-18 容器内全局共享) */ $chat = new Chat('sk-live-xxxxxxxx'); /** 流式课堂问答 */ $chat->completions([ 'model' => 'LB-Cosmos', 'stream' => true, 'messages' => [ ['role'=>'user','content'=>'请用高中难度讲解牛顿第二定律'] ] ],[ 'stream' => fn($chunk,$done) => print $done ? PHP_EOL : ($chunk['choices'][0]['delta']['content'] ?? ''), 'complete' => fn($json) => print_r($json) ]);
✨ 教育专属能力一览
能力 | 典型场景 | 对应端点 |
---|---|---|
Smart Chat | 课堂 Q&A / 知识点讲解 | /v1/chat |
Doc Parser | 课件|试卷 → 结构化文本 | /v1/doc |
Essay Grader | 作文评分、润色 | /v1/chat + rubric 模板 |
Item Generator | 习题 / 试卷批量生成 | /v1/chat batch 模式 |
Vision QA | 图片实验报告解析 | /v1/chat + image-in |
⛑️ 常见错误码
code | http | 描述 |
---|---|---|
40101 | 401 | API_KEY_INVALID — Key 不存在或禁用 |
40200 | 402 | INSUFFICIENT_CREDIT — 余额不足 |
42900 | 429 | RATE_LIMITED — 触发限流 |
50000 | 500 | INTERNAL_ERROR — 平台内部异常 |
完整列表见文档 https://ai.laybot.cn/docs/errors
🔧 高级用法
// 自定义超时 / 代理 $chat = new Laybot\Chat([ 'apikey' => 'sk-xxx', 'base' => 'https://api.laybot.cn', 'guzzle' => ['timeout'=>30,'proxy'=>'http://127.0.0.1:7890'] ]);
🚀 路线图
- Embed / Audio / Vision 端点
- WebSocket 多轮上下文通道
- SDK 自动指数退避重试
- Webman & Thinkphp & Laravel & Yii ServiceProvider
🤝 参与贡献
PR / Issue 欢迎提交!
代码规范:PSR-12 + PHPStan 8 + PHPUnit。
composer run test # 运行完整单测
📜 知识产权与专利保护
1. SDK 许可证
本项目采用 Apache License 2.0,核心保障:
- ✅ 允许商业闭源使用
- ✅ 明确专利授权
- ✅ 防御性专利终止条款
📄 License
Apache-2.0 © 2025 LayBot Inc. – LayBot LingTeach AI