用途:通过 ibl.ai Course Creation API 以编程方式生成、编辑和发布课程。典型流程为:创建任务 → 用 AI 生成大纲 → 启动完整创建流程 → 读取完整结构或草稿内容。
认证与约定:基础地址为 https://api.iblai.app;每个请求需带请求头 Authorization: Api-Token $IBLAI_API_KEY。路径变量包括 {org}=$IBLAI_ORG、{username}=$IBLAI_USERNAME、{task_id}、{course_id}。所有端点的宿主根为 …/dm/api/ai-mentor/orgs/{org}/users/{username}/course-creation/。若尚未连接,先运行 /iblai-api-login 以填充 IBLAI_ORG、IBLAI_USERNAME 和 IBLAI_API_KEY。
主要能力:任务方面,可列出任务、查看任务详情与状态(状态从 Pending 流转到 Scheduled)、启动完整创建流程、取消流程、创建任务、删除任务、在 LMS 上创建课程、用 AI 生成课程大纲。课程方面,可列出课程(用 ?task={task_id} 按任务过滤)、查看课程详情、读取大纲(不含组件内容)、读取完整结构(默认不含 HTML,加 ?include_content=true 可包含渲染后的组件内容)、读取所有单元的草稿内容、删除课程记录、为单个单元生成草稿内容。
使用方式示例:为已有任务生成 AI 大纲可执行 curl -X POST "https://api.iblai.app/dm/api/ai-mentor/orgs/$IBLAI_ORG/users/$IBLAI_USERNAME/course-creation/tasks/$TASK_ID/create-course-outline/" -H "Authorization: Api-Token $IBLAI_API_KEY"。
限制与注意:删除任务和删除课程记录均为破坏性操作,需先与用户确认。任务状态可用 …/tasks/{task_id}/ 轮询跟踪进度,用 …/tasks/{task_id}/cancel/ 停止运行中的流程。资料未提供收费、价格、平台支持范围等信息。