Seedream 5.0 Pro Text-to-Image API

bytedance/seedream-v5.0-pro/text-to-image

1K/2K · 8 ratios · JPEG/PNG

Seedream 5.0 Pro Text-to-Image API 可把创意简报转化为结构清晰的海报、信息图、产品视觉和写实场景。通过提示词安排信息层级、构图、光线、材质与多语言图中文字，再从八种画面比例、1K/2K 分辨率及 JPEG/PNG 格式中选择输出。

输入

提示词705/10000

画面比例

分辨率

输出格式

安全检查

体验区会显式发送 enable_safety_checker，默认值为 true。

已就绪

继续使用

Seedream 5.0 Pro Image Edit

示例

Create a rigorous bilingual scientific infographic titled exactly "THE ANATOMY OF LIGHT / 光的构成" on a warm ivory background. Center a clear hand-blown glass prism and show three light paths with thin precise arrows, labeled exactly "KEY LIGHT / 主光", "FILL LIGHT / 补光", and "RIM LIGHT / 轮廓光". At the bottom include a three-step sequence labeled exactly "SHAPE / 塑形", "BALANCE / 平衡", and "POLISH / 精修". Use a clean Swiss editorial grid, accurate optical relationships, restrained cobalt and vermilion accents, realistic glass refraction, generous whitespace, crisp readable typography. Educational editorial design only; no brand, no logo, no product promotion, no advertisement, no watermark, no extra text.

Create a quiet editorial material-study still life, not an advertisement. On a worn oak worktable place exactly one hand-blown clear glass vase, one matte celadon ceramic bowl, and one folded undyed linen cloth. Soft north-window daylight reveals realistic glass thickness, subtle liquid refraction, tiny artisan bubbles, ceramic glaze variation, wood grain, and natural fabric fibers. Three-quarter eye-level composition, calm museum-study atmosphere, restrained neutral palette, physically believable shadows, photographic realism. No people, no brand, no logo, no packaging, no sales styling, no promotional text, no watermark.

Create a vertical bilingual natural-history field-guide page titled exactly "MIGRATION AT NIGHT / 夜间迁徙". Depict three scientifically plausible migratory birds in flight at different altitudes beneath a moonlit sky, with clean fine-line callouts labeled exactly "STAR COMPASS / 星辰罗盘", "MAGNETIC SENSE / 磁场感知", and "REST STOP / 迁徙停歇地". Include a small north arrow, a restrained route map, and a simple altitude scale. Museum field-guide layout, precise information hierarchy, midnight blue and parchment palette, crisp readable Chinese and English typography, natural feather detail, educational purpose only. No event promotion, no brand, no logo, no advertisement, no watermark, no extra text.

REST API

快速开始

完成认证，提交最小文生图任务，再使用 task_id 获取全部生成图片地址。

配置请求认证

创建 API Key，安全保存在服务端，并发送 Authorization: Bearer VIDGO_API_KEY。

接口地址: POSThttps://api.vidgo.ai/api/generate/submit
认证方式: Authorization: Bearer VIDGO_API_KEY

提交一个生成任务

把模型 ID 放在顶层，把提示词和支持的控制项放入 input；响应会立即返回 task_id。

提交请求

curl --request POST \
  --url "https://api.vidgo.ai/api/generate/submit" \
  --header "Authorization: Bearer $VIDGO_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
  "model": "seedream-v5.0-pro",
  "input": {
    "prompt": "一张构图简洁、影棚光线受控的产品营销图片。",
    "size": "1:1",
    "resolution": "1K",
    "output_format": "jpeg"
  }
}'

等待并获取结果

状态为 not_started 或 running 时继续轮询；finished 后读取 data.files[].file_url，failed 后停止并处理错误。

查询状态

GET https://api.vidgo.ai/api/generate/status/{task_id}

status 为 not_started 或 running 时每 2–5 秒轮询；finished 或 failed 后停止。成功时读取全部 data.files[].file_url；生产环境也可通过 callback_url 接收终态结果。

not_startedrunningfinishedfailed

提交响应

{
  "code": 200,
  "data": {
    "task_id": "task-unified-...",
    "status": "not_started",
    "created_time": "2026-08-22T10:00:00Z"
  }
}

任务完成响应

{
  "code": 200,
  "data": {
    "task_id": "task-unified-...",
    "status": "finished",
    "files": [
      {
        "file_url": "https://storage.vidgo.ai/generated/image.jpg",
        "file_type": "image"
      }
    ],
    "progress": 100,
    "error_message": null
  }
}

完整可运行示例

展开后查看提交、轮询、终态判断、错误处理和全部文件地址读取。

完整可运行示例

set -euo pipefail
: "${VIDGO_API_KEY:?Set VIDGO_API_KEY in your environment}"

REQUEST_BODY=$(cat <<'JSON'
{
  "model": "seedream-v5.0-pro",
  "input": {
    "prompt": "一张构图简洁、影棚光线受控的产品营销图片。",
    "size": "1:1",
    "resolution": "1K",
    "output_format": "jpeg"
  }
}
JSON
)

SUBMIT_RESPONSE=$(curl --silent --show-error --fail-with-body \
  --request POST \
  --url "https://api.vidgo.ai/api/generate/submit" \
  --header "Authorization: Bearer $VIDGO_API_KEY" \
  --header "Content-Type: application/json" \
  --data "$REQUEST_BODY")

TASK_ID=$(printf '%s' "$SUBMIT_RESPONSE" | jq -r '.data.task_id // .task_id // empty')
if [ -z "$TASK_ID" ]; then
  printf 'Submit response did not include task_id:
%s
' "$SUBMIT_RESPONSE" >&2
  exit 1
fi

while true; do
  STATUS_RESPONSE=$(curl --silent --show-error --fail-with-body \
    --url "https://api.vidgo.ai/api/generate/status/$TASK_ID" \
    --header "Authorization: Bearer $VIDGO_API_KEY")
  STATUS=$(printf '%s' "$STATUS_RESPONSE" | jq -r '.data.status // .status // empty')

  case "$STATUS" in
    finished)
      printf '%s' "$STATUS_RESPONSE" | jq -r '(.data.files // .files // [])[]?.file_url'
      break
      ;;
    failed)
      printf '%s' "$STATUS_RESPONSE" | jq -r '.data.error_message // .error_message // "Generation failed"' >&2
      exit 1
      ;;
    not_started|running)
      sleep 2
      ;;
    *)
      printf 'Unexpected task status: %s
' "$STATUS" >&2
      exit 1
      ;;
  esac
done

请求参数

input 对象支持以下图片生成参数。

字段	类型	必填	默认值	说明
input.prompt	string	是	—	去除首尾空白后必须非空，最多 10,000 个字符。
input.size	string	否	1:1	可选 1:1、4:3、3:4、16:9、9:16、2:3、3:2 或 21:9。
input.resolution	string	否	1K	可选 1K 或 2K。
input.output_format	string	否	jpeg	可选 jpeg 或 png。
input.enable_safety_checker	boolean	否	—（体验区：true）	体验区默认发送 true。

响应字段

提交响应返回任务标识；状态响应会补充进度、文件或错误信息。

字段	类型	说明
code	integer	应用层结果码，成功响应使用 0 或 200。
message	string	存在时返回便于阅读的信息。
data.task_id	string	用于状态查询接口的任务标识。
data.status	string	not_started、running、finished 或 failed。
data.created_time	string	任务创建时间。
data.progress	integer	存在时表示完成百分比。
data.files[]	array	任务成功后返回的全部文件。
data.files[].file_url	string	生成图片的公开地址。
data.files[].file_type	string	Seedream 5.0 Pro Text-to-Image API 的媒体类型预期为 image。
data.files[].watermark_url	string \| null	存在时返回水印文件地址。
data.error_message	string \| null	status 为 failed 时的失败详情。

任务生命周期

仅在非终态继续轮询；finished 与 failed 都会结束任务生命周期。

not_started
任务已接受，等待开始；继续轮询。
running
正在生成；继续轮询。
finished
成功终态；读取全部 data.files[].file_url。
failed
失败终态；读取 data.error_message 并停止。

轮询与错误处理

认证失败401 表示 Bearer API Key 缺失或无效。
参数校验400 会指出错误模型、提示词、枚举值或提示词长度。
网络失败提交或状态请求可能在任务状态变化前失败，应保留输入并明确重试。
轮询间隔初始使用 2–5 秒；遇到 429 或 5xx 时逐步退避。
终态处理仅在 not_started 或 running 时继续；finished 或 failed 立即停止。
回调方式在顶层添加 callback_url，可通过 POST 接收扁平的终态任务对象。

模型规格

规格	取值	说明
输入模式	文本提示词	prompt 用于定义主体、构图和视觉处理。
输出	图片	异步任务可返回一张或多张图片文件。
分辨率	1K / 2K	后端默认值为 1K。
画面比例	8 种预设	1:1、4:3、3:4、16:9、9:16、2:3、3:2 和 21:9。
文件格式	JPEG / PNG	省略 output_format 时后端默认使用 JPEG。
前端估算	每次请求 15 积分	当前前端估算器对所有支持的参数组合返回相同数值。

查看 Seedream 5.0 Pro Text-to-Image API 文档

Seedream 5.0 Pro Text-to-Image API

Seedream 5.0 Pro Text-to-Image API 接受最多 10,000 个字符的提示词，并返回异步图片任务。输出可选择八种画面比例、1K 或 2K 分辨率，以及 JPEG 或 PNG 格式。

为什么选择 Seedream 5.0 Pro Text-to-Image API？

规划信息密集的版面。把时间线、分区、标签、图表和辅助图像组织成清楚的阅读层级。
用一条提示词统筹画面。同时描述主体、机位、构图、色彩、光线、材质和整体氛围。
把多语言文案融入设计。提供准确文字，并说明它在画面中的位置、大小和排版作用。
写明可观察的表面与光线细节。在提示词中描述产品表面、皮肤质感、玻璃、织物、反射与光线。
选择明确的输出规格。可选择八种画面比例、1K/2K 和 JPEG/PNG；前端当前按每次请求 15 积分估算。

参数说明

参数	要求	说明
prompt	必填	用最多 10,000 个字符描述主体、信息层级、构图、视觉风格和需要呈现的准确文字。
size	可选	根据发布版位选择输出画面比例。默认值`1:14:33:416:99:162:33:221:9`
resolution	可选	选择输出分辨率档位。默认值`1K2K`
output_format	可选	选择生成文件的格式。默认值`jpegpng`
enable_safety_checker	可选	设置本次请求的内容安全检查开关。 `truefalse`

使用方法

明确交付目标先写清受众、版位、主体、核心信息和希望得到的视觉结果。
安排版面层级按阅读顺序描述标题、视觉主体、辅助信息、位置、机位、光线和色彩。
写明图中文字把准确文案放在引号中，并注明语言、位置、大小和强调关系。
选择输出规格根据版位选择画面比例，再确定 1K/2K 和 JPEG/PNG。
提交并检查结果运行请求并读取全部图片，重点检查信息层级、文字、材质和小尺寸细节。

计费

前端当前按每次请求 15 积分估算。按每积分 $0.005 计算，所有支持的比例、分辨率和输出格式预估均为 $0.075。

计费项目	费率	详情
前端请求估算	每次 15 积分	1K/2K、八种比例、JPEG 与 PNG 的前端估算值相同。

适用场景

产品营销视觉将产品简报、摆放要求和布光方向转化为发布素材。
带准确文案的海报引用标题和辅助文字，并说明层级与位置，生成完整海报构图。
信息图与知识图解把结构化概念整理成分区清楚、标签明确、重点突出的信息图片。
多语言社交素材结合本地化文案与平台比例，制作不同市场的图片概念。

实用技巧

按主体与环境、构图、机位、光线、色彩和细节的顺序编写提示词。
把必须出现的画面文字放在引号中，并明确说明位置。
画面包含多个信息区块时，直接写出视觉层级。
先选择发布比例，再描述边缘位置与留白。
删除与主要主体相互竞争或彼此矛盾的次要要求。

注意事项

prompt 最多支持 10,000 个字符，可承载完整创意简报。
size 支持八种画面比例，resolution 支持 1K 和 2K。
output_format 默认使用 jpeg；enable_safety_checker 可作为 boolean 输入项设置。
请求会返回异步任务 ID；任务完成后从 data.files[].file_url 读取图片地址。

Seedream 5.0 Pro 文生图 API 常见问题

什么是 Seedream 5.0 Pro Text-to-Image API？

Seedream 5.0 Pro 是字节跳动 Seed 系列面向设计任务的图片生成模型，可通过 Vidgo REST API 调用。它可根据提示词生成结构化海报、信息图、产品视觉、写实场景和多语言图中文字，并通过异步任务返回图片结果。

如何调用 Seedream 5.0 Pro Text-to-Image API？

使用 Authorization: Bearer VIDGO_API_KEY 向 /api/generate/submit 发送 POST 请求，将 model 设为 seedream-v5.0-pro，并把模型输入放入 input；响应会返回 task_id。

Seedream 5.0 Pro Text-to-Image 如何计费？

前端当前按每次请求 15 积分估算。按每积分 $0.005 计算，所有支持的比例、分辨率和格式预估均为 $0.075。

Seedream 5.0 Pro Text-to-Image 接受哪些输入？

input 支持 prompt、size、resolution、output_format 和可选 enable_safety_checker。可在 prompt 中描述主体、信息层级、构图、视觉风格、光线、材质和准确的图中文字。

如何获取生成的图片？

轮询 GET /api/generate/status/{task_id}，直到 finished 或 failed。成功时读取全部 data.files[].file_url；也可在提交时提供 callback_url 接收终态任务。

应该选择哪个 Seedream 5.0 Pro API 模式？

请求只包含提示词、不包含源图时选择 Text-to-Image；请求包含 1–10 个有序源图 URL 时选择 Image Edit。

Seedream 5.0 Pro Text-to-Image API

继续使用

示例

快速开始

配置请求认证

提交一个生成任务

等待并获取结果

查询状态

请求参数

响应字段

任务生命周期

轮询与错误处理

模型规格

Seedream 5.0 Pro Text-to-Image API

为什么选择 Seedream 5.0 Pro Text-to-Image API？

参数说明

使用方法

计费

适用场景

实用技巧

注意事项

相关模型

Seedream 5.0 Pro 文生图 API 常见问题