概述
Seedream 是字節跳動 BytePlus 火山方舟海外版的旗艦影像生成模型系列,統一生成-編輯架構:文生圖、單圖編輯、多圖融合、批次序列生成都通過同一個/v1/images/generations 端點完成,僅引數不同。API易 與 BytePlus 達成官方戰略合作,第一時間接入全部活躍版本。
文生圖 API
POST /v1/images/generations,純文本提示詞生成圖片,支援 1K/2K/3K/4K 與精確畫素尺寸。圖片編輯 API
image 引數,支援單圖改圖、多圖融合、批次序列生成(最多 15 張)。歷史版本
讓 AI Agent 幫你接入
複製這段提示詞,貼上給 Codex / Claude Code / Cursor
它會先抓本頁的純文本版(任意文件頁地址後加 .md),再按你專案的技術棧寫程式碼——超時、URL 結果要立即轉存、編輯走 URL 陣列而不是 multipart、以及 seedream-5-0-pro 的禁傳引數這幾個高頻坑已經寫死在要求裡。
幫我在當前專案裡接入 / 排查 Seedream 的「文生圖 + 圖片編輯」。
先讀文件再動手:抓 https://docs.apiyi.com/api-capabilities/seedream-image/overview.md 拿到本頁純文本版;需要更細 …
- 超時:客戶端 timeout 按型號分檔——4.x 系列和
seedream-5-0-flash60 秒起步(flash 帶 1 …
共 7 條接入要求,點下方按鈕複製完整版
這段提示詞替你擋掉了什麼
這段提示詞替你擋掉了什麼
為什麼選 API易 的 Seedream
對標 BytePlus 火山方舟海外版官方通道,針對企業生產場景在 穩定性、成本、接入體驗 三方面做了深度最佳化:官方戰略合作 · 資源穩定
不限併發 · 企業可放量
同價 + 充值最高 8 折
全球零門檻接入
api.apiyi.com,省去為 BytePlus ap-southeast-1 / eu-west-1 配置出海鏈路的麻煩。OpenAI 相容 · 零程式碼改動
/v1/images/generations 與 OpenAI 一致,OpenAI 官方 SDK 把 base_url 指過來即可呼叫,擴充套件引數(image / sequential_image_generation 等)通過 extra_body 透傳。注意 OpenAI 的 n 引數上游不支援(傳入被靜默忽略,仍返回 1 張),多圖輸出請用 sequential_image_generation。專業服務 · 企業陪跑
核心特性
4K 高保真出圖
統一生成-編輯架構
image 與 sequential_image_generation 切換模式。多圖融合 · 最多 10 張參考圖
image 欄位接受 URL 陣列,prompt 中可用「圖1/圖2」明確指代順序,配合 sequential_image_generation: "disabled" 做主體一致性控制。文字渲染突破
批次序列生成(最多 15 張)
sequential_image_generation: "auto" + max_images 一次生成成系列的連續影像,適合分鏡、品牌視覺、產品系列圖。約 15 秒/張 · 速度均衡
靈活尺寸 · 任意比例
1K/2K/3K/4K)或精確畫素,總畫素範圍 [1280×720, 4096×4096],寬高比 [1/16, 16]。OpenAI SDK 直連
base_url=https://api.apiyi.com/v1 即可用 OpenAI 官方 SDK 呼叫,擴充套件引數通過 extra_body 透傳,零程式碼改動遷移。實測效果
文生圖 · 電商主圖(seedream-5-0-flash,僅提示詞:純白背景擺一瓶淺綠色精華液,右上角中文標籤「新品首發」、下方小字「限時 8 折」):17.1 秒出圖,2K 下中文標籤筆畫準確、沒有錯字,瓶身造型與商業布光乾淨。

seedream-5-0-flash,參考圖為俯拍拉麵,提示詞:背景換成深色木桌,在碗的右上方加一張中文價籤「招牌豚骨 38 元」):33.2 秒出圖,價籤文字沒有錯字,拉麵、配料與蒸汽保持原樣,深色木桌把主體壓得更實。

模型定價
按張計費,與 BytePlus 官方同價,疊加充值加贈後實際成本進一步下降。- 按出圖張數計費,與 prompt 長度、是否走多圖融合無關
seedream-5-0-flash為按次固定價 $0.018,與 BytePlus 官方同價,輸入參考圖不收費(實測 1 / 3 / 10 張參考圖均扣 $0.018)seedream-5-0-pro為按次固定價 $0.12(每次輸出 1 張,不支援批次序列)。官方原價按輸出畫素分兩檔(≤2.36M / >2.36M 各一價)並對第 2 張起的輸入參考圖另行收費;API易 簡化為按次統一價,不分檔、已含輸入圖費用。該模型官方無任何折扣,API易 按保供原則定價——計入充值加贈活動與稅務等成本後基本不盈利,價格如有調整會提前公告sequential_image_generation: "auto"模式下按實際生成張數計費(如max_images: 4出 4 張則計 4 次)- 失敗請求(4xx / 內容稽核攔截)不計費
- 官方提供 200 張免費圖片測試額度(首次接入即享)
- 充值加贈政策見 充值加贈活動
技術規格
生成耗時對比
各版本單次請求的實測耗時(2026-07 實測,5.0 Flash 為 2026-09-24 實測,UTC+8;單位為從發起請求到拿到完整響應的牆鍾時間,單次請求有正常波動):端點一覽
關鍵引數詳解
size(輸出尺寸)
支援兩類取值,二選一:
預設檔位(按解析度自動決定寬高比):
- 總畫素範圍:[1280×720, 4096×4096]
- 寬高比範圍:[1/16, 16]
- 預設值:
2048x2048
1920x1080(FullHD)、3840x2160(橫版 4K)、1080x1920(手機桌布)、2560x1440(橫版 2K)
非法示例:5000x5000(超上限)、100x1600(比例超 1/16)
image 與 sequential_image_generation(編輯 / 多圖 / 批次模式開關)
/v1/images/generations 端點同時承擔文生圖與編輯/多圖能力,靠 兩個引數組合 切換模式:
最佳實踐
選對版本
- 大批量出圖 / 海報排版 / 追求速度與成本 →
seedream-5-0-flash-260915($0.018/次、約 15–20 秒、最高約 2K) - 追求最強綜合體驗 →
seedream-5-0-260128(功能最全,但解析度上限 3K) - 要 4K 出圖 + 強文字渲染 →
seedream-4-5-251128(4K + 文字渲染突破) - 要 4K + 價效比 →
seedream-4-0-250828(最便宜的 4K) - 極致畫質 / 複雜指令的專業場景 →
seedream-5-0-pro-260628($0.12/次、約 2 分鐘出圖、僅 1K/2K,常規場景不建議)
尺寸優先選預設
1K/2K/3K/4K 檔位經過官方最佳化,速度和品質更穩定。自定義畫素留給真有比例需求的場景,注意各版本支援的檔位不同。多圖融合時顯式指代
image 陣列時,prompt 裡用「把圖1的人物放進圖2的場景,沿用圖3的色彩風格」明確順序引用,避免模型自行猜測。批次序列控制成本
sequential_image_generation: "auto" + max_images: 4 一次出 4 張,按張計費總價乘 4。先用 max_images: 1 驗證 prompt,再放大批次。輸出格式按場景選
png 與 jpeg,4.5 / 4.0 僅 jpeg。需要無損細節時用 png,體積敏感的場景用 jpeg。注意 5.0-flash 直接出圖的 png 沒有 alpha 通道,透明素材要走分層。超時配置 ≥ 60 秒
seedream-5-0-pro 實測約 2 分鐘出圖,超時建議 ≥ 240 秒。水印按需關閉
watermark: false 關閉水印(預設行為視版本而定,建議顯式傳)。商用素材建議顯式關,避免輸出帶 BytePlus 標識。錯誤碼與重試
- 請求超時 60 秒 起步(批次序列或 4K hd 可能 1 分鐘)
- 對 5xx 與超時做 指數退避重試(建議 2 次)
- 記錄響應頭
x-request-id方便排查
常見問題
5.0 Flash / 5.0 Pro / 5.0 / 4.5 / 4.0 應該選哪個?
5.0 Flash / 5.0 Pro / 5.0 / 4.5 / 4.0 應該選哪個?
為什麼圖片編輯也走 generations 端點?
為什麼圖片編輯也走 generations 端點?
/v1/images/edits 端點。和 OpenAI 的 gpt-image-2 不同:OpenAI 的圖編輯要 multipart/form-data 上傳檔案到 /v1/images/edits,Seedream 則統一用 application/json 把圖片 URL 陣列 傳到 image 欄位。優點:協議統一、引數複用、容易切換模式。詳見 圖片編輯 Playground。image 欄位接受 base64 嗎?
image 欄位接受 base64 嗎?
data:image/<格式>;base64,<base64編碼>,注意 <格式> 小寫(如 data:image/jpeg;base64,...),URL 與 base64 也可以混在同一個數組裡。但請優先傳公網 URL:URL 由 BytePlus 直接從新加坡下載,不經過 API易 閘道;base64 請求體要先整體跨境上傳,20 MB 以上的請求體在跨境鏈路慢時會撞原廠 600 秒請求體超時而失敗,閘道不會替你把 base64 轉成 URL。細節見圖片編輯頁頂部的提示。多圖融合最多幾張?批次序列最多幾張?
多圖融合最多幾張?批次序列最多幾張?
- 多圖融合(
image陣列):4.5 / 5.0-pro / 5.0-flash 官方明確”最多 10 張”(5.0-flash 實測第 11 張返回 400),5.0 / 4.0 同樣支援但官方未單獨說明上限 - 批次序列(
max_images):受全域性約束 輸入參考圖 + 輸出圖 ≤ 15。所以多圖 + 序列同時用時要算總和。注意 5.0-pro 與 5.0-flash 不支援批次序列(傳sequential_image_generation即 400)。
返回的 b64_json 要不要自己加 data:image 字首?
返回的 b64_json 要不要自己加 data:image 字首?
response_format:response_format: "url"(預設)→ 返回data[0].url,直接<img src=...>渲染response_format: "b64_json"→ 返回data[0].b64_json純 base64 字串(不含data:image/...;base64,字首),客戶端需base64.b64decode寫檔案,或瀏覽器渲染時自行拼字首
支援流式出圖嗎?
支援流式出圖嗎?
stream: true 啟用。流式特別適合長 prompt + 高解析度場景,前端可提前渲染部分結果。seedream-5-0-pro 與 seedream-5-0-flash 不支援流式——傳 stream 引數會直接返回 400。速率限制是多少?
速率限制是多少?
生成失敗會扣費嗎?
生成失敗會扣費嗎?
400/403 錯誤並不計費。其它常見 0 計費錯誤:401(令牌無效)、429(限流)。只有請求實際進入模型生成階段(200 + 有效響應)才按張計費。可以用 OpenAI 官方 SDK 直連嗎?
可以用 OpenAI 官方 SDK 直連嗎?
base_url 指向 https://api.apiyi.com/v1,擴充套件引數(image / sequential_image_generation / watermark 等)通過 extra_body 透傳:生成的圖片版權歸誰?
生成的圖片版權歸誰?
支援透明背景嗎?
支援透明背景嗎?
seedream-5-0 / seedream-5-0-pro 支援 png 輸出格式,可在 prompt 中要求”transparent background, alpha channel”得到帶透明的圖。seedream-5-0-flash 直接出圖時即使要求透明背景也不帶 alpha 通道,要透明素材請用 layer_decomposition: true 分層,拿到背景底圖 + 多張透明圖層(按輸出張數計費),見 圖片編輯 · 分層。seedream-4-5 / 4-0 僅 jpeg 輸出,不支援透明背景,需自行後處理摳圖。主動取消生成任務可以嗎?
主動取消生成任務可以嗎?
/v1/images/generations 是同步端點,請求一旦提交會跑到結束。客戶端即使斷開連線,服務端仍會完整執行並照常計費。建議客戶端做好超時控制,不要依賴”斷連不計費”。相關文件
- 文生圖 Playground -
POST /v1/images/generations線上除錯,5 段語言程式碼示例 - 圖片編輯 Playground -
image+sequential_image_generation用法詳解 - 歷史版本與遷移 - 5.0 Flash / 5.0 Pro / 5.0 / 4.5 / 4.0 規格對比、價格差異、遷移建議
- Seedream 4.5 上線公告 - News 文章
- API 使用手冊 - 通用呼叫規範
- 影像生成測試工具 - 線上試玩
- BytePlus 官方文件:
docs.byteplus.com/en/docs/ModelArk/1824121- Seedream 4.0-5.0 tutorial(英文)