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 http.client
import json
import os
import time

# 配置API密钥(建议使用环境变量管理)
API_KEY = "sk-**********************************"
API_HOST = "www.dmxapi.cn"
ENDPOINT = "/v1/images/generations"

# 请求参数配置
params = {
    "prompt": "漫画风格的学习英文单词图：Hello",
    "model": "flux-kontext-pro",
    "size": "16x9",  # 支持比例和大小写法  例如： 3x2  或 
    "n": 1, # 生成数量，但改了会报错
    "seed": -1 #每次变随机种子
}

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

try:
    # 建立HTTPS连接
    conn = http.client.HTTPSConnection(API_HOST)
    conn.request("POST", ENDPOINT, json.dumps(params), headers)
    
    # 处理响应
    res = conn.getresponse()
    if res.status == 200:
        data = json.loads(res.read())
        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(f"请求失败: {res.status} {res.reason}")
        
except Exception as e:
    print(f"发生错误: {str(e)}")
finally:
    conn.close()

参考

http://imagemodels.dmxapi.com/