概覽/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 創建新結果。