开发者接入

调用图片，从找到 ID 开始

选择模板 → 复制 ID → 用管理员发放的 KEY 请求 → 保存 PNG 图片。

本页查询不生成图片、不消耗额度。只列出已发布模板，图片 ID 就是请求中的 template。

1. 查找图片 / 模板 ID

正在加载…

已选 0 张

勾选多张后，下面的对接配置和请求示例会自动更新。缩略图为底图预览，不是本期成品。

外部项目的 PHP 脚本已经逐个遍历模板 ID。将接口地址改成下面这一行，其余下载逻辑保持不变：

const API_URL = 'https://shengtu.494499.xyz/download.php';

先在上面选模板，再复制以下模板参数给你的脚本：

每次 POST 返回一张 PNG；循环调用就能将多张图片分别保存为 01.png、02.png……，不是 ZIP。

KEY 只能由管理员在后台创建。保存在调用方服务器环境变量，不要放在公开网页或网址中。此接口不能直接用浏览器 GET 链接生成图片。

POST https://shengtu.494499.xyz/download.php

Content-Type: application/json
Authorization: Bearer YOUR_API_KEY

单张请求体（使用已选的第一张模板）：

成功返回 HTTP 200 和 Content-Type: image/png，响应体直接是图片。失败返回 JSON 错误，不能把它保存成 PNG。

使用 POST /api.php?action=batch_generate，同样携带 Authorization。最多指定20个模板：

成功 HTTP 201，读取 outputs 数组中的 templateId 和 imageUrl。调用方逐个下载 imageUrl，或在网页的 <img src="成品地址"> 中引用。它也不返回 ZIP。

无须 KEY，只读查询已发布模板：

按名称、分类或 ID 搜索，在链接后加 ?q=关键词；程序应对关键词进行 URL 编码。

{
  "count": 1,
  "templates": [{"id": "真实模板ID", "name": "图片名称", "category": "分类", "previewUrl": "底图地址"}]
}

以上响应仅为结构示例。previewUrl 是底图，不是生成后的图片。未发布模板不会列出。