查询任务

更新时间

7 天前

接口描述

查询已提交的任务的状态和结果。

请求

TIP

{api_url} 为你实际使用的 API 节点，请根据实际情况填写。例如：

• www.dmxapi.cn
• www.dmxapi.com
• ssvip.dmxapi.com

• 请求方式: GET

• 请求地址: API对应请求接口/{task_id}

• 例如针对 生成图像 API：

  • https://{api_url}/kling/v1/images/generations/{task_id}

请求参数

参数名	类型	必填	说明
task_id	string	是	任务ID

响应参数示例

业务码的含义请参考 业务码。

{
    'code': 0, // 业务码 0 表示成功
    'message': 'SUCCEED', // 消息
    'request_id': 'Cl58rmgHRLsAAAAABFV6lg', // 请求ID
    'data': {
        'task_id': 'Cl58rmgHRLsAAAAABFV6lg', // 任务ID
        'task_status': 'submitted', // 任务状态
        'created_at': 1746696422103, // 创建时间
        'updated_at': 1746696422103 // 更新时间
    }
}

代码示例

深色背景为可以修改的参数，非必选参数已经注释，可以按照自己的需求启用。

import http.client
import json

# 配置全局变量
API_URL = "www.dmxapi.cn" # API 节点
DMX_API_TOKEN = "sk-XXXXXXXXXX" # API 密钥

# 创建HTTP连接对象，用于后续所有API请求
conn = http.client.HTTPSConnection(API_URL)

def query_kling_image_url(task_id):
    """查询已提交的图像生成任务的状态和结果
    
    参数:
        task_id: 图像生成任务的唯一标识符，由kling_generate_image()函数返回
        
    返回值:
        成功时: 返回生成图像的URL地址
        任务未完成或失败: 返回None
    """
    # 根据请求接口，构建完整的查询路径，包含task_id参数
    query_path = f"/kling/v1/images/generations/{task_id}"
    # 构建请求头，包含鉴权消息
    headers = {
    'Authorization': f'Bearer {DMX_API_TOKEN}'
    }
    # 发送GET请求查询任务状态
    conn.request("GET", query_path, None, headers)
    # 获取响应并解析JSON数据
    res = conn.getresponse()
    json_data = json.loads(res.read().decode("utf-8"))
    # print(json_data)
    # 检查任务状态，如果成功则返回第一张图像的URL，否则返回None
    if json_data['data']['task_status'] == "succeed":
        image_urls = [image['url'] for image in json_data['data']['task_result']['images']]
        return image_urls
    else: 
        return None

# 使用示例
if __name__ == "__main__":
    task_id = "Cl58rmgHRLsAAAAABFV6lg"  # 替换为你的实际任务ID
    print(query_kling_image_url(task_id))