> ## Documentation Index
> Fetch the complete documentation index at: https://docs.apiyi.com/llms.txt
> Use this file to discover all available pages before exploring further.

# FLUX 历史版本

> FLUX.1 [pro] / [pro] 1.1 / [pro] 1.1 Ultra / [dev] 历史版本规格、定价与迁移到 FLUX.2 的建议

<Note>
  本页仅记录 APIYI **仍可调用**的 FLUX.1 \[pro] 系列文生图模型。最新一代 FLUX.2 与图编辑专用 FLUX.1 Kontext 见 [FLUX 总览](/api-capabilities/flux/overview)。
</Note>

## 版本一览

| 版本 ID | 发布时间 (UTC+0) | APIYI 单价 | 状态 | 推荐使用场景 |
| - | - | - | - | - |
| `flux-pro-1.1-ultra` | 2024-11 | \$0.0500/次 | 🟡 维护中 | 老项目超高分辨率（4MP） |
| `flux-pro-1.1` | 2024-10 | \$0.0350/次 | 🟡 维护中 | 老项目文生图标杆 |
| `flux-pro` | 2024-08 | \$0.0400/次 | 🟡 维护中 | 初代 pro，老接入兼容 |
| `flux-dev` | 2024-08 | \$0.0200/次 | 🟡 维护中 | 开发/测试，开源权重可本地部署 |

<Tip>
  **新项目建议直接用 FLUX.2**：`flux-2-pro` 与 `flux-pro-1.1` 同档位但画质、多图、长 prompt、4MP 全面提升，价格相近甚至更低。详见下方迁移建议。
</Tip>

## 各版本详细规格

### `flux-pro-1.1-ultra`

* **发布时间**：2024-11（UTC+0）
* **APIYI 单价**：\$0.0500/次（官方 \$0.06，节省 17%）
* **最大输出分辨率**：约 4MP（FLUX.1 系列里最高）
* **核心特性**：超高分辨率、可选 raw 模式（更接近真实摄影质感）
* **已知限制**：单参考图、无 hex 色控、无 grounding search
* **官方介绍**：`docs.bfl.ai/flux_models/flux_1_1_pro_ultra_raw`

### `flux-pro-1.1`

* **发布时间**：2024-10（UTC+0）
* **APIYI 单价**：\$0.0350/次（官方 \$0.04，节省 12.5%）
* **最大输出分辨率**：约 1.6MP（1024×1536 等）
* **核心特性**：在 1.0 基础上提升画质和提示词遵循，行业标杆
* **已知限制**：单参考图、prompt 短（无 32K）
* **官方介绍**：`docs.bfl.ai/flux_models/flux_1_1_pro`

### `flux-pro`

* **发布时间**：2024-08（UTC+0）
* **APIYI 单价**：\$0.0400/次（官方 \$0.04，同价）
* **最大输出分辨率**：约 1.6MP
* **核心特性**：BFL 第一代商用 pro，文生图基础款
* **已知限制**：画质和遵循度低于 1.1，新项目无理由继续使用

### `flux-dev`

* **APIYI 单价**：\$0.0200/次
* **最大输出分辨率**：约 1MP
* **核心特性**：开源权重版（FLUX.1 \[dev]，非商用 license），可本地部署
* **已知限制**：质量低于 \[pro] 系列，主要用于研究、原型、本地推理验证
* **官方权重**：`huggingface.co/black-forest-labs/FLUX.1-dev`

## 迁移建议

<Steps>
  <Step title="评估差异">
    FLUX.2 全面替代 FLUX.1 \[pro]：4MP 输出（vs 1.6MP）、最多 8 张多参考图（vs 1 张）、32K tokens prompt（vs 短）、原生 hex 色控、文字渲染特化。价格在 1MP 内同档位下基本持平甚至更低。
  </Step>

  <Step title="并行对照">
    拿同一批 prompt 在 `flux-pro-1.1` 与 `flux-2-pro` 各跑一轮，重点对比：文字清晰度、多对象一致性、品牌色还原。多数场景 FLUX.2 \[pro] 全面胜出。
  </Step>

  <Step title="渐进切换">
    业务流量先 10% 切到 `flux-2-pro`，观察质量与成本一周后逐步全量。低分辨率（1MP 内）单价基本持平、4MP 场景 FLUX.2 显著更便宜。
  </Step>

  <Step title="处理参数差异">
    多数参数兼容，但需注意：

    * FLUX.1 \[pro] 系列单参考图，FLUX.2 支持多参考图（JSON 字段 `input_image` \~ `input_image_8`，最多 8 张）
    * FLUX.1 不支持 `prompt_upsampling`，FLUX.2 \[pro/max/flex] 支持
    * 老版的部分自定义比例标识（如 `aspect_ratio`）在 FLUX.2 中改用 `width`/`height` 或 `size` 字符串
  </Step>
</Steps>

## 旧版调用示例

```python theme={null}
{/* 调用任意历史版本，仅 model 字段不同，其余参数与 OpenAI Images API 兼容 */}
from openai import OpenAI
import requests

client = OpenAI(api_key="sk-your-api-key", base_url="https://api.apiyi.com/v1")

resp = client.images.generate(
    model="flux-pro-1.1-ultra",
    prompt="A serene mountain landscape at golden hour, raw photo style",
    size="2048x1536"
)

# data[0].url 仅 10 分钟有效
url = resp.data[0].url
with open("legacy.jpg", "wb") as f:
    f.write(requests.get(url, timeout=30).content)
```

## 计费差异

按典型用量估算（每张固定单价）：

| 版本 | APIYI 单价 | 100 张 | 1,000 张 | 10,000 张 |
| - | - | - | - | - |
| `flux-pro-1.1-ultra` | \$0.05 | \$5.00 | \$50.00 | \$500.00 |
| `flux-pro-1.1` | \$0.035 | \$3.50 | \$35.00 | \$350.00 |
| `flux-pro` | \$0.04 | \$4.00 | \$40.00 | \$400.00 |
| `flux-dev` | \$0.02 | \$2.00 | \$20.00 | \$200.00 |
| **`flux-2-pro`（新版）** | **\$0.03** | **\$3.00** | **\$30.00** | **\$300.00** |
| **`flux-2-max`（新版）** | **\$0.07** | **\$7.00** | **\$70.00** | **\$700.00** |

<Info>
  **如何选**：新项目优先 FLUX.2（`flux-2-pro` 综合最优，`flux-2-max` 旗舰）。仅当老项目对接已固化、不便回归测试时，再继续维持 FLUX.1 \[pro] 系列调用。`flux-dev` 可继续作为开发环境的低成本占位选项。
</Info>

## 相关文档

* [FLUX 总览](/api-capabilities/flux/overview) - 全模型矩阵与选型
* [文生图 Playground](/api-capabilities/flux/text-to-image) - FLUX.2 + FLUX.1 通用调试
* [图片编辑 Playground](/api-capabilities/flux/image-edit) - 多图融合 + 编辑


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.