Polotno Studio API

Renders images and videos from templates via the Polotno Cloud Render API. Designed for no-code automation (Zapier, Make, n8n) and direct API usage.

原始信息汇总

Polotno Studio API 数据集概述

• 名称: Polotno Studio API
• 类别: Media
• 提供者: Polotno
• 订阅人数: 1

功能描述

Polotno Studio API 是一个内容自动化平台，能够将设计模板按需转换为图像和视频。用户可在 Polotno Studio 画布编辑器中一次性设计模板，使用 {} 约定标记需要动态变化的图层（如文本层 {headline} 或图像层 {product_photo}），然后通过简单的 REST API 渲染个性化文件，支持单次渲染或批量（每次最多 1000 个）渲染。

可生成内容

• 图像: PNG / JPG 格式，任意尺寸（如社交媒体帖子、广告、开放图谱图像、缩略图）。
• 高分辨率图像与 PDF: 适用于打印，分辨率超过 3000×3000 像素。
• 视频: MP4 或 GIF 格式，基于模板场景渲染。
• 批量渲染: 单个作业可处理 1 到 1000 次渲染。
• Webhooks: 渲染完成时发送 HMAC 签名回调，支持自动重试。

工作原理

1. 在 Polotno Studio 编辑器中设计模板。
2. 使用 {} 命名动态图层（如 {headline} 或 {product_photo}），这些图层自动成为 API 字段。
3. 调用 API 提供值，获取渲染后的图像、视频或 GIF。
4. 可选择在 Webhook 端点接收签名后的输出 URL。

认证方式

• Bearer 令牌: Authorization: Bearer key_live_...（测试模式使用 key_test_...）。
• API 密钥头: X-API-Key: key_live_...。

基础 URL

https://api.studio.polotno.com

计费方式

• 基于信用点：订阅计划提供按周期分配的信用点（周期结束时过期）；充值包可增加信用点，有效期 12 个月。
  • 图像渲染: 1 信用点（PDF 或高于 3000×3000 像素的高分辨率渲染为 3 信用点）。
  • 视频渲染: 每秒 1 信用点（向上取整）。

API 端点

• 模板 (Templates):
  • GET /v1/templates — 列出认证项目中的模板。
  • GET /v1/templates/{id} — 获取单个模板。
  • GET /v1/templates/{id}/dynamic-fields — 获取扁平字段列表（适用于 Zapier、Make、n8n）。
• 图像 (Images):
  • POST /v1/images — 创建图像渲染。
  • GET /v1/images — 列出图像渲染。
  • GET /v1/images/{id} — 获取单个图像渲染。
  • DELETE /v1/images/{id} — 删除图像渲染。
• 视频 (Videos):
  • POST /v1/videos — 创建视频渲染（MP4 或 GIF）。
  • GET /v1/videos — 列出视频渲染。
  • GET /v1/videos/{id} — 获取单个视频渲染。
  • DELETE /v1/videos/{id} — 删除视频渲染。
• 批量 (Bulk):
  • POST /v1/bulk — 创建批量图像渲染作业（1-1000 项）。
  • GET /v1/bulk — 列出批量作业。
  • GET /v1/bulk/{bulk_job_id} — 获取批量作业状态和进度。
  • GET /v1/bulk/{bulk_job_id}/items — 列出批量作业中的项目。
• Webhooks:
  • POST /v1/webhooks — 订阅事件。
  • GET /v1/webhooks — 列出订阅。
  • GET /v1/webhooks/{id} — 获取单个订阅。
  • PATCH /v1/webhooks/{id} — 更新订阅。
  • DELETE /v1/webhooks/{id} — 删除订阅。
  • POST /v1/webhooks/{id}/test — 触发合成测试事件。

示例请求（创建图像渲染）

curl -X POST https://api.studio.polotno.com/v1/images -H "Authorization: Bearer key_live_..." -H "Content-Type: application/json" -d { "template_id": "tpl_123", "dynamic_fields": [ { "name": "headline", "text": "Summer Sale" }, { "name": "product_photo", "image_url": "https://example.com/shoe.jpg" } ], "format": "png" }

响应返回包含 status 和输出 URL 的图像渲染对象。

适用场景

• 个性化广告创意的大规模生成。
• 自动生成社交媒体帖子。
• 动态开放图谱图像和缩略图。
• 程序化视频和短视频。
• 电商/房地产列表可视化。