131 lines
4.7 KiB
Plaintext
131 lines
4.7 KiB
Plaintext
|
||
===== 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 |