概览/OpenAPI/AI 应用

AI 应用

创建和读取互动应用。

AI 应用接口

使用 interactive_lesson 创建可操作的互动课程、测验、模拟器或学习应用。

创建

POST /creations
{  "type": "interactive_lesson",  "prompt": "做一个互动课程,让学生探索二分查找如何逐步缩小范围",  "language": "zh",  "instructions": "包含步骤控制和重置操作"}

通常不需要:

  • voice_id
  • duration_seconds
  • scene_count

管理

重点通常是:

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

修改

Public OpenAPI 当前不提供 AI 应用的场景级编辑。需要修改时,请使用新的提示词和补充说明重新创建。

实践建议

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

为交互而非播放选择 AI 应用

当用户需要操作概念、做选择、回答问题或探索模拟器时,选择 AI 应用。有效请求会说明用户是谁、需要完成什么操作、学习或决策目标、所需控制,以及一次完整交互应达到的状态。这样比宽泛地要求“做一个学习应用”更容易得到聚焦的结果。

让请求保持在应用合同内

interactive_lesson 不是视频类型。提示词用于描述用户目标,instructions 用于具体产品约束,例如步骤、反馈、重置行为或无障碍需求。省略 voice_idduration_secondsscene_count。读取 /catalog,提交一次有效请求,轮询任务,再通过 creation 详情取得完成后的 main_url

公开 OpenAPI 当前不提供 AI 应用的分镜级编辑。交互需要实质变更时,应用更清晰的要求创建修订版,分享新的启动 URL,不要把视频编辑动作当成应用更新。

关联文档