Skip to main content
POST
文生图:根据文本提示词生成图片
右側的互動式 Playground 支援直接線上除錯。請在 Authorization 中填入你的 API Key(格式:Bearer sk-xxx),輸入 prompt、選擇 model / size 後一鍵傳送即可。
場景說明:本頁用於「純文本提示詞生成圖片」——不傳 image 欄位。如需基於參考圖編輯、多圖融合或批次序列生成,請使用 圖片編輯介面(同一端點,多傳 image 引數)。
🖥️ 瀏覽器 Playground 限制(僅 b64_json 模式)預設 response_format: "url" 模式下 Playground 工作正常(響應只是一個 BytePlus TOS 臨時連結)。如果你切換成 response_format: "b64_json",響應會包含數 MB 的 base64 字串,瀏覽器 Playground 可能彈出 請求時發生錯誤: unable to complete request ——實際請求已經成功,只是瀏覽器無法顯示這麼長的 base64。推薦做法
  • 只想看圖:保持預設 url 模式,Playground 會直接返回連結(注意 24 小時內下載到自己的儲存)。
  • 真的需要 b64_json:複製下方”程式碼示例”到本地執行,程式碼會自動解碼並把圖片儲存為本地檔案。
⚠️ 各版本支援的解析度檔位不同
  • seedream-5-0-pro-260628 —— 預設 1K / 2K + 精確 WxH 總畫素 ≤ 4.19M(16:9 最長邊可達 2720×1530,實測可用;無 3K/4K 預設;不支援 sequential_image_generation / stream,傳入即 400;約 2 分鐘出圖)
  • seedream-5-0-260128 —— 僅 2K / 3K(無 4K)
  • seedream-4-5-251128 —— 2K / 4K
  • seedream-4-0-250828 —— 1K / 2K / 4K
不支援的尺寸會直接返回 400。精確畫素總畫素需 ∈ [1280×720, 4096×4096],寬高比 ∈ [1/16, 16]。
圖片 API 全部為同步呼叫:沒有非同步任務 ID,客戶端斷開連線結果即丟失、但請求仍會計費。請為本模型設定足夠大的 timeout,詳見 圖片 API 呼叫須知與最佳實踐

程式碼示例

Python(OpenAI SDK 直連)

Python(原生 requests)

cURL

Node.js(原生 fetch)

瀏覽器 JavaScript

引數說明速查

詳細的引數約束、可選值、示例請檢視右側 Playground 中的欄位說明,所有 enum 欄位均支援下拉選擇。編輯/多圖相關引數(imagesequential_image_generation 等)見 圖片編輯介面

響應格式

⚠️ 響應欄位陷阱
  • response_format=url 模式下,data[].urlBytePlus TOS 臨時簽名 URL,有時效性(通常 24 小時內有效),生產場景建議拿到後立即下載到自己的儲存
  • response_format=b64_json 模式下,data[].b64_json純 base64 字串不含 data:image/...;base64, 字首,客戶端需 base64.b64decode 寫檔案,或瀏覽器渲染時自行拼字首
  • data[].size 欄位反映實際輸出尺寸,可能與請求的 size 略有差異(模型按比例約束)
usage 欄位反映本次實際計費的張數(generated_images)。Seedream 按張計費,output_tokens / total_tokens 僅用於效能觀測,不參與賬單核算。

授權

Authorization
string
header
必填

在 API易控制台获取的 API Key

主體

application/json
model
enum<string>
預設值:seedream-5-0-260128
必填

模型 ID

可用選項:
seedream-5-0-260128,
seedream-5-0-lite-260128,
seedream-4-5-251128,
seedream-4-0-250828,
seedream-5-0-pro-260628
prompt
string
必填

提示词,支持中英文。建议详细描述场景、风格、光线

範例:

"A serene Japanese garden with cherry blossoms, koi pond, traditional bridge, golden hour, ultra detailed"

size
string
預設值:2K

输出尺寸。预设档位(各版本支持不同):

  • 1K(约 1024×1024):仅 4.0
  • 2K(约 2048×2048):5.0 / 4.5 / 4.0
  • 3K(约 3072×3072):仅 5.0
  • 4K(约 4096×4096):4.5 / 4.0

或精确像素 WxH,总像素 ∈ [1280×720, 4096×4096],宽高比 ∈ [1/16, 16]

範例:

"2K"

response_format
enum<string>
預設值:url

返回格式。url 返回临时签名链接(24 小时有效);b64_json 返回纯 base64 字符串(不带 data: 前缀)

可用選項:
url,
b64_json
output_format
enum<string>
預設值:jpeg

输出格式。5.0 支持 png / jpeg;4.5 / 4.0 仅 jpeg

可用選項:
png,
jpeg
seed
integer

随机种子。注意:官方仅 seedream-3-0-t2i 支持,当前 4.x / 5.x 系列传入不生效

範例:

42

watermark
boolean
預設值:false

是否输出带 BytePlus 水印的图片。商用场景建议显式 false

stream
boolean
預設值:false

是否启用流式输出。长 prompt + 高分辨率场景建议开启

回應

成功生成图片

model
string

本次实际调用的模型 ID

範例:

"seedream-5-0-260128"

created
integer

Unix 时间戳

範例:

1768518000

data
object[]

生成结果数组(文生图通常 1 个元素)

usage
object

本次调用计费张数与 token 用量