Developer API

用一行请求生成贴图 PNG

风格对齐 OpenAI Images：Bearer 认证 + JSON。提交模板编号与文案，服务端渲染完成后返回可下载的图片链接。

POST Bearer sk-… 每次 1 积分 失败自动退点
管理 API Key 查看模板编号

认证

在请求头携带 Bearer API Key（在 API Key 页面生成）：

HTTP Header 
Authorization: Bearer sk-你的密钥

密钥仅在创建时完整展示一次。修改密码或账号被封禁后，所有 API Key 会失效。

生成图片

POST /v1/images/generations

Base URL 为当前站点 origin：

Base URL 
https://你的域名

请求参数

Content-Type: application/json

字段类型必填说明
template string 必填 6 位模板编号（推荐），或 public_id，或公开作品虚拟 id g{record_id}
prompt string 必填 填入贴图的文案内容
model string 可选 覆盖默认对话模型
response_format string 可选 目前仅支持 url

成功响应

200 JSON 
{
  "created": 1710000000,
  "data": [
    {
      "url": "https://你的域名/outputs/generated/1/poster.png",
      "template": "482917",
      "width": 1080,
      "height": 1920
    }
  ],
  "usage": { "points": 1 }
}

curl 示例

bash 
curl https://你的域名/v1/images/generations \
  -H "Authorization: Bearer sk-你的密钥" \
  -H "Content-Type: application/json" \
  -d '{"template":"482917","prompt":"春季招聘前端工程师，薪资面议"}'

模板编号

在 模板库 卡片上可复制 6 位编号。 也可调用公开接口 GET /api/templates（无需 API Key）获取 code 与 id。

积分与限流

1 积分 / 次 成功路径扣点；LLM 或截图失败自动退回
独立限流 默认 10 次/分钟，可在管理后台调整

错误码

HTTP说明
401缺少或无效 API Key
403账号已停用
402积分不足
404模板不存在或无权访问
422参数错误
429过于频繁
502上游或截图失败（已退点）

错误体示例：

JSON 
{
  "detail": {
    "error": {
      "message": "API Key 无效或已吊销",
      "type": "auth_error",
      "code": "invalid_api_key"
    }
  }
}