接口信息

API Path
/aipaas/lm/v1/asyncResult/query

请求协议
HTTPS

请求方法
GET

请求头部 ：

头部标签	必填	说明	类型	数据字典	限制	头部内容	示例
Content-Type	是	application/json	[string]			application/json	application/json
X-APP-ID	是	控制台-应用管理-创建应用-AppID，公网鉴权，公网调用时必传	[string]
Authorization	是	公网鉴权，公网调用时必传	[string]
Device-Uuid	否	设备管理-设备uuid	[string]

Query参数 ：

参数名	说明	必填	类型	限制	示例
requestId	请求ID，调用异步算法时返回	是	[string]

响应内容 ：

参数名	说明	必填	类型	数据字典	限制	示例
code	返回状态码	是	[int]
message	具体信息	是	[string]

成功示例[Mock API] ：

返回结果为String类型， 返回字段数据结构与当前请求算法的回告结果一致。

失败示例[Mock API] ：

{
    "code": 992008,
    "message": "获取信息失败"
}

1. 功能简介

用于查询异步算法调用的结果信息，只适用于异步生成结果并且请求接收后返回"requestId"的能力。目前具体支持模型请见下文第6节。
异步请求结果获取目前支持推、拉两种模式：

• 推模式 ：在发送异步请求时需要传递“callback_url”（接收回调结果的url地址，不同接口字段名可能有细微不同）字段，即接收回调结果的url地址。详见 开发指南 - 异步调用结果获取 - 推模式 -【客户提供接口】大模型异步调用结果回告协议规范。
• 拉模式 ：通过发送请求时系统返回的"requestId"字段，主动调用该接口，以实时查询异步调用的结果。

查询大模型生成结果信息接口仅支持查询已经生成的结果，并且生成结果数据在有效期内。
结果未生成或生成结果数据已过期时，接口会返回【992008】获取信息失败；
存在调用结果时，接口返回的信息同各个算法的回告结构。

2. 服务鉴权

服务接口调用时需要严格遵循服务鉴权规则，服务调用鉴权规则请参见：开发指南 - 签名认证方式。

3. 状态码说明

返回编码	返回信息	说明
990003	失败	系统异常
992008	失败	获取信息失败

通用状态码请参考【状态码】中的【网关认证】

4. 请求参数示例

/aipaas/lm/v1/asyncResult/query?requestId=yourRequestId

5. 支持模型

模型编码	模型名称
2202001	图生图13风格异步
2202002	图生图皮克斯风格异步
2202003	图生图二次元风格异步
2202007	文生图异步
2202010	单图口播异步
2202018	三节风图生图
2202034	音频文件转写
2202063	图生图国漫风格异步
2202069	离线语音合成异步
2202093	离线语音识别-话者分离异步

6. 调用示例

6.1 Java版本(Java版本使用JDK1.8 )

import cn.hutool.http.HttpRequest;
import cn.hutool.http.HttpResponse;

import java.util.HashMap;
import java.util.Map;

/** 主类，用于发起HTTP请求并处理响应 */
public class Example {

    public static void main(String[] args) {
        example();
    }

    public static void example() {
        try {
            String url = "服务调用地址";
            String requestId = "yourRequestId";
        
            // 设置请求头 - 根据API文档要求
            Map headers = new HashMap();
            headers.put("Content-Type", "application/json"); // 必需，固定值
            headers.put("X-APP-ID", "yourAppId"); // 必需，从控制台获取
            headers.put("Authorization", "yourAuthorization"); // 必需，公网鉴权
            // headers.put("Device-Uuid", "yourDeviceUuid"); // 可选，设备唯一标识
        
            // 发起HTTP GET请求
            HttpResponse response = HttpRequest.get(url)
                    .headerMap(headers, true) // 添加请求头
                    .form("requestId", requestId) // 添加Query参数
                    .timeout(5000) // 设置超时时间（毫秒）
                    .execute();
        
            // 输出响应结果
            System.out.println("响应状态码: " + response.getStatus());
            System.out.println("响应内容: " + response.body());
        
            // 可以根据需要解析JSON响应
            // JSONObject jsonResponse = JSONUtil.parseObj(response.body());
            // int code = jsonResponse.getInt("code");
            // String message = jsonResponse.getStr("message");
        
        } catch (Exception e) {
            e.printStackTrace();
        }
    }
}

6.2 Python版本

import requests
import json
import logging

# 配置日志
logging.basicConfig(level=logging.INFO, format='%(asctime)s - %(levelname)s - %(message)s')
logger = logging.getLogger(__name__)

def send_get_request_enhanced():
    """
    增强版的GET请求函数
    包含更详细的日志记录和错误处理
    """
    try:
        url = "服务调用地址"
        request_id = "yourRequestId"
    
        headers = {
            "Content-Type": "application/json",
            "X-APP-ID": "yourAppId",
            "Authorization": "yourAuthorization",
            # "Device-Uuid": "yourDeviceUuid"  # 可选
        }
    
        params = {"requestId": request_id}
    
        logger.info(f"准备发送GET请求到: {url}")
        logger.info(f"请求头: {headers}")
        logger.info(f"查询参数: {params}")
    
        # 发送GET请求
        response = requests.get(
            url=url,
            headers=headers,
            params=params,
            timeout=30
        )
    
        logger.info(f"响应状态码: {response.status_code}")
    
        # 处理响应
        if response.status_code == 200:
            try:
                response_data = response.json()
                logger.info("GET请求成功")
            
                # 检查响应中的code字段（如果API返回）
                code = response_data.get("code")
                if code is not None and code != 200:
                    logger.warning(f"API返回非成功状态码: {code}")
                    logger.warning(f"错误信息: {response_data.get('message', '无错误信息')}")
            
                logger.debug(f"完整响应: {json.dumps(response_data, indent=2, ensure_ascii=False)}")
                return response_data
            
            except json.JSONDecodeError:
                logger.error("响应不是有效的JSON格式")
                logger.error(f"原始响应: {response.text}")
                return response.text
        else:
            logger.error(f"GET请求失败，状态码: {response.status_code}")
            logger.error(f"错误响应: {response.text}")
            return None
        
    except requests.exceptions.Timeout:
        logger.error("请求超时，请检查网络连接或增加超时时间")
    except requests.exceptions.ConnectionError:
        logger.error("连接错误，请检查URL是否正确或服务是否可用")
    except requests.exceptions.HTTPError as e:
        logger.error(f"HTTP错误: {e}")
    except Exception as e:
        logger.error(f"未预期的错误: {e}")

# 调用增强版函数
if __name__ == "__main__":
    result = send_get_request_enhanced()
    if result:
        print("请求处理完成")