Flux官方 异步API 任务提交接口文档

概念说明

Flux API 是 DMXAPI 提供的异步图像生成服务，提交任务后会返回任务ID，需要通过轮询获取最终结果。

接口地址

POST https://www.dmxapi.cn/flux/v1/{model_name}

路径参数

参数	说明
model_name	模型名称：flux-kontext-pro 或 flux-kontext-max

请求头

参数	说明
Content-Type	application/json
Authorization	Bearer

请求参数

{
  "prompt": "English Prompt",  // 必填，生成图像的提示词，必须是英文
  "input_image":"http://dmxapi.cn/img/doc1.png", // 可选，支持 url 和 base64
  "width": 1024,          // 可选，图像宽度(px)
  "height": 768,          // 可选，图像高度(px) 
  "steps": 40,            // 可选，迭代步数(20-50)
  "prompt_upsampling": false, // 可选，是否启用提示词上采样
  "seed": 42,             // 可选，随机种子
  "guidance": 2.5,        // 可选，指导系数(1-5)
  "safety_tolerance": 2,  // 可选，安全容忍度(1-3)
  "interval": 2,          // 可选，采样间隔
  "output_format": "jpeg" // 可选，输出格式(jpeg/png)
}

Python调用示例

import requests
import json

url = "https://www.dmxapi.cn/flux/v1/flux-kontext-pro"
API_KEY = "sk-***************************************"  # 替换为你的 DMXAPI 令牌

# 构造请求体
payload = {
    "prompt": "提示词必须是英文的",  # 必须英文提示词
	"input_image": "https://dmxapi.cn/img/doc1.png",  # 需要修改的图片
	#"input_image_2": "",  # 如果不需要，可以留空或删除
	#"input_image_3": "",
	#"input_image_4": "",	
    "width": 1024,
    "height": 768,
    "output_format": "jpeg"
}

headers = {
    "Content-Type": "application/json",
    "Authorization": f"Bearer {API_KEY}"  # 认证头必须包含
}

# 发送POST请求
response = requests.post(url, headers=headers, json=payload)

# 解析响应
if response.status_code == 200:
    task_info = response.json()
    print(f"任务ID: {task_info['id']}")
    print(f"轮询地址: {task_info['polling_url']}")
else:
    print(f"请求失败: {response.text}")

响应示例

{
  "id": "8ad33299-ccbc-48ba-a5eb-8646ceb39df3",
  "polling_url": "https://www.dmxapi.cn/v1/get_result?id=8ad33299-ccbc-48ba-a5eb-8646ceb39df3"
}

注意事项

1. 此接口仅提交任务，需通过返回的polling_url轮询获取结果
2. 生成时间取决于图像复杂度，通常需要10-60秒
3. 免费账户有每分钟请求限制

Bfl官方文档

https://api.bfl.ml/scalar#tag/tasks/post/v1/flux-kontext-pro