概览/OpenAPI/AI 应用

AI 应用

根据描述和附件创建可交互的网页应用。

AI 应用

AI 应用使用 type: app,可创建互动网页、模拟器、测验、演示和小工具。

创建示例

{  "type": "app",  "prompt": "做一个互动测验,让新员工练习识别客户问题的升级等级",  "instructions": "每题即时反馈,显示总分,并提供重新开始按钮",  "input_file_ids": ["file_xxx"],  "app": {    "language": "zh"  }}

怎样写好需求

建议说明:

  • 谁会使用。
  • 用户需要执行什么操作。
  • 页面要展示什么反馈。
  • 一次成功体验应达到什么状态。
  • 是否需要重置、计分、步骤控制或无障碍支持。

例如,“做一个学习应用”比较宽泛;“做一个五题测验,每题即时解释答案,完成后显示得分并可重新开始”更容易得到可用结果。

附件与 URL

AI 应用支持 input_file_ids。可以上传需求文档、讲义、数据文件或参考图片。

当前 AI 应用不声明 URL Context。prompt 中出现链接时,不要告诉用户已经读取网页内容;需要引用网页内容时,应先转换为可上传文件。

查询结果

创建后查询 GET /creations/{id}。ready 后从 GET /creations/{id}/outputs 获取可打开的应用地址。预览应来自返回 URL,不要自行拼接路径。

AI 应用当前不声明解说视频的 messages 编辑能力。需要较大修改时,以更清楚的 prompt 和 instructions 创建新结果。