主题
妙图设计 API 概览
公测版本（Beta）：当前 API 使用
tsk_live_*成员令牌与CommonResult响应包装体，接口形态在正式 GA 版本发布前可能调整。请关注变更日志。
简介
妙图设计 API 允许开发者通过 HTTP 接口，将妙图的 AI 图像处理能力集成到自己的应用或自动化流程中。
当前 Beta 版本支持以下功能：
| 功能 | 接口路径 |
|---|---|
| 文生图（Text to Image） | POST /image/text2image |
| 抠图（Background Matting） | POST /image/matting |
| 转绘（Style Transform） | POST /image/style-transform |
| 局部重绘（Inpainting） | POST /image/inpainting |
| 高清放大（Super Resolution） | POST /image/super-resolution |
| 变清晰（Clarify） | POST /image/clarify |
| 图像扩展（Outpainting） | POST /image/outpainting |
| 智能修图（Smart Edit） | POST /image/smart-edit |
| 局部替换（Local Replace） | POST /image/local-replace |
| 去水印（Remove Watermark） | POST /image/remove-watermark |
| 去褶皱（Remove Wrinkle） | POST /image/remove-wrinkle |
| 图片转 SVG（To SVG） | POST /image/to-svg |
| 转灰度图（To Grayscale） | POST /image/to-grayscale |
| 查询任务结果 | GET /tasks/{taskId} |
| 查询积分余额 | GET /account/balance |
所有图像处理接口均为异步任务：提交请求后返回 taskId，通过轮询 GET /tasks/{taskId} 获取最终结果。
生产环境地址
https://magiqsight.com/openapi/v1认证方式
所有请求须在 HTTP 头中携带 Bearer 令牌：
http
Authorization: Bearer tsk_live_xxxxxxxxxxxxxxxxxxxx令牌在账户的 API 密钥 页面创建，请妥善保管——明文只在创建后展示一次。
计费说明
每次调用图像处理接口（14 个 POST /image/* 接口）消耗 1 个 API_CALL 积分。 GET /account/balance 和 GET /tasks/{taskId} 不收费。
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用于计费去重记录，不保证幂等重放。