概览/OpenAPI/互动课程

互动课程

从互动课程角度组织创建、管理和迭代相关接口。

互动课程接口

这页从 interactive_lesson 的角度看互动课程接口。

兼容说明:

  • web_app 仍兼容作为历史输入别名
  • 现在 catalog 和 API 响应统一返回 interactive_lesson

互动课程仍然复用同一套创建、任务、详情接口,只是参数应明显更轻。

创建

POST /creations

常见字段:

  • type=interactive_lesson
  • prompt
  • language
  • instructions

通常不需要:

  • voice_id
  • duration_seconds
  • scene_count

管理

重点通常是:

  • 任务是否完成
  • 最终访问 URL
  • 预览图或封面

编辑

互动课程更常见的是整体迭代,而不是单场景编辑。

如果产品要做“继续修改”,建议先把用户指令整理成新的 prompt 或 instructions,再走下一次创建或编辑能力。

实践建议

  • UI 和文档都尽量保持轻量
  • 不要把视频或 slides 的参数原样搬过来
  • 结果返回时优先告诉用户“点哪里能直接打开体验”