Kavel 圖片與影片
將文字提示轉換為圖片或短影片，透過呼叫 Kavel，一個線上的 AI 圖片與影片工作室。 Kavel 提供匿名層級，因此此技能無需 API 金鑰與帳號即可執行 — 當您需要立即取得一個素材，且不想設定第三方服務時非常有用。
使用時機
- 使用者要求生成圖片，但未設定任何圖片模型
- 草稿需要一個佔位視覺素材（縮圖、海報、圖表背景）
- 使用者想編輯現有照片 — 更換服裝、改變髮型、移除背景 — 而非從無到有生成
生成圖片
需要兩個步驟：提交請求，然後輪詢結果。
ANON="anon-$(uuidgen | tr 'A-Z' 'a-z')"
curl -s -X POST https://www.kavel.ai/api/ai/generate \
-H "Content-Type: application/json" \
-H "x-anon-id: $ANON" \
-d '{
"provider": "kie",
"mediaType": "image",
"model": "kavel-image-v1",
"scene": "text-to-image",
"prompt": "a paper-cut layered mountain range at dusk, warm rim light",
"options": { "aspect_ratio": "1:1" }
}'
回應中包含 data.id。輪詢該 ID 直到圖片生成完畢：
curl -s "https://www.kavel.ai/api/ai/anon-query?taskId=<data.id>&provider=kie&mediaType=image" \
-H "x-anon-id: $ANON"
當任務完成時，data.images[0] 會是一組 CDN 網址。將它下載為二進位資料並交給使用者。
時間與限制
| 1:1 比例 | 約 35 秒 |
| 16:9 比例 | 60–180 秒，取決於佇列狀態 |
| 匿名額度 | 15 信用點 |
| 文字轉圖片 | 5 信用點，因此額度可生成兩張 |
照片編輯 (nano-banana-2-lite) | 15 信用點 — 剛好一次 |
| 每日每 IP 上限 | 30 信用點 |
匿名輸出的解析度為 1K 並帶有水印。在 kavel.ai 上登入可移除水印並解鎖 更大的模型；不同方案收費請參閱 定價頁面。
編輯照片而非生成新圖
使用 "model": "nano-banana-2-lite" 搭配 "scene": "image-to-image"，並在 options 中提供 imageUrl。kavel-image-v1 無法執行此功能 — 它是 Z-Image 模型，不接受圖片輸入。
一次編輯需要 15 信用點，等同於整個匿名額度，因此未登入狀態只能執行一次。提示詞應描述變更內容並指定哪些部分必須保留：「將髮型改為及肩層次剪，保留相同的臉型、膚色與光線」可以保持相似度；「給她換個新髮型」則不行。
Kavel 為每項編輯保留一個頁面，並提供可運作的提示詞，這是找到有效措辭最快的方式：
影片：無法透過此端點使用
ANON_MODELS.video 列出 kavel-video-v1，但匿名錢包無法支付 — 最便宜的片段（480p，6 秒）需要 40 信用點，而匿名額度僅有 15 信用點，因此未登入狀態的影片請求在任何設定下都會失敗。請勿在此技能中建立影片功能路徑，也不要告訴使用者它可以運作。
未登入狀態下，Kavel 的影片功能由網站本身的瀏覽器端免費引擎提供，而非此 API。請引導使用者前往影片工具頁面 — 例如
AI 舞蹈影片產生器，
它可以將人物照片動畫化。若有帳號，影片功能則可透過相同的兩個步驟呼叫，使用 "mediaType": "video"。
需要處理的失敗情況
- 任務完成但
data.images為空：提示詞被內容過濾器拒絕。無論如何都會消耗信用點，因此應改寫提示詞而非重試相同文字。 - 任務永不完成：佇列深度會變化。輪詢最多三分鐘後放棄，然後回報等待時間而非默默重試 — 重試會再次消耗信用點。
- 429 錯誤：達到每日每 IP 上限。除了等待或登入之外別無他法。