用於圖像生成的 Seedream 5 Pro API

透過獨立的 GoEnhance 開放 API 存取 Seedream 5.0 Pro。發送文字提示詞或新增最多 10 張參考圖片,接收一個 img_uuid,然後進行輪詢或使用 HTTPS 回呼來取得單張生成的圖片。
建立 API 金鑰
電影創意工作室中的半透明玻璃雕塑

選擇 Seedream 5 Pro 請求模式

展示提示詞驅動圖像生成的原始沙漠天文台
在工匠工作室中由紡織品和礦物參考引導的陶瓷器皿
在提交前驗證請求,並將結果追蹤為非同步圖像任務。

Seedream 5 Pro API 功能與限制

提示詞驗證

<code>prompt</code> 為必填項,接受 1–2,000 個字元。

八種長寬比

將 <code>ratio</code> 設定為 <code>1:1</code>、<code>4:3</code>、<code>3:4</code>、<code>16:9</code>、<code>9:16</code>、<code>3:2</code>、<code>2:3</code> 或 <code>21:9</code>。若省略,模型將根據提示詞自動選擇。

1K 或 2K 輸出

將 <code>image_size</code> 設定為 <code>1K</code> 或 <code>2K</code>。文件預設值為 <code>2K</code>。

最多 10 個參考

在 <code>image_list</code> 中傳入 1–10 個 URL 物件以進行圖像轉圖像引導,或省略該欄位以進行文字轉圖像。

每個任務一張圖像

Seedream 5.0 Pro 回傳單張生成的圖像,且此路由不支援連續分組圖像生成。

輪詢或回呼完成

儲存回傳的 <code>img_uuid</code>,然後輪詢任務詳情或在公開的 HTTPS 回呼 URL 接收狀態變更。
GoEnhance 針對輸出層級進行計費,並為每張參考圖片收取少量費用。

Seedream 5 Pro API 定價

1K:每張圖像 $0.045

1K 輸出成本為 2.25 個代幣,文件記載為每張生成圖像 $0.045。

2K:每張圖像 $0.09

2K 輸出成本為 4.5 個代幣,文件記載為每張生成圖像 $0.09。

參考:每張 $0.003

<code>image_list</code> 中的每個 URL 增加 0.15 個代幣,等同於 $0.003。由於平台條款可能變更,請在進行生產批次處理前查看即時的 GoEnhance 定價。

整合 Seedream 5 Pro API

1. 建立並保護 API 金鑰
1

1. 建立並保護 API 金鑰

/keys 建立金鑰,將其作為 bearer 授權傳送,並避免將其放入瀏覽器程式碼或公開日誌中。
2. 建立請求
2

2. 建立請求

加入必要的提示詞,選擇 1K2K,並可選擇設定支援的長寬比。
3. 僅在需要時加入參考圖片
3

3. 僅在需要時加入參考圖片

包含 image_list 並附上 1–10 個可存取的圖片網址以進行參考引導;若為純文字轉圖片則省略此項。
4. 提交並保存 img_uuid
4

4. 提交並保存 img_uuid

POST 至 https://api.goenhance.ai/api/v1/seedream-5-pro,並將回傳的 img_uuid 與您的內部工作記錄一併儲存。
5. 輪詢或接收回呼
5

5. 輪詢或接收回呼

輪詢 GET https://api.goenhance.ai/api/v1/jobs/detail?img_uuid=..., 或提供 custom_callback_url 以接收 HTTPS 狀態通知。
6. 以冪等方式處理最終結果
6

6. 以冪等方式處理最終結果

檢查 HTTP 狀態碼以及回應中的 code/msg,在重試前修正無效請求,並防止下游重複處理。
在單一圖片管線中串聯提示詞產生、參考圖片、非同步追蹤、儲存與審核。

開發者如何使用 Seedream 5 Pro 進行建構

產品宣傳視覺素材

根據結構化提示詞產生原始產品場景概念,以供審核與宣傳製作使用。

參考引導式藝術指導

使用核准的視覺參考來引導產生新的單張圖片結果,同時保持任務處理的一致性。

在地化創意變體

針對不同市場與格式調整提示詞細節,同時保留共享的請求與審核工作流程。

編輯插圖工作流程

為文章配圖、封面與宣傳概念製作 1K 或 2K 圖片。

概念藝術與預覽視覺化

為早期創意決策產生環境、物件與氛圍研究。

自動化資產佇列

在後端服務中串聯提交、工作持久化、輪詢或回呼、儲存以及人工審核。
定價、請求欄位、參考圖像、輸出行為以及平台關係。

Seedream 5 Pro API 常見問題解答

開始您的 Seedream 5 Pro API 整合