===== PAGE 1 =====
接口文档
域名地址
测试环境：
http://10.201.44.70:9008/ai-agent/
生产环境：
https://r d-mokadisplay .tcl.com/ai-agent/
一、上传图片接口：
1. 接口明细
接口路径：api/v1/pqt est/uplo ad
Cont ent-Type：multip art/form-data
请求方式：POST
2. 请求参数说明
参数名 参数类型 是否必填 参数描述
file File（二进制文件）是待上传图片的二进制文件。请求体格式必须为multipart/form-data ，且包含一个名
为file 的文件字段（如：@"D:\Desktop\PQtest\3-O.png" ）
备注：仅支持 PNG/JP G/JPEG 格式图片，大小不超过 10MB，分辨率最大为 4096×4096 p x
3. 请求及响应示例
上传图片请求示例
curl -X POST "https://rd-mokadisplay.tcl.com/ai-agent/api/v1/pqtest/upload" \
  -F "file=@D:\Desktop\PQtest\3-O.png"1 / 5

===== PAGE 2 =====
  
上传图片响应示例
{
  "code": 200,
  "message": "",
  "data": {
    "upload_image_url": "https://ai.file.qhmoka.com/prod-ai-portal/pq-
image/input/2026-05-28/a2264f477d4d487493058306701cdb44/3-O.png"
  }
}
报错响应示例
{
    "code":400,
    "message":"不支持的图片格式，仅支持  PNG/JPG/JPEG",
    "data":{"upload_image_url": ""}
}
二、生图接口
1. 接口明细
接口路径：api/v1/pqt est/generat e
Cont ent-Type：application/json
请求方式：POST
2. 请求参数说明
参数名 参数类型是否必填 参数描述
user_message String 是 用户的自然语言需求/指令文本，作为本次生成 PQ 测试图的输入内容2 / 5

===== PAGE 3 =====
参数名 参数类型是否必填 参数描述
session_id String 是会话标识，用于把多次请求归到同一会话（便于复用/关联上下文）。在同一会话窗口
下请使用同一session_id。使用 uuid 生成唯一字符串
upload_image_urlString 否 上传的参考图片地址，来自上传接口返回的 URL
备注1：相较于上一版本，本版本新增了 uplo ad_image _url 字段。未传入时，默认为“文生图”模
式（与上版本一致）；传入时，则启用“图生图”模式。
备注2：在多轮对话的“图生图”模式下，需将上一轮对话返回的 imageUrl 作为第二轮对话的 
upload_image _url 传入。
3. 请求及响应示例
单轮对话生图请求示例
{
    "user_message":"请复刻这张图，生成标准 PQ 测试图 ",
    "session_id":"48f1a351-67f2-40db-a57d-20d66249bc93",
    "upload_image_url":"https://test.file.qhmoka.com/test-ai-portal/pq-
image/input/2026-05-21/681136ecf35549bcb7969905fb728991/05213.png"
}
  
单轮对话生图响应示例
{
    "code":200,
    "message":"",
    "data":{"imageUrl":"https://test.file.qhmoka.com/test-ai-portal/pq-
image/2026-05-22/19/05be786be62eb9aa.png"}
}3 / 5

===== PAGE 4 =====
多轮对话生图请求示例
# 第一轮请求
{
    "user_message":"请复刻这张图，生成标准 PQ 测试图 ",
    "session_id":"48f1a351-67f2-40db-a57d-20d66249bc93",
    "upload_image_url":"https://test.file.qhmoka.com/test-ai-portal/pq-
image/input/2026-05-21/681136ecf35549bcb7969905fb728991/05213.png"
}
# 第二轮请求
{
    "user_message":"把图片上部分的白和红圆圈对换位置，把图片下部分蓝和绿圆圈对换位置，同时把
背景颜色换为黄色 ",
    "session_id":"48f1a351-67f2-40db-a57d-20d66249bc93",    # 确保两轮  session_id 
相同
    "upload_image_url":"https://test.file.qhmoka.com/test-ai-portal/pq-
image/2026-05-22/19/05be786be62eb9aa.png" # 这里是第一轮响应返回的 imageUrl
}
多轮对话生图响应示例
# 第一轮响应
{
    "code":200,
    "message":"",
    "data":{"imageUrl":"https://test.file.qhmoka.com/test-ai-portal/pq-
image/2026-05-22/19/05be786be62eb9aa.png"}
}
# 第二轮响应
{
    "code":200,
    "message":"",
    "data":{"imageUrl":"https://test.file.qhmoka.com/test-ai-portal/pq-
image/2026-05-22/19/703f0896ffcc8c57.png"}
}   
报错响应示例
# 大模型调用超时，超过120s
{
    "code":500,
    "message":"生成失败 ",4 / 5

===== PAGE 5 =====
    "data":{"imageUrl":""}
}
 
三、关于多轮对话（图片修改）的图片传参逻辑补充说明
核心规则
从第二轮请求开始，每一轮都必须把"最近一次成功返回的图片"作为本轮请求的输入图片传入。
详细说明
1.首轮请求
•用户可传图、也可不传图（无强制要求）。
2.后续每一轮请求（第 2 轮及以后）
•必须带上 上一轮成功返回的图片 作为输入。
•与首轮用户是否传过图无关，只要是后续轮次就要带。
3.异常情况处理
•如果上一轮请求失败 / 没有返回图片，则向前回溯，使用 最近一次成功返回图片的那一
轮的结果作为本轮输入。
•简单说：始终使用"最近一张成功生成的图片"。5 / 5