BFL FLUX 官方模型

BFL (Black Forest Labs) 推出的 FLUX 系列图像生成模型，以出色的图像质量和文本渲染能力著称。

在线体验

快速开始

python

from openai import OpenAI

client = OpenAI(
    base_url="https://open.dieyuyun.com/v1",
    api_key="YOUR_API_KEY"
)

response = client.images.generate(
    model="flux-1.1-pro",
    prompt="A neon-lit cyberpunk city street at night, rain reflections on the ground",
    size="1024x1024",
    n=1
)

print(response.data[0].url)

请求端点

项目	值
方法	POST
路径	/v1/images/generations
Base URL	`https://open.dieyuyun.com`
兼容协议	OpenAI Images API

认证

Bearer Token: Authorization: Bearer YOUR_API_KEY

可用模型

模型代码	说明
`flux-1.1-pro`	FLUX 1.1 Pro，高质量专业版（默认）
`flux-pro`	FLUX Pro，高质量版本
`flux-dev`	FLUX Dev，开发版本，速度更快
`flux-schnell`	FLUX Schnell，极速版本，适合快速迭代

标准请求字段

字段	类型	必填	默认值	说明
model	string	是	—	模型标识，如 `flux-1.1-pro`
prompt	string	是	—	图像描述文本
size	string	否	`1024x1024`	图像尺寸
quality	string	否	`standard`	生成质量: `standard`、`hd`
n	integer	否	1	生成数量
response_format	string	否	`url`	返回格式: `url` 或 `b64_json`
async	boolean	否	`false`	启用异步模式，返回 taskId 用于查询结果，详见异步任务

支持的尺寸

尺寸	比例	说明
`1024x1024`	1:1	方形
`1536x1024`	3:2	横版
`1024x1536`	2:3	竖版
`1344x768`	16:9	宽屏
`768x1344`	9:16	竖屏

请求示例

cURLPythonNode.js

bash

curl https://open.dieyuyun.com/v1/images/generations \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "flux-1.1-pro",
    "prompt": "A neon-lit cyberpunk city street at night, rain reflections on the ground",
    "size": "1024x1024",
    "n": 1
  }'

python

from openai import OpenAI

client = OpenAI(
    base_url="https://open.dieyuyun.com/v1",
    api_key="YOUR_API_KEY"
)

response = client.images.generate(
    model="flux-1.1-pro",
    prompt="A neon-lit cyberpunk city street at night, rain reflections on the ground",
    size="1024x1024",
    n=1
)

print(response.data[0].url)

javascript

import OpenAI from 'openai'

const client = new OpenAI({
  baseURL: 'https://open.dieyuyun.com/v1',
  apiKey: 'YOUR_API_KEY',
})

const response = await client.images.generate({
  model: 'flux-1.1-pro',
  prompt: 'A neon-lit cyberpunk city street at night, rain reflections on the ground',
  size: '1024x1024',
  n: 1,
})

console.log(response.data[0].url)

异步模式

在请求中添加 "async": true 即可启用异步模式。异步请求不会直接返回生成结果，而是返回一个 taskId，用于后续查询任务进度和获取结果。

json

{
  "id": "task_abc123",
  "status": "queued",
  "progress": 0
}

字段	类型	说明
id	string	任务 ID，用于查询任务状态
status	string	当前状态: `queued` / `processing`
progress	integer	进度百分比 (0-100)

任务完成后，通过 GET /v1/tasks/{taskId} 获取结果，返回格式与同步响应一致。

详见异步任务了解完整的轮询流程和最佳实践。

响应格式

成功响应

json

{
  "created": 1717000000,
  "data": [
    {
      "url": "https://...",
      "revised_prompt": "..."
    }
  ]
}

字段	类型	说明
created	integer	Unix 时间戳
data	array	生成结果数组
data[].url	string	图像 URL
data[].revised_prompt	string	优化后的提示词

错误响应

详见错误码。

最佳实践

模型选择: 追求最高质量选 flux-1.1-pro，快速迭代选 flux-schnell，平衡选 flux-dev。
文本渲染: FLUX 系列在图像中渲染文字的能力优于大多数模型，适合需要文字元素的场景（海报、标语等）。
提示词风格: FLUX 对自然语言描述响应良好，无需过多关键词堆砌，像描述场景一样自然地写即可。
高分辨率输出: 需要更大尺寸时，选择非方形分辨率如 1536x1024 或 1344x768 可获得更好的宽屏效果。

速率限制

详见速率限制。

BFL FLUX 官方模型 ​

快速开始 ​

请求端点 ​

认证 ​

可用模型 ​

标准请求字段 ​

支持的尺寸 ​

请求示例 ​

异步模式 ​

响应格式 ​

成功响应 ​

错误响应 ​

最佳实践 ​

速率限制 ​

相关文档 ​