主题
妙图设计 API 概览
公测版本(Beta):当前 API 使用
tsk_live_*成员令牌与CommonResult响应包装体,接口形态在正式 GA 版本发布前可能调整。请关注变更日志。
简介
妙图设计 API 允许开发者通过 HTTP 接口,将妙图的 AI 图像处理能力集成到自己的应用或自动化流程中。
当前 Beta 版本支持以下功能:
| 功能 | 接口路径 | 成功时 taskType |
|---|---|---|
| 文生图(Text to Image) | POST /image/text2image | text2image |
| 抠图(Background Matting) | POST /image/matting | matting |
| 转绘(Style Transform) | POST /image/style-transform | style-transform |
| 局部重绘(Inpainting) | POST /image/inpainting | inpainting |
| 高清放大(Super Resolution) | POST /image/super-resolution | super-res |
| 变清晰(Clarify) | POST /image/clarify | clarify |
| 图像扩展(Outpainting) | POST /image/outpainting | outpainting |
| 智能修图(Smart Edit) | POST /image/smart-edit | smart-edit |
| 裂变(Variation) | POST /image/variation | variation |
| 局部替换(Local Replace) | POST /image/local-replace | local-replace |
| 去水印(Remove Watermark) | POST /image/remove-watermark | remove-watermark |
| 去褶皱(Remove Wrinkle) | POST /image/remove-wrinkle | remove-wrinkle |
| 图片转 SVG v2(To SVG) | POST /image/to-svg/v2 | 2svg |
| 图片转 SVG v1(兼容) | POST /image/to-svg | 2svg |
| 转灰度图(To Grayscale) | POST /image/to-grayscale | 2grayscale |
| 印花提取(Extract Printing) | POST /image/extract-printing | extract-printing |
| SVG 转 DXF | POST /image/svg2dxf | svg2dxf |
| 商品套图(Mockup) | POST /image/mockup | mockup |
| 查询公开套图模板 | GET /image/mockup | — |
| 头像贴纸(Head Sticker) | POST /image/head-sticker | head-sticker |
| 上传图片 | POST /images/upload | — |
| 查询已上传图片 | GET /images/page | — |
| 删除已上传图片 | DELETE /images/{id} | — |
| 查询任务结果 | GET /tasks/{taskId} | — |
| 查询积分余额 | GET /account/balance | — |
POST /image/style-transfer(风格迁移)已停用,请改用转绘接口。
所有图像处理接口均为异步任务:提交请求后返回 taskId,通过轮询 GET /tasks/{taskId} 获取最终结果。
生产环境地址
https://magiqsight.com/openapi/v1认证方式
所有请求须在 HTTP 头中携带 Bearer 令牌:
http
Authorization: Bearer tsk_live_xxxxxxxxxxxxxxxxxxxx令牌在账户的 API 密钥 页面创建,请妥善保管——明文只在创建后展示一次。
计费说明
每次调用上述图像处理接口(POST /image/*,不含已停用的 style-transfer、不含 GET /image/mockup)消耗 1 个 API_CALL 积分。 GET /account/balance、GET /tasks/{taskId}、GET /image/mockup 以及图片管理接口(/images/*)不收费。
API 积分与前端产品内的图像积分相互独立,通过 API 消费的积分不影响前端配额,反之亦然。
限速
每个令牌有每分钟调用次数上限。超出限制时返回 429,响应头 Retry-After 指示等待秒数。 每个令牌还可以设置月度积分上限(月消耗封顶),超出时返回 402。
异步任务流程
POST /image/xxx
└─→ { taskId: "img-abc123" }
GET /tasks/img-abc123 (每 2 秒轮询一次)
└─→ status: 0 (处理中) / 4 (队列等待中)
└─→ status: 1 (成功 ✓) → 按 resultType 读取结果(多数图像任务看 imageUrls)
└─→ status: 2 (失败 ✗) → 查看 resultMetadata
└─→ status: 3 (已取消)建议轮询间隔:2 秒;最多轮询 5 分钟后停止,避免无限等待。
当前 Beta 版已知限制
- 无 SDK,仅支持原始 HTTP / curl 调用。
- 无 Webhook,结果只能通过轮询获取。
- 响应包装体为
CommonResult {code, msg, data},非 REST 资源模型。 taskId为内部任务 ID,GA 版本将提供稳定的公开job_id。requestId用于计费去重记录,不保证幂等重放。
