分析子任务准备的JPEG图片¶
使用当前部署选择的图像模型分析受管子任务准备的JPEG及问题,直接返回文本回答。
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不能代替子任务身份。
请求参数¶
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"
字段 |
类型 |
是否必填 |
说明 |
|---|---|---|---|
|
file |
是 |
非空JPEG,最多650KiB,宽高各不超过1600像素。 |
|
string |
是 |
有效UTF-8,去除首尾空白后非空,最多4096个Unicode码点。 |
multipart只允许file与question各一次。请求体最多1MiB,原问题字节最多16384;编码后的JPEG data URL最多900KiB。部署img_parse服务槽、系统精确模型路由及计费通路必须可用;调用者不能传入模型选择字段。模型调用上下文150秒,CLI等待上限180秒,均不保证成功。
成功响应¶
{
"answer": "示例回答"
}
字段/响应项 |
类型 |
说明 |
|---|---|---|
|
string |
模型返回并去除首尾空白的回答。不代表已创建文件或产物。 |
成功响应没有统一code/data外层;临时文件和图片流直接返回字节。
错误响应¶
{
"error_code": "image_analysis_unavailable",
"message": "示例本地化错误"
}
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、机器码与实际诊断,不套其他文件协议错误包。