liblib-ai-gen

该 Skill 通过封装 LiblibAI 官方 API，为用户提供基于 Seedream4.5 模型的图像生成和 Kling 模型的视频生成能力。用户可通过命令行工具 scripts/liblib_client.py 执行文生图、文生视频及图生视频任务，支持异步任务提交与状态轮询，适用于自动化工作流集成。

核心用法方面，用户需配置 LIB_ACCESS_KEY 和 LIB_SECRET_KEY 环境变量，通过 CLI 传入提示词及参数（如分辨率、模型版本、时长等）发起请求。图像生成支持 2048×2048 及以上分辨率，可添加 1-14 张参考图进行风格迁移；视频生成提供 Kling-v2-6（支持音效）、v2-1-master 等多种模型选择，支持 5-10 秒时长及多种画幅比例。所有任务采用异步模式，脚本自动轮询直至完成或超时（图像 600 秒/视频 900 秒）。

显著优点包括：支持业界领先的 Seedream4.5 和 Kling 模型，生成质量高；参数控制精细，支持提示词增强（prompt-magic）、首尾帧控制等专业功能；纯命令行界面便于脚本化和批量处理；具备完善的错误处理和超时机制，且通过 HMAC-SHA1 标准签名保障 API 通信安全。

潜在局限性在于：严格依赖 LiblibAI 云服务，无法离线使用；存在 QPS（1 次/秒）和并发数（5 个）限制，不适合高并发场景；生成资源 URL 仅保留 7 天，需及时下载备份；作为 T3 来源的个人项目，长期维护更新存在不确定性。

适合目标群体包括：需要批量生成 AI 视觉内容的开发者和运维人员、构建自动化设计工作流的产品团队、以及熟悉命令行操作的设计师和 AI 艺术创作者。特别适用于需要集成 Seedream 或 Kling 模型到现有工具链的技术团队。

使用风险主要包括：API 密钥管理不当可能导致凭证泄露；上传至第三方云端的提示词和参考图片存在数据隐私合规风险；网络波动或 LiblibAI 服务不可用可能影响任务提交；云服务调用可能产生额外费用；建议审查代码后再部署使用，以防后续更新引入未审计的安全风险。

核心用法

LiblibAI Image & Video Generation Skill 是面向 LiblibAI 平台的官方 API 客户端封装，提供命令行方式调用 Seedream 4.5 图像生成模型与 Kling 视频生成模型。

图像生成（Seedream 4.5）：

• 支持文生图，默认输出 2048×2048 分辨率，最小总像素 3,686,400（如 2560×1440）
• 支持 1-14 张参考图、提示词扩写（prompt-magic）、批量生成（1-15 张）
• 端点：POST /api/generate/seedreamV4

视频生成（Kling）：

• 文生视频：支持 kling-v2-6（最新，带音效）、v2-1-master、v2-5-turbo 等模型，可选 5s/10s 时长、16:9/9:16/1:1 比例、std/pro 模式
• 图生视频：提供起始帧图片 URL 即可生成动态视频，v2-6 版本使用 images 数组参数
• 端点：/api/generate/video/kling/text2video 与 /api/generate/video/kling/img2video

异步任务模式：所有生成均为异步，提交后返回 generateUuid，需轮询 POST /api/generate/status 获取结果。CLI 脚本默认自动轮询，可用 --no-poll 仅提交任务。

显著优点

1. 官方 API 直联：直接调用 LiblibAI 官方服务，非第三方代理，响应速度和稳定性有保障
2. 模型覆盖全面：同时覆盖图像（Seedream 4.5）和视频（Kling 全系列）两大主流生成赛道
3. 参数灵活度高：支持分辨率、比例、时长、参考图、音效开关等细粒度控制
4. 代码安全规范：无硬编码密钥，强制依赖环境变量（LIB_ACCESS_KEY、LIB_SECRET_KEY），HTTPS 全链路加密
5. 零依赖负担：纯 Python 标准库 + requests，无复杂依赖树

潜在缺点与局限性

1. 环境变量前置：必须预先配置 LIB_ACCESS_KEY 和 LIB_SECRET_KEY，无交互式配置引导
2. 异步流程复杂度：需要理解 "提交-轮询-获取结果" 的异步模式，对新手有一定认知成本
3. 无依赖声明文件：缺少 requirements.txt，用户需自行确保 requests 库已安装
4. 速率与并发限制：QPS 限制 1 请求/秒，最大并发任务 5 个，大规模批量生成需自行排队
5. 结果链接有效期：生成的图片/视频 URL 7 天后失效，需及时转存
6. 国内服务依赖：LiblibAI 服务主要面向国内用户，海外网络环境可能存在访问波动

适合人群

• AI 绘画/视频创作者，需要将 LiblibAI 能力集成到自动化工作流
• 开发者构建基于 Seedream/Kling 的内容生成管线
• 对 CLI 工具熟悉的进阶用户，追求高效批量产出

常规风险

• 凭证泄露风险：环境变量若配置不当（如提交到代码仓库）可能导致密钥泄露
• 成本不可控：图像/视频生成按量计费，高频调用可能产生意外费用
• 内容合规风险：生成内容需遵守 LiblibAI 平台审核规范，存在生成结果被拦截的可能
• 服务可用性依赖：受 LiblibAI 平台服务状态影响，非 100% SLA 保障