AI 设计 API 文档

canvas.setSize({ width: 800, height: 1200 })
canvas.setBg({ color: "#fff5e6" })

object.addText({
  text: "夏季大促",
  fontSize: 96, fill: "#ff4757",
  fontWeight: "bold",
  x: 400, y: 150
})

object.addText({ text: "全场 5 折起", fontSize: 36, fill: "#2f3542", x: 400, y: 260 })
object.addText({ text: "¥99", fontSize: 120, fill: "#ff4757", fontWeight: "bold", x: 400, y: 950 })

object.addImage({
  url: "https://example.com/product.png",
  x: 400, y: 600, scale: 0.5
})

用案例 1 的流程完成 800×1200 主设计。

resize.generate({ width: 1080, height: 1440, name: "小红书封面" })

形状按比例缩放，文字按 fontSize 缩放避免拉伸。

page.switch({ id: "<主页面id>" })  // 切回主页面
resize.generate({ width: 1080, height: 1080, name: "朋友圈" })

const { pages } = await page.list()
for (const p of pages) {
  await page.switch({ id: p.id })
  await export.image({ format: "png", scale: 2 })
}

智能体自己生成或调用生图模型，得到 SVG path：

// 例如：一条波浪线
const svgPath = "M 0 100 Q 50 0 100 100 Q 150 200 200 100 Q 250 0 300 100"

object.addPath({
  svgPath,
  stroke: "#ff6b6b", strokeWidth: 3,
  fill: "transparent",
  x: 100, y: 400
})

draw.addPathText({
  svgPath: "M 100 300 Q 300 100 500 300",
  text: "简单设计 AI 自动生成",
  fontSize: 24,
  fill: "#6366f1",
  showPath: false  // 不显示底层路径
})

const { objects } = await query.objects({ type: "image" })
// 从结果中找到产品图对象（通常按 name 或位置判断）

const products = [{ url: "p1.png" }, { url: "p2.png" }, ...]
for (const p of products) {
  await image.replace({ id: productId, url: p.url })
  await export.image({ format: "png", scale: 2 })
}

brand.add({ type: "palette", name: "主色", value: "#1677ff" })
brand.add({ type: "font", name: "主字体", value: "Microsoft YaHei" })

brand.applyTheme()
// → 所有形状换首个色板色，文字换首个字体

brand.applyPalette({ color: "#1677ff", id: "<某对象id>" })
brand.applyFont({ fontFamily: "Microsoft YaHei", ids: ["text1", "text2"] })

// 智能体计算一组波浪点
const points = []
for (let i = 0; i <= 10; i++) {
  points.push({
    x: 50 + i * 60,
    y: 200 + Math.sin(i * 0.8) * 40
  })
}

draw.addFreeDrawPath({
  points,
  stroke: "#ff4757",
  strokeWidth: 8,
  fill: "transparent"
})
// 点会被二次贝塞尔曲线自动平滑

draw.startFreeDraw({ width: 4, color: "#000000" })
// → 画布进入绘制模式，用户可以鼠标手绘

draw.endFreeDraw()
// → 恢复对象可选状态，可继续编辑

（参考案例 1 完成设计）

export.pdf({ dpi: 300, scale: 3 })
// → 自动触发浏览器下载 PDF
// dpi=300 印刷级，scale=3 提升清晰度

export.psd({ filename: "my-design" })
// → 每个图层独立，文字栅格化