SuperAPI AI 工具集

stitch-sdk-usage

前端与建站

查看项目

更新于 10-15 17:33

技能介绍

用途:Stitch SDK 为 Google Stitch 这一 AI 界面生成服务提供 TypeScript 接口,用于从文本提示生成、编辑和迭代 UI 屏幕,并管理项目、设计系统与屏幕资源。

主要能力:创建与列出项目;按提示生成屏幕(一次可返回多个屏幕,含 .screens、.first、.raw);编辑已有屏幕、生成变体;上传本地图片(.png/.jpg/.jpeg/.webp)或 HTML 文件直接创建屏幕;创建、列出、更新设计系统并应用到屏幕;获取屏幕的 HTML 内容、截图字节(Uint8Array)或签名下载 URL;面向智能体提供动态工具客户端,可列出并调用 MCP 工具。

使用方式:安装 npm install @google/stitch-sdk,设置环境变量 export STITCH_API_KEY="your-api-key"。通过 import { stitch } from "@google/stitch-sdk" 使用单例,首次调用自动连接。也可用 new StitchToolClient({ apiKey, baseUrl, timeout }) 显式配置,支持 STITCH_ACCESS_TOKEN 与 GOOGLE_CLOUD_PROJECT。生成时可传 deviceType(MOBILE/DESKTOP/TABLET/AGNOSTIC)与 modelId 等选项。

适用场景:需要以编程方式批量生成或迭代界面稿、从设计稿图片生成屏幕、为智能体编排 UI 生成流程的开发者。

限制:所有方法失败时抛出 StitchError,错误码包括 AUTH_FAILED、NOT_FOUND、PERMISSION_DENIED、RATE_LIMITED、NETWORK_ERROR、VALIDATION_ERROR、CLARIFICATION_REQUIRED、UNKNOWN_ERROR;CLARIFICATION_REQUIRED 可恢复,需读取 e.clarification 后带回答再次调用。上传支持 .png .jpg .jpeg .webp .html。价格、平台与效果等资料暂未提供。