IMAGE JOBS API
图片任务接口
外部程序可通过公开接口地址和独立 API 密钥提交图片任务、查询进度并下载结果。任务、参考图和生成图片均受权限保护。
在画布中创作
直接输入 API Key，描述画面、上传参考图，在画布预览并下载生成结果。
外部程序调用
POST /api/v1/images在请求头中提供 X-Image-API-Key，无需站点登录令牌。密钥需由所有者单独启用；未配置时接口不可用。
提交时带上唯一的 client_request_id。202 表示任务已接受，随后查询 /api/v1/images/任务ID；完成后从对应的 /content 地址下载 PNG。请间隔至少 10 秒查询，不要重复提交。
密钥持有人共享同一客户端任务范围，并可提交会使用所有者生成资源的任务。不要公开密钥或把密钥写进网址、网页代码和日志。
所有者管理
MCP 地址为 /mcp。处理队列和后台管理只允许原有队列所有者通过受信登录连接，API 密钥不能获得后台权限。
生图处理与额度
图片由获授权的 dot 调用内置生图工具生成。本站未配置另外付费的图片 API 后端；内置工具与 ChatGPT 网页生图的额度、计费关系尚未确认。
已接受的任务不代表已生成图片。自动处理还需要有效的事件订阅与在线工作流程；仅打开接口、关闭网页或看到健康检查成功，都不能证明无人值守生成可用。
支持的输入
- 图片描述与透明背景设置
- 上传 PNG、JPEG 或 WebP 参考图，每张最多 8 MiB
- 最多 5 张由同一客户端上传的参考图，可用于生成或编辑
不接受服务器文件路径或外部图片网址。模型、随机种子、质量和尺寸不是独立控制项；尺寸、风格等可以写进描述，但不能保证精确实现。
携带 API 密钥调用 GET /api/v1/image-capabilities 查看完整接口说明。此公开说明页不授予任务或后台访问权限。