影片

影片產生包含在API 文件結構中，以保持一致的產品地圖，但公共端點的可用性必須從OpenAPI 架構和帳戶配置中確認。

＃＃ 要求

啟用視訊端點後，會出現非同步任務模型。建立請求通常包括提示、模型、持續時間、寬高比以及可選的訊框或參考媒體。所有請求都使用承載身份驗證：

Authorization: Bearer KITTA_API_KEY

僅使用 GET /api/openapi.json 返回的端點路徑。請勿將其他部署的路徑複製到客戶端。

回覆

視訊任務回應通常會先傳回任務 ID 和狀態，然後在完成後傳回結果影片 URL。將任務 ID 和原始項目 ID 儲存在一起，因為影片產生的壽命可能比瀏覽器會話的壽命長。

計費和積分

視訊任務可能會很昂貴。強制用戶確認長時間、高解析度或批量生成。在建立批次之前檢查個人資料，並在積分不足時暫停佇列。

錯誤

處理無效提示、不支援的模型、無法存取的參考媒體、積分不足和處理失敗。如果架構未公開視訊端點，則將該功能顯示為不可用，而不是嘗試隱藏路由。

目前公開端點

已驗證模型使用 GET /api/open/v1/media/models?mediaType=video，建立任務使用 POST /api/open/v1/media/videos/jobs，查詢任務使用 GET /api/open/v1/media/videos/jobs/{jobId}。建立時必須提供唯一的 Idempotency-Key；使用相同 key 重試只會回傳首次結果，不會重複建立或扣款。此流程扣除 API 額度而非網站會員積分，建立、持久化、非同步執行或逾時失敗時會冪等退款。