核心用法
Sleek 是一款专为移动应用UI设计打造的AI工具,用户可通过自然语言描述直接生成界面。核心工作流包含:创建项目→发送自然语言指令→AI自动生成或修改屏幕→获取截图反馈。支持两种调用模式:异步轮询(默认,适合复杂任务)和同步阻塞(wait=true,最长300秒)。
关键操作流程:
- 项目创建:
POST /api/v1/projects,仅需提供名称 - 智能生成:
POST /api/v1/projects/{id}/chat/messages,将需求直接作为message.text发送,AI自动解析意图并创建/更新屏幕 - 结果获取:轮询
/chat/runs/{runId}至状态为completed,提取screen_created/screen_updated操作中的屏幕ID - 截图交付:必须使用
/api/screenshots渲染结果,规则强制要求——首次创建时需输出单屏截图+全项目合成图,仅更新时输出受影响屏幕截图
高级特性:
target.screenId支持精准编辑指定屏幕imageUrls可传入参考图片作为视觉上下文idempotency-key实现安全重试- 支持
showDots网格背景辅助设计审查
显著优点
1. 零设计门槛:无需掌握Figma/Sketch等专业工具,纯自然语言驱动,大幅降低原型制作成本
2. 端到端闭环:从需求描述到可视截图完整自动化,无需人工介入设计系统
3. 精细化控制:支持单屏幕编辑、版本管理(activeVersion)、异步/同步灵活调度
4. 安全架构清晰:单一可信域名(sleek.design)、HTTPS-only、最小权限的Scope机制(projects:read到chats:write等细粒度控制)
5. 工程友好:标准REST API、完整错误码体系(401/403/409等)、分页支持、幂等性设计
潜在缺点与局限性
1. 付费门槛:API访问强制要求Pro+订阅,且存在out_of_credits额度限制
2. 并发限制:单项目仅允许一个活跃run,409冲突需客户端主动轮询等待
3. 同步超时风险:wait=true最长300秒,复杂生成易触发202超时需降级到轮询
4. 图片URL约束:仅接受HTTPS,敏感内容存在泄露风险(由Sleek服务器拉取)
5. 黑盒AI决策:屏幕拆分逻辑由AI自主决定,用户对中间结构控制力有限
6. 生态封闭:截图仅为静态图片,无代码导出或设计源文件(如.fig)交互能力
适合人群
- 产品经理/创业者:快速验证MVP界面概念,替代高保真原型外包
- 开发工程师:需要UI视觉参考但无设计资源,直接获取截图用于前端开发对照
- 设计团队:作为Figma的AI辅助,加速初稿生成阶段
常规风险
| 风险类型 | 具体表现 | 缓解建议 |
|---------|---------|---------|
| 凭证泄露 | `SLEEK_API_KEY`硬编码或日志泄露 | 使用环境变量、短期密钥、定期轮换 |
| 额度耗尽 | `out_of_credits`导致服务中断 | 前置额度监控,关键流程添加降级策略 |
| 并发阻塞 | 409冲突未处理导致消息丢失 | 实现指数退避轮询,队列化用户请求 |
| 敏感数据外泄 | `imageUrls`指向含隐私信息的图片 | 预审查URL内容,禁用敏感场景的图片引用 |
| API变更 | 文档版本与实现不一致 | 集成前验证端点行为,关注官方变更公告 |