正在載入 API 合約…
快速開始
建立 API 金鑰並送出第一個生成請求。
- 1建立並安全保存 Developer API 金鑰
- 2取得模型目錄識別並提交生成任務
- 3輪詢任務狀態並更新暫時成果網址
驗證
由伺服器傳送 Authorization: Bearer lpk_...。金鑰具備 query 與 generate 權限範圍,只顯示一次,且不可出現在瀏覽器程式碼中。
模型目錄
從業務模型目錄取得模型 ID、能力與 Schema 版本,不硬編碼供應商假設。
生成任務
以穩定的 Idempotency-Key 標頭提交完整目錄識別與符合 Schema 的 input,並需要 generate 權限。
計費方式
Developer API 會從預付 USD 錢包扣款,並以每筆生成任務的預扣與結算方式計費。
1.會先預扣額度
提交生成時,系統會依估計最高費用在 API 錢包中預扣對應金額。
2.任務成功後才收取實際費用
任務成功完成後,會依最終計量結果扣款,並釋放未使用的預扣額度。
3.不會超過預扣金額
若計量結果低於預扣金額,只會收取結果金額,差額會回到可用餘額。
範例:$6.00 預扣、$4.50 結果時,只會收取 $4.50,差額退回可用餘額。
狀態與成果
使用 query 權限輪詢任務狀態、取得穩定成果索引並更新暫時內容網址;不支援取消。
錯誤
處理 {code, message, data} 結構化回應與業務錯誤碼,並避免公開敏感請求資料。