核心用法
Sogni Creative Agent Skill 是一款功能丰富的CLI工具，通过调用Sogni AI的去中心化GPU网络实现多模态内容生成。核心工作模式分为三类：
直连SDK模式：用户自行规划工具选择，直接调用生成命令（如sogni-agent -q -Q pro），适用于明确的单次图像/视频/音乐生成任务，延迟最低、成本最优。
多步骤持久化工作流：通过--api-workflow配合显式的JSON步骤图（steps数组含toolName、arguments、dependsOn绑定），实现可重放、可恢复的多步骤创作，全程无托管LLM重新规划。
托管LLM循环模式：--api-chat或--durable-chat将完整创作循环委托给服务端模型，适用于长异步作业、多文件上传或需要结构化合约修复的场景。
主要功能覆盖：图像生成（z_image_turbo_bf16等，支持fast/hq/pro三档质量预设）、视频生成（LTX/WAN/Seedance/HappyHorse多模型，支持t2v/i2v/s2v/ia2v/a2v等工作流）、音乐生成（含歌词与BPM控制）、风格迁移、角度合成、角色形象克隆（Photobooth）、无缝贴图生成等。
显著优点
去中心化算力成本优势：基于分布式GPU网络，相比中心化云服务商具有潜在成本优势，Unlimited订阅（$20/月）提供公平使用政策下的无限生成。
端到端多模态能力：单一CLI覆盖图像→视频→音乐的完整创作管线，支持图片文件夹一键生成循环视频（--source-reel/--reel-loop）、唇音同步（s2v）、音频反应可视化等高级特性。
持久化与可复现性：角色形象（Persona）支持保存参考照片与声纹片段；记忆系统（--memory-set/--memory-list）保存用户偏好；工作流支持完整重放记录（replay records）。
专业级视频控制：LTX系列模型支持精确的4-8句连续镜头描述、相机语言规范化、时长与画幅映射规则；Seedance 2.0原生支持4K（2160p）与原生环境音。
灵活的模型生态：实时模型目录（--list-models/--search-models）涵盖图像、视频、音频全品类，支持LoRA堆叠（最多8个）、身份保持编辑（Krea）、NSFW标签过滤等。
潜在缺点与局限性
认证与计费复杂性：多层级计费体系（SPARK/SOGNI代币、Premium Spark、Unlimited订阅）易造成混淆；vendor模型（Seedance/HappyHorse/GPT Image 2）始终需Premium Spark，无法通过订阅免费使用。
平台锁定风险：核心功能完全依赖Sogni AI的托管服务与去中心化网络，API密钥、角色数据、记忆均存储于~/.config/sogni/，迁移成本较高。
视频生成的技术约束：各模型有严格的尺寸整除要求（WAN需16整除、LTX需64整除），非标准尺寸自动调整或报错；高分辨率生成（4K/1080p）对模型选择有严格限制。
去中心化网络的稳定性：依赖"Supernet"中的动态worker池，可能出现"No workers"状态；公平使用政策下的并发限制随日生成量阶梯下降，高负载时进入标准队列。
学习曲线陡峭：丰富的功能标志（flags）、模型特定提示词规则（如LTX的4-8句电影化段落）、工作流JSON结构需要仔细阅读多份reference文档才能正确使用。
适合的目标群体
- 专业内容创作者：需要批量生成、风格一致性控制、角色形象复用的视觉设计师、视频制作人。
- AI艺术探索者：希望实验多模型（LTX/WAN/Seedance等）、LoRA堆叠、高级视频编辑（缝合、音轨替换、360环绕）的技术爱好者。
- 订阅制优先用户：Unlimited订阅适合中高产量创作者，可规避按生成计费的焦虑。
- 多模态工作流整合者：需要将图像、视频、音乐生成整合到自动化脚本或CI/CD流程的开发者（JSON输出模式、程序化工作流输入）。
使用风险
依赖项风险：必须预先安装Node.js，建议安装ffmpeg（anyBins要求）；全局npm安装可能带来版本冲突或权限问题。
性能与超时：视频生成默认300秒超时，复杂场景或网络拥堵时可能失败；建议对长视频使用--duration渐进测试。
隐私与数据安全：本地文件引用（--ref）会上传至Sogni媒体存储并转为可检索URL，敏感素材需使用纯本地CLI模式（direct SDK mode）。
计费意外：--token-type auto可能因SPARK不足自动切换计费方式；vendor模型错误选择可能导致Unexpected Spark扣除；doctor命令会触发实时网络/认证调用，沙箱环境可能触发多次网络授权提示。
并发与ID冲突：多进程共享同一SOGNI_APP_ID会导致连接踢出（SWITCH_CONNECTION 4015），需正确配置slot pool或固定ID。
更新管理：CLI可能打印更新提醒至stderr，需正确处理（--snooze-update）避免干扰程序化输出解析。