flux-kontext API 文生图接口文档

简介

Black Forest Labs推出商业级精度的图像生成，满足专业设计需求。

FLUX.1 Kontext模型，突破性的生成式流匹配模型（generative flow matching models），能够同时实现图像生成和编辑功能。支持文本+图像输入的上下文感知生成/编辑模型，控制更精准。

模型列表

flux-kontext-max – 功能最全面、处理能力最强的版本，可能拥有最大的上下文理解能力和生成效果。

flux-kontext-pro – 专为专业人士或高级用户设计的版本，在性能和功能上做了优化和平衡。

flux-kontext-dev – 主要面向开发者，用于测试、集成和早期开发探索的版本，可能在规模或速度上有所侧重。

API接口文档

基础信息

• Base URL: https://www.dmxapi.cn/v1/images/generations
• 请求方式: POST
• 认证方式: Bearer Token

请求参数

参数名	类型	必填	说明
prompt	string	是	图像描述文本
size	string	是	图片大小，参考下文
seed	int	否	随机种子(-1表示随机)

site 参数使用比例

1x1 (正方形)、 2x3 (垂直)、 3v2 (水平)、 3x4 (垂直)、 4x3 (水平)、 9x16 (垂直/竖屏)、 16x9 (水平/宽屏)

文生图代码示例 (Python)

import base64
import os
import time
import requests

# 配置API密钥(建议使用环境变量管理)
API_URL = "https://www.dmxapi.cn/v1/images/generations"  # 完整的API地址
API_KEY = "sk-****************************************"  # 改成你的 DMXAPI 令牌

# 请求参数配置
params = {
    "prompt": "充满科技感的店铺，招牌写着：DMXAPI",
    "model": "flux-kontext-pro",
    "size": "16x9",  # 支持比例和大小写法  例如： 3x2  或
    "n": 1,  # 生成数量，但改了会报错
    "seed": -1,  # 每次变随机种子
}

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

try:
    # 发送POST请求
    response = requests.post(API_URL, headers=headers, json=params, timeout=30)

    # 处理响应
    if response.status_code == 200:
        data = response.json()
        if data.get("data") and data["data"][0].get("b64_json"):
            # 解码并保存图片
            img_data = base64.b64decode(data["data"][0]["b64_json"])
            os.makedirs("output", exist_ok=True)
            filename = f"output/image_{time.strftime('%Y%m%d_%H%M%S')}.png"
            with open(filename, "wb") as f:
                f.write(img_data)
            print(f"图片保存成功: {filename}")
        else:
            print("响应数据格式不正确")
            print(f"完整响应: {data}")
    else:
        print(f"请求失败: {response.status_code} {response.reason}")
        print(f"错误信息: {response.text}")

except requests.exceptions.RequestException as e:
    print(f"网络请求错误: {str(e)}")
except Exception as e:
    print(f"发生其他错误: {str(e)}")

参考

http://imagemodels.dmxapi.com/