# 分析子任务准备的JPEG图片

```{raw} html
<div class="mo-api-page-show-toc" aria-hidden="true"></div>
```

使用当前部署选择的图像模型分析受管子任务准备的JPEG及问题，直接返回文本回答。

```text
POST https://api.moi.matrixorigin.cn/v5/workspaces/{id}/runtime-image-analysis
```

## 调用前准备

`BASE_URL` 使用产品 API 前缀 `https://api.moi.matrixorigin.cn/v5`；专有部署填写对应的产品 API 地址。

在受管子环境使用MOI_ENDPOINT、MOI_API_KEY、MOI_RUNTIME_AUTHORIZATION和MOI_WORKSPACE_ID同一连接组。BASE_URL取MOI_ENDPOINT、WORKSPACE_ID取MOI_WORKSPACE_ID；MOI_RUNTIME_AUTHORIZATION已经包含Bearer前缀。普通PAT不能代替子任务身份。

## 请求参数

:::::::{div} mo-api-tabs
::::::{tab-set}
:::::{tab-item} 输入示例

```bash
curl --fail-with-body -sS -X POST "$BASE_URL/workspaces/$WORKSPACE_ID/runtime-image-analysis" \
  -H "X-API-Key: $MOI_API_KEY" \
  -H "X-MOI-Runtime-Authorization: $MOI_RUNTIME_AUTHORIZATION" \
  -H "X-Workspace-ID: $WORKSPACE_ID" \
  -F "file=@$PREPARED_JPEG" \
  --form-string "question=$QUESTION"
```

:::::
:::::{tab-item} 参数说明

| 字段 | 类型 | 是否必填 | 说明 |
| --- | --- | --- | --- |
| `file` | file | 是 | 非空JPEG，最多650KiB，宽高各不超过1600像素。 |
| `question` | string | 是 | 有效UTF-8，去除首尾空白后非空，最多4096个Unicode码点。 |

multipart只允许file与question各一次。请求体最多1MiB，原问题字节最多16384；编码后的JPEG data URL最多900KiB。部署img_parse服务槽、系统精确模型路由及计费通路必须可用；调用者不能传入模型选择字段。模型调用上下文150秒，CLI等待上限180秒，均不保证成功。

:::::
::::::
:::::::

## 成功响应

:::::::{div} mo-api-tabs mo-api-response-tabs
::::::{tab-set}
:::::{tab-item} 响应示例

```json
{
  "answer": "示例回答"
}
```

:::::
:::::{tab-item} 字段说明

| 字段／响应项 | 类型 | 说明 |
| --- | --- | --- |
| `answer` | string | 模型返回并去除首尾空白的回答。不代表已创建文件或产物。 |

成功响应没有统一code/data外层；临时文件和图片流直接返回字节。

:::::
::::::
:::::::

## 错误响应

:::::::{div} mo-api-tabs mo-api-response-tabs
::::::{tab-set}
:::::{tab-item} 响应示例

```json
{
  "error_code": "image_analysis_unavailable",
  "message": "示例本地化错误"
}
```

:::::
:::::{tab-item} 字段说明

| HTTP | code／形式 | 条件 |
| --- | --- | --- |
| 400 | image_analysis_invalid_multipart | multipart无法解析。 |
| 400 | image_analysis_invalid_fields | 字段未知或重复。 |
| 400 | image_analysis_invalid_input | 字段缺失、问题为空或文本无效。 |
| 400 | image_analysis_invalid_image | JPEG头、尺寸或编码结果无效。 |
| 413 | image_analysis_too_large | 文件、问题字节或请求超限。 |
| 403 | runtime_image_authorization_failed | handler运行身份检查失败。 |
| 503 | image_analysis_unavailable | 模型、计费、依赖或响应不可用。 |

外层身份／任务证明的拒绝还可能先于此handler；保持原始HTTP、机器码与实际诊断，不套其他文件协议错误包。

:::::
::::::
:::::::
