分析子任务准备的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

file

是

非空JPEG,最多650KiB,宽高各不超过1600像素。

question

string

是

有效UTF-8,去除首尾空白后非空,最多4096个Unicode码点。

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

成功响应

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

字段/响应项

类型

说明

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、机器码与实际诊断,不套其他文件协议错误包。

最后更新于