Flux官方 异步任务查询API文档

接口地址

GET https://www.dmxapi.cn/flux/v1/get_result?id={TASK_ID}

认证方式

需要在请求头中添加：

Authorization: Bearer sk-******
Content-Type: application/json

Python示例代码

import requests
import json

# API配置
BASE_URL = "https://www.dmxapi.cn"
ENDPOINT = "/flux/v1/get_result"
TASK_ID = "d606be8e-af6a-4c97-8362-b718ae8d8dfa"  # 替换为实际任务ID
API_KEY = "sk-*********************************"  # 替换为你的API密钥

# 构建请求URL
url = f"{BASE_URL}{ENDPOINT}?id={TASK_ID}"

# 设置请求头
headers = {
    "Content-Type": "application/json",
    "Authorization": f"Bearer {API_KEY}"
}

try:
    # 发送GET请求
    response = requests.get(url, headers=headers)
    response.raise_for_status()  # 检查请求是否成功
    
    # 解析JSON响应
    data = response.json()
    
    # 处理结果URL中的转义字符
    if "result" in data and "sample" in data["result"]:
        # json.loads会自动处理转义字符，如\u0026会转为&
        correct_url = data["result"]["sample"]
        print("任务结果URL:", correct_url)
    else:
        print("任务状态:", data.get("status", "未知"))
        
except requests.exceptions.RequestException as e:
    print(f"请求失败: {e}")
except json.JSONDecodeError:
    print("响应不是有效的JSON格式")

响应示例

注意获得的url需要转义才能使用，把 \u0026 替换成 &

{
  "id":"d606be8e-af6a-4c97-8362-b718ae8d8dfa",
  "result":{
    "seed":42,
    "prompt":"ein fantastisches bild",
    "sample":"https://delivery-eu4.bfl.ai/results/b4/7233410d094567/0d094567e8ea49dbb7dbc24485829091/sample.jpeg?se=2025-08-20T16%3A12%3A04Z\u0026sp=r\u0026sv=2024-11-04\u0026sr=b\u0026rsct=image/jpeg\u0026sig=Agm7P7IUt7Rp5JVBm7NLpH7uOmEGwrCRwHx2IN8hgvM%3D",
    "duration":2.429675817489624,
    "end_time":1755705724.0340347,
    "start_time":1755705721.604359
  },
  "status":"Ready"
}

常见状态码

• 200: 请求成功
• 401: 认证失败
• 404: 任务不存在
• 500: 服务器内部错误