如何使用 flux-2-dev/text-to-image API：文生图接入指南（2026）

flux-2-dev/text-to-image 是一款文生图模型（由 Flux 2 Dev 提供）：Black Forest Labs 推出的 FLUX.2 [dev] 提供快速、影棚级质量的文生图生成，具备更强的真实感、更清晰的文字渲染和原生编辑能力，便于快速迭代。开箱即用的 REST 推理 API，性能出色，无冷启动，价格实惠。在 NamiFusion 上可以在 Playground 直接试玩（提交前显示准确报价），再通过统一 REST API 一行代码接入，典型一次调用约 $0.012。

TL;DR

· 任务类型：文生图，由 Flux 2 Dev 提供

· 价格：典型一次调用约 $0.012（$1 = 100 积分），按量计费无订阅

· 上手路径：Playground 试玩（提交前显示报价）→ API Keys 建密钥 → 一个 POST 接入

· 可调参数：3 个（见下方参数表）

· 无平台水印，商用可用（遵守服务条款）

用 flux-2-dev/text-to-image 能做什么？

社媒配图与封面：按帖子主题批量出图，统一风格后直接排期发布。

电商与广告素材：产品场景图、Banner 底图、A/B 测试的多版本视觉。

概念设计与灵感探索：角色、场景、风格板，用低成本快速迭代方向。

内容工作流串联：生成结果可直接作为图生视频或换脸的输入素材。

怎么调用这个 API？

1. 在 NamiFusion 注册并在 API Keys 页面创建密钥（注册赠送积分仅可用于指定模型）。
2. 用下面的 cURL 示例提交任务，Header 带上 Bearer 密钥。
3. 用返回的 task_uuid 轮询任务状态，完成后取输出 URL。

# 1) Submit — returns { "task_uuid": "..." }
curl -X POST "https://www.namifusion.com/api/v1/marketplace/run/flux-2-dev/text-to-image" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "input": {
    "prompt": "A cinematic portrait of a young astronaut standing in a neon-lit greenhouse on Mars, ultra-realistic, detailed face, reflective visor helmet tucked under one arm, lush green plants contrasting with red Martian soil outside the glass dome, soft volumetric lighting, sharp focus, high detail, subtle text label on a nearby equipment case reading \"Ares Botany Lab\"",
    "size": "1024*1024",
    "seed": -1
  }
}'

# 2) Poll until status is "completed", then read the output URLs
curl "https://www.namifusion.com/api/v1/marketplace/run/tasks/TASK_UUID" \
  -H "Authorization: Bearer YOUR_API_KEY"

有哪些参数？

prompt（提示词）：必填

size（尺寸）：可选，默认 "1024*1024"

seed（随机种子）：可选

flux-2-dev/text-to-image 的提示词怎么写？

1. 主体在前：先写画面主角与动作，再补环境、光线、风格（"一名宇航员在雨中的霓虹街头奔跑，电影感，浅景深"）。
2. 用具体名词代替形容词堆砌："85mm 人像镜头、黄昏逆光" 比 "非常好看、超高质量" 有效得多。
3. 迭代时只改一个变量：固定 seed 复现结果，每次只调整一个描述词，才能知道是什么在起作用。
4. 负面信息放正面写：与其说"不要模糊"，不如直接要"锐利对焦、清晰细节"。

价格是多少？

按次积分计价，典型一次调用约 $0.012（$1 = 100 积分），实际价格随参数（分辨率/时长等）变化，Playground 里提交前会显示准确报价。