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": "暮色中的纸雕分层山脉，暖色边缘光",
"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 URL。将该 URL 下载为二进制文件，然后交给用户。
时间与限制
| 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 每日上限。只能等待，或让用户登录。