Kitta CLI
图片与视频
生成图片和视频，执行对口型与配音，并恢复媒体任务。
Kitta CLI 使用公开媒体 API，相关操作会消耗账号 API 额度。请只处理你有权使用的提示词和素材。
查询模型
kitta models list --media-type image
kitta models list --media-type video以接口返回的模型目录为可用性依据。网站可见不代表该模型已经对 API 开放。
上传本地素材
kitta files upload --file ./recording.wav --type audio
kitta files upload --file ./reference.png --type image
kitta files upload --file ./source.mp4 --type video返回的 URL 可用于转写、图片编辑、对口型或视频配音。上传不会自动重试；失败后应先检查原因， 再决定是否重新提交。
生成并下载
kitta image generate --prompt "日出时的纸雕城市" \
--idempotency-key image-001 --wait --output city.png
kitta video generate --prompt "镜头缓慢穿过城市" \
--idempotency-key video-001 --wait --output city.mp4参考图视频通过多个 --references JSON 对象传入：
kitta video generate --prompt "镜头向前推进" \
--references '{"role":"start_frame","url":"https://example.com/start.png"}' \
--idempotency-key video-reference-001对口型与视频配音
kitta video lip-sync generate --video-url VIDEO_URL --audio-url AUDIO_URL
kitta video dubbing generate --video-url VIDEO_URL --text "欢迎使用" \
--reference-id VOICE_ID --idempotency-key dubbing-001 --wait --output dubbed.mp4对口型创建目前不承诺幂等，因此不会自动重试。视频配音使用服务端幂等键。请保存每次返回的任务 ID。
不创建新任务地恢复
kitta image jobs get --job JOB_ID
kitta image jobs wait --job JOB_ID --output recovered.png
kitta video jobs wait --job JOB_ID --output recovered.mp4
kitta video lip-sync jobs wait --job JOB_ID --output recovered.mp4
kitta video dubbing jobs wait --job JOB_ID --output recovered.mp4等待命令只轮询已有任务；Ctrl+C 只停止本地等待。CLI 不覆盖已有输出文件。命令需要远程 素材 URL 时，请先使用上传命令。