Studio 设计接口

/v1/studio/... 是 ModelFold Studio 的资源接口：同步返回、不创建异步任务，和模型的异步任务接口 /api/v1/jobs/... 使用同一个 API Key。整套 PPT 生成请看 ModelFold PPT 1.1，模板列表和上传也在那一页。

基址：https://modelfold.ai，鉴权：Authorization: Bearer <API Key>。

单张设计自定义尺寸

在 Studio 首页「单张设计」里可以选「自定义」，输入宽高或比例（如 3:2、21:9）；编辑器里点画布空白处也能改尺寸、锁定比例。

每边 320–4096 像素，宽高比在 1:4 到 4:1 之间；按比例输入时长边为 1920 像素。
改尺寸时已有元素等比缩放并居中，仍可编辑。
导出 PNG / GIF 按画布像素尺寸；PDF / PPTX 保持页面比例。

API 目前没有单张设计的生成接口；如果已经有设计 JSON，可以用下面的渲染接口出图，设计里的 width / height 就是输出尺寸。

渲染设计：POST /v1/studio/render

把一份设计（或你自己的模板）渲染成图片，支持用变量批量出图。

字段	类型	说明
`template_id`	string	本人模板 ID（与 `design` 二选一）
`design`	object	Studio 设计 JSON（与 `template_id` 二选一），可指定 `width`、`height`
`variables`	object	单次替换文字里的变量
`rows`	object[]	批量：每行一组变量，最多 100 行，每行出一张图
`page`	integer	渲染第几页（从 0 开始），默认 0
`format`	string	`png`（默认）或 `jpg`
`scale`	number	缩放 0.25–2，默认 1

每出一张图 1 积分（默认价格），失败不扣费。

bash

curl -X POST https://modelfold.ai/v1/studio/render \
  -H "Authorization: Bearer $MODELFOLD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"template_id": "123", "rows": [{"name": "小王"}, {"name": "小李"}], "format": "png"}'
# 返回 {"ok":true,"results":[{"ok":true,"url":"https://…/batch-….png"},…],"credits":2,"balance":898}

Studio 设计接口 ​

单张设计自定义尺寸 ​

渲染设计：POST /v1/studio/render ​

相关 ​

Studio 设计接口

单张设计自定义尺寸

渲染设计：POST /v1/studio/render

相关