如何使用 Seedream 5.0 Flash 文生图 API：文生图接入指南（2026）
Seedream 5.0 Flash 文生图 API 接入教程：参数说明、价格与可直接运行的调用代码，先在 Playground 试玩再一行代码接入。
Seedream 5.0 Flash 文生图 是一款文生图模型（由 Doubao 提供）：根据提示词生成一张图片。所有支持尺寸均为每张 $0.018，输入参考图免费。在 NamiFusion 上可以在 Playground 直接试玩（提交前显示准确报价），再通过统一 REST API 一行代码接入，每张输出图像约 $0.018。
TL;DR
· 任务类型：文生图，由 Doubao 提供
· 价格：每张输出图像约 $0.018（$1 = 100 积分），按量计费无订阅
· 上手路径：Playground 试玩（提交前显示报价）→ API Keys 建密钥 → 一个 POST 接入
· 可调参数：3 个（见下方参数表）
· 无平台水印，商用可用（遵守服务条款）
用 Seedream 5.0 Flash 文生图 能做什么？
社媒配图与封面：按帖子主题批量出图，统一风格后直接排期发布。
电商与广告素材：产品场景图、Banner 底图、A/B 测试的多版本视觉。
概念设计与灵感探索：角色、场景、风格板，用低成本快速迭代方向。
内容工作流串联：生成结果可直接作为图生视频或换脸的输入素材。
怎么调用这个 API？
- 在 NamiFusion 注册并在 API Keys 页面创建密钥（注册赠送积分仅可用于指定模型）。
- 用下面的 cURL 示例提交任务，Header 带上 Bearer 密钥。
- 用返回的 task_uuid 轮询任务状态，完成后取输出 URL。
# 1) Submit — returns { "task_uuid": "..." }
curl -X POST "https://www.namifusion.com/api/v1/marketplace/run/doubao/seedream-v5.0-flash/text-to-image" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"input": {
"prompt": "A cinematic futuristic city street at dusk after light rain, neon signs in English and Japanese reflecting on wet pavement, a stylish young woman in a transparent umbrella walking past a ramen shop, soft volumetric fog, detailed storefronts, realistic lighting, ultra-detailed, vibrant colors, natural skin tones, sharp focus",
"output_format": "jpeg",
"size": "2048x2048"
}
}'
# 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（提示词）：必填
output_format（输出格式）：可选，默认 "jpeg"
size（尺寸）：可选，默认 "2048x2048"
Seedream 5.0 Flash 文生图 的提示词怎么写？
- 主体在前：先写画面主角与动作，再补环境、光线、风格（"一名宇航员在雨中的霓虹街头奔跑，电影感，浅景深"）。
- 用具体名词代替形容词堆砌："85mm 人像镜头、黄昏逆光" 比 "非常好看、超高质量" 有效得多。
- 迭代时只改一个变量：固定 seed 复现结果，每次只调整一个描述词，才能知道是什么在起作用。
- 负面信息放正面写：与其说"不要模糊"，不如直接要"锐利对焦、清晰细节"。
价格是多少？
按输出图像数量计费，每张输出图像约 $0.018（$1 = 100 积分）。总费用取决于实际输出张数，Playground 里提交前会显示预扣报价。
Seedream 5.0 Flash 文生图
doubao/seedream-v5.0-flash/text-to-image
根据提示词生成一张图片。所有支持尺寸均为每张 $0.018，输入参考图免费。
价格
与 BytePlus 官方原价一致：每张输出图片 $0.018 = 1.8 积分。输入图片免费，所有支持的尺寸均为同一单价。1 美元 = 100 积分；账户折扣另行计算。
每次请求生成一张图片，折扣前费用为 1.8 积分（$0.018）；参考图张数不产生附加费。失败任务退费。
参数
| 参数 | 必填 | 默认值 / 限制 |
|---|---|---|
prompt | 是 | 5000 字符 |
output_format | 否 | jpeg; jpeg, png |
size | 否 | 2048x2048 |
用 size 指定尺寸。文生图和图片编辑支持 宽x高 像素值：总像素 921,600～4,624,220，宽高比 1:16～16:1，两项必须同时满足。例如 1024x1024、1536x1536、2048x2048、2048x1024。512x512 和 4K 不在支持范围内。当前 MaaS 参数为 size，不应另传 resolution 或 aspect_ratio。
调用示例
curl -X POST 'https://www.namifusion.com/api/v1/marketplace/run/doubao/seedream-v5.0-flash/text-to-image' \
-H "Authorization: Bearer $API_KEY" \
-H 'Content-Type: application/json' \
-d '{
"input": {
"prompt": "A cinematic futuristic city street at dusk after light rain, neon signs in English and Japanese reflecting on wet pavement, a stylish young woman in a transparent umbrella walking past a ramen shop, soft volumetric fog, detailed storefronts, realistic lighting, ultra-detailed, vibrant colors, natural skin tones, sharp focus",
"output_format": "jpeg",
"size": "2048x2048"
}
}'
curl 'https://www.namifusion.com/api/v1/marketplace/run/tasks/TASK_UUID' \
-H "Authorization: Bearer $API_KEY"
常见问题
可以先免费试用吗？+
注册赠送积分仅可用于指定模型，适用范围会持续更新；Playground 提交前会显示准确报价。
生成内容可以商用吗？有水印吗？+
可以商用，NamiFusion 不给生成结果加平台水印；使用须遵守服务条款与适用法律。
内容政策是什么？+
色情内容、涉及未成年人的性化内容、未经授权使用真人、欺骗性冒充、诈骗与虚假代言均禁止。合法、自愿且非露骨的成年人主题可能被允许，详见服务条款。
Seedream 5.0 Flash 文生图 的任务要跑多久？+
取决于参数，图像通常数秒到数十秒，视频通常数十秒到几分钟；API 返回 task_uuid 供轮询。
分辨率/时长上限是多少？+
以模型参数表为准：每个模型的可选分辨率、时长档位都在上方参数说明与 Playground 中列出。