转灰度图（To Grayscale）

将彩色图片转换为高质量灰度图，适用于打印预览、艺术效果或后续图像处理。

基本信息

项目	值
接口路径	POST /image/to-grayscale
所需 Scope	to_grayscale（规范名）或别名 2grayscale，或 *

| 任务类型 | 异步，返回 taskId |

---

请求参数

{
  "requestId": "可选，调用方自定义唯一 ID",
  "url": "原图的公开 HTTPS URL（必填）"
}

参数说明

参数	类型	必填	说明
requestId	string	否	调用方请求 ID，用于幂等去重
url	string	是	彩色图片的公开 HTTPS URL

---

请求示例

curl -s -X POST \
  -H "Authorization: Bearer $TUSEN_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://example.com/photo.jpg"
  }' \
  "https://magiqsight.com/openapi/v1/image/to-grayscale"

响应示例

{
  "code": 0,
  "data": {
    "requestId": "req_abc123",
    "taskId": "task_xyz"
  },
  "msg": ""
}

获得 taskId 后，通过 GET /tasks/{taskId} 轮询结果。

任务成功（status: 1）后，resultType 为 exr（OpenEXR 格式），结果通过以下字段获取：

• exrUrls: EXR 格式的灰度图 URL 列表（HDR 高动态范围图像）
• exrPreviewUrls: EXR 预览图 URL 列表（PNG 格式，方便快速预览）

响应示例（成功）：

{
  "code": 0,
  "data": {
    "taskId": "task_xyz",
    "status": 1,
    "progress": 1.0,
    "resultType": "exr",
    "exrUrls": ["https://s3.magiqsight.com/private/xxx.exr"],
    "exrPreviewUrls": ["https://s3.magiqsight.com/private/xxx.png"]
  }
}

注意：EXR 格式保留完整灰度信息和动态范围，适合专业图像处理。如需 JPEG/PNG 格式输出，可使用 exrPreviewUrls 中的预览图。