如何使用 Seedream V5.0 Pro 文生图 API API：文生图接入指南（2026）

Seedream V5.0 Pro 文生图 API 是一款文生图模型（由 Doubao 提供）：字节跳动推出的 Seedream V5.0 Pro 文生图模型，可根据文本提示词生成高质量图片，支持宽高比选择、强提示词遵循，以及 1K / 2K 输出档位，满足灵活的图片创作需求。开箱即用的 REST 推理 API，性能出色，无冷启动，价格实惠。在 NamiFusion 上可以在 Playground 直接试玩（提交前显示准确报价），再通过统一 REST API 一行代码接入，典型一次调用约 $0.050。

TL;DR

· 任务类型：文生图，由 Doubao 提供

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

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

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

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

用 Seedream V5.0 Pro 文生图 API 能做什么？

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

电商与广告素材：产品场景图、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/doubao/seedream-v5.0-pro/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 lush bioluminescent forest at dusk, soft blue and purple lighting, intricate space suit details, floating particles in the air, ultra-realistic, highly detailed, atmospheric depth, sharp focus",
    "resolution": "2k",
    "aspect_ratio": "4:5",
    "output_format": "png"
  }
}'

# 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（提示词）：必填

resolution（分辨率）：必填，默认 "1k"

aspect_ratio（宽高比）：可选，默认 "1:1"

output_format（输出格式）：可选

Seedream V5.0 Pro 文生图 API 的提示词怎么写？

1. 主体在前：先写画面主角与动作，再补环境、光线、风格（"一名宇航员在雨中的霓虹街头奔跑，电影感，浅景深"）。

2. 用具体名词代替形容词堆砌："85mm 人像镜头、黄昏逆光" 比 "非常好看、超高质量" 有效得多。

3. 迭代时只改一个变量：固定 seed 复现结果，每次只调整一个描述词，才能知道是什么在起作用。

4. 负面信息放正面写：与其说"不要模糊"，不如直接要"锐利对焦、清晰细节"。

价格是多少？

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