修改calman灰阶点击异常、修改色准结果显示异常
This commit is contained in:
131
cache/pq_ai_api_v21_extracted.txt
vendored
Normal file
131
cache/pq_ai_api_v21_extracted.txt
vendored
Normal file
@@ -0,0 +1,131 @@
|
||||
|
||||
===== 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
|
||||
17
cache/pq_ai_api_v21_summary.txt
vendored
Normal file
17
cache/pq_ai_api_v21_summary.txt
vendored
Normal file
@@ -0,0 +1,17 @@
|
||||
[upload] 示例 上传图片请求示例 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://a
|
||||
|
||||
[session_id] 是 用户的自然语言需求/指令文本,作为本次生成 PQ 测试图的输入内容2 / 5 ===== PAGE 3 ===== 参数名 参数类型是否必填 参数描述 session_id String 是会话标识,用于把多次请求归到同一会话(便于复用/关联上下文)。在同一会话窗口 下请使用同一session_id。使用 uuid 生成唯一字符串 upload_image_urlString 否 上传的参考图片地址,来自上传接口返回的 URL 备注1:相较于上一版本,本版本新增了 uplo ad_ima
|
||||
|
||||
[upload_image_url] === 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":
|
||||
|
||||
[imageUrl] _url 字段。未传入时,默认为“文生图”模 式(与上版本一致);传入时,则启用“图生图”模式。 备注2:在多轮对话的“图生图”模式下,需将上一轮对话返回的 imageUrl 作为第二轮对话的 upload_image _url 传入。 3. 请求及响应示例 单轮对话生图请求示例 { "user_message":"请复刻这张图,生成标准 PQ 测试图 ", "session_id":"48f1a351-67f2-40db-a57d-20d66249bc93",
|
||||
|
||||
[请求示例] 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 ===== 上传图片响应示例 { "
|
||||
|
||||
[响应示例] test\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] -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/a2264f477d4d487493058306701cd
|
||||
|
||||
[message] esktop\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" } }
|
||||
|
||||
[data] nt/ 一、上传图片接口: 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
|
||||
Reference in New Issue
Block a user