Canva 技能

使用 Canva Connect API 实现设计创建、导出及资源上传等流程。

前提条件

创建一个 Canva 集成：

1. 访问 https://www.canva.com/developers/
2. 创建一个新的集成
3. 获取您的 Client ID 和 Client Secret

设置环境变量：

export CANVA_CLIENT_ID="your_client_id"
export CANVA_CLIENT_SECRET="your_client_secret"

首次使用时进行身份验证，并将令牌存储在 ~/.canva/tokens.json 中。

API 基础 URL

https://api.canva.com/rest/v1

身份验证

从本地令牌文件中获取访问令牌：

ACCESS_TOKEN=$(cat ~/.canva/tokens.json | jq -r '.access_token')

当认证流程支持时，自动刷新令牌。

核心操作

列出设计

curl -s "https://api.canva.com/rest/v1/designs" 
  -H "Authorization: Bearer $ACCESS_TOKEN" | jq .

获取设计详情

curl -s "https://api.canva.com/rest/v1/designs/{designId}" 
  -H "Authorization: Bearer $ACCESS_TOKEN" | jq .

基于模板创建设计

curl -X POST "https://api.canva.com/rest/v1/autofills" 
  -H "Authorization: Bearer $ACCESS_TOKEN" 
  -H "Content-Type: application/json" 
  -d '{
    "brand_template_id": "TEMPLATE_ID",
    "data": {
      "title": {"type": "text", "text": "Your Title"},
      "body": {"type": "text", "text": "Your body text"}
    }
  }'

导出设计

启动导出任务：

curl -X POST "https://api.canva.com/rest/v1/exports" 
  -H "Authorization: Bearer $ACCESS_TOKEN" 
  -H "Content-Type: application/json" 
  -d '{
    "design_id": "DESIGN_ID",
    "format": {"type": "png", "width": 1080, "height": 1080}
  }'

检查导出状态：

curl -s "https://api.canva.com/rest/v1/exports/{jobId}" 
  -H "Authorization: Bearer $ACCESS_TOKEN" | jq .

上传资源

curl -X POST "https://api.canva.com/rest/v1/asset-uploads" 
  -H "Authorization: Bearer $ACCESS_TOKEN" 
  -H "Content-Type: application/octet-stream" 
  -H 'Asset-Upload-Metadata: {"name": "my-image.png"}' 
  --data-binary @image.png

列出品牌模板

curl -s "https://api.canva.com/rest/v1/brand-templates" 
  -H "Authorization: Bearer $ACCESS_TOKEN" | jq .

导出格式

• PNG：支持指定宽高、无损压缩
• JPG：支持指定宽高与质量（1–100）
• PDF：支持标准版与印刷版
• MP4：适用于视频类设计
• GIF：适用于动画类设计

常用工作流

创建 Instagram 帖子

1. 列出品牌模板
2. 查找 Instagram 帖子模板
3. 使用内容自动填充
4. 以 PNG 格式（1080×1080）导出
5. 下载导出的文件

创建轮播图（Carousel）

1. 通过 autofill 创建多个设计
2. 分别以 PNG 格式导出每个设计
3. 合并后用于发布

批量导出

1. 列出所有设计
2. 遍历并逐个导出
3. 下载全部导出文件

错误处理

清晰处理常见错误：

• 401：令牌已过期，需刷新
• 403：缺少必需的作用域（scope）
• 404：设计或模板未找到
• 429：超出速率限制

必需的作用域（Scopes）

• design:content:read
• design:content:write
• asset:read
• asset:write
• brandtemplate:content:read

提示

• 如可用，优先选用品牌模板（Brand Templates）制作海报和幻灯片。
• 使用批量导出减少重复性操作。
• 在本地缓存常用模板 ID。
• 轮询导出任务状态，待其完成后再下载文件。

当前状态

该本地技能骨架已安装至 workspace，但 Canva API 尚不可用，需完成集成凭证配置及首次 OAuth 身份验证后方可启用。